# pardnchiu/go-bot

> pardnchiu/go-bot is a Golang bot library for Telegram, Discord, and LINE bots: one Reply handler, select menus, and modals. By 邱敬幃 Pardn Chiu (pardnchiu).

Maintained by 邱敬幃 Pardn Chiu (pardnchiu), Pardn Co., Ltd, Taiwan · Infrastructure Engineering. Source: https://github.com/pardnchiu/go-bot

Full text in one file: [English](https://go-bot.pardn.io/llms-full.txt) · [中文](https://go-bot.pardn.io/zh/llms-full.txt)

## Overview

- [Home](https://go-bot.pardn.io/index.md): pardnchiu/go-bot is a Golang bot library for Telegram, Discord, and LINE bots: one Reply handler, select menus, and modals. By 邱敬幃 Pardn Chiu (pardnchiu).
- [Getting Started](https://go-bot.pardn.io/getting-started.md): Add go-bot to a Go module and run a minimal Telegram, Discord, or LINE echo bot with New, Reply, Start, and Close.

## Concepts

- [Architecture](https://go-bot.pardn.io/architecture.md): How go-bot keeps Telegram, Discord, and LINE as independent packages under core/ while sharing one reply convention.
- [Bot Lifecycle](https://go-bot.pardn.io/core-concepts.md): New, Start, Close, and Status across go-bot platforms: token validation, transport startup, idempotency, and shutdown order.
- [Reply Handler](https://go-bot.pardn.io/reply-handler.md): How the go-bot Reply handler is called, where a non-empty return is sent, and how handler panics are recovered on each platform.
- [Status Messages](https://go-bot.pardn.io/status-messages.md): SendStatus and FinishStatus in go-bot: one debounced thinking message per chat or channel, with a reaction on the trigger message.
- [Saving Media](https://go-bot.pardn.io/media-save.md): How go-bot Save downloads Telegram files, Discord attachments, and LINE message content to UUID-named files with size caps.

## Telegram

- [Telegram Setup](https://go-bot.pardn.io/telegram.md): Configure the go-bot Telegram bot: New options for HTTP client and poll timeout, Start webhook cleanup, and the Input fields.
- [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md): Send Telegram text with MarkdownV2 or HTML, delete messages, and upload documents, videos, audio, photo albums, and voice in go-bot.
- [Telegram Interactions](https://go-bot.pardn.io/telegram-interactions.md): Telegram ForceReply input, inline keyboard single select, and toggle-button multi select in go-bot, and how callbacks reach Reply.

## Discord

- [Discord Setup](https://go-bot.pardn.io/discord.md): Configure the go-bot Discord bot: gateway intents, the Message Content Intent requirement, Start order, and the Input fields.
- [Discord Messages](https://go-bot.pardn.io/discord-messages.md): Send and delete Discord messages, upload 1 to 10 attachments, and send an OGG audio attachment with go-bot.
- [Discord Interactions](https://go-bot.pardn.io/discord-interactions.md): Discord button-to-modal text input and native string select menus for single and multi select in go-bot.

## LINE

- [LINE Setup](https://go-bot.pardn.io/line.md): Configure the go-bot LINE bot: webhook port and path, public HTTPS requirement, signature checks, and the Input fields.
- [LINE Messages](https://go-bot.pardn.io/line-messages.md): Reply with LINE reply tokens, push text to a user, group, or room, and handle text and media events in go-bot.

## Reference

- [API Reference](https://go-bot.pardn.io/api-reference.md): Package index for go-bot: import paths, constructors, and the lifecycle methods shared by core/telegram, core/discord, and core/line.
- [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md): Every exported type, constant, option, and method in go-bot core/telegram with signatures and error conditions.
- [Discord API](https://go-bot.pardn.io/api-reference-discord.md): Every exported type, option, and method in go-bot core/discord with signatures and error conditions.
- [LINE API](https://go-bot.pardn.io/api-reference-line.md): Every exported type, option, and method in go-bot core/line with signatures and error conditions.
- [Removed APIs](https://go-bot.pardn.io/removed-apis.md): APIs removed from go-bot by version: the v0.5.0 move to core/ import paths and the deleted tts package, with replacements.

## Symbols

Exported symbol -> page that documents it.

- `Bot` (core/discord, core/line, core/telegram): [API Reference](https://go-bot.pardn.io/api-reference.md), [Telegram Setup](https://go-bot.pardn.io/telegram.md)
- `ChannelStatus` (core/discord): [Discord API](https://go-bot.pardn.io/api-reference-discord.md)
- `ChatStatus` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md)
- `FileType` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `Input` (core/discord, core/line, core/telegram): [API Reference](https://go-bot.pardn.io/api-reference.md), [Getting Started](https://go-bot.pardn.io/getting-started.md)
- `MessageOption` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `New` (core/discord, core/line, core/telegram): [API Reference](https://go-bot.pardn.io/api-reference.md), [Getting Started](https://go-bot.pardn.io/getting-started.md)
- `Option` (core/line, core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md)
- `ReplyHandler` (core/discord, core/line, core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Architecture](https://go-bot.pardn.io/architecture.md)
- `SendType` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Status Messages](https://go-bot.pardn.io/status-messages.md)
- `Status` (core/discord, core/line, core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Bot Lifecycle](https://go-bot.pardn.io/core-concepts.md)
- `StatusOption` (core/discord, core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md)
- `TypeAudio` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `TypeDocument` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `TypeHTML` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Status Messages](https://go-bot.pardn.io/status-messages.md)
- `TypeMarkdown` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Status Messages](https://go-bot.pardn.io/status-messages.md)
- `TypeVideo` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `WithHTTPClient` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Setup](https://go-bot.pardn.io/telegram.md)
- `WithPath` (core/line): [LINE API](https://go-bot.pardn.io/api-reference-line.md), [LINE Setup](https://go-bot.pardn.io/line.md)
- `WithPollTimeout` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Setup](https://go-bot.pardn.io/telegram.md)
- `WithSendType` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Telegram Messages](https://go-bot.pardn.io/telegram-messages.md)
- `WithStatusEmoji` (core/discord, core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Status Messages](https://go-bot.pardn.io/status-messages.md)
- `WithStatusSendType` (core/telegram): [Telegram API](https://go-bot.pardn.io/api-reference-telegram.md), [Status Messages](https://go-bot.pardn.io/status-messages.md)

## 中文文件

- [首頁](https://go-bot.pardn.io/zh/index.md): pardnchiu/go-bot：Golang 聊天機器人套件，一個 Reply handler 串接 LINE、Telegram、Discord 機器人，Telegram 與 Discord 另有選單與輸入互動；作者邱敬幃 Pardn Chiu。
- [快速開始](https://go-bot.pardn.io/zh/getting-started.md): 把 go-bot 加進 Go module，用 New、Reply、Start、Close 跑起 Telegram、Discord 或 LINE 回聲 bot。
- [架構](https://go-bot.pardn.io/zh/architecture.md): go-bot 如何在 core/ 下讓 Telegram、Discord、LINE 各自獨立，同時共用同一套回覆慣例。
- [Bot 生命週期](https://go-bot.pardn.io/zh/core-concepts.md): go-bot 各平台的 New、Start、Close、Status：token 驗證、傳輸啟動、冪等與關閉順序。
- [Reply Handler](https://go-bot.pardn.io/zh/reply-handler.md): go-bot 的 Reply handler 何時被呼叫、非空回傳送往何處，以及各平台如何接住 handler panic。
- [狀態訊息](https://go-bot.pardn.io/zh/status-messages.md): go-bot 的 SendStatus 與 FinishStatus：每個 chat／channel 一則節流的思考中訊息，並在觸發訊息加 reaction。
- [媒體落地](https://go-bot.pardn.io/zh/media-save.md): go-bot 的 Save 如何把 Telegram 檔案、Discord 附件與 LINE 訊息內容存成 UUID 檔名並限制大小。
- [Telegram 設定](https://go-bot.pardn.io/zh/telegram.md): 設定 go-bot 的 Telegram bot：HTTP client 與 poll timeout、webhook 清理與 Input 欄位。
- [Telegram 訊息](https://go-bot.pardn.io/zh/telegram-messages.md): 在 go-bot 傳送 MarkdownV2／HTML 文字、刪除訊息，並上傳文件、影片、音訊、相簿與語音到 Telegram。
- [Telegram 互動](https://go-bot.pardn.io/zh/telegram-interactions.md): go-bot 的 Telegram ForceReply 輸入、inline keyboard 單選與多選，及 callback 如何回到 Reply。
- [Discord 設定](https://go-bot.pardn.io/zh/discord.md): 設定 go-bot 的 Discord 機器人：gateway intents、Message Content Intent 與 Input 欄位。
- [Discord 訊息](https://go-bot.pardn.io/zh/discord-messages.md): 用 go-bot 傳送與刪除 Discord 訊息、上傳 1 到 10 個附件，以及送出 OGG 音訊附件。
- [Discord 互動](https://go-bot.pardn.io/zh/discord-interactions.md): go-bot 的 Discord 按鈕開 modal 文字輸入，以及原生 string select menu 單選與多選。
- [LINE 設定](https://go-bot.pardn.io/zh/line.md): 設定 go-bot 的 LINE 機器人：webhook port 與 path、公開 HTTPS 需求、簽章驗證與 Input 欄位。
- [LINE 訊息](https://go-bot.pardn.io/zh/line-messages.md): 在 go-bot 以 reply token 回覆 LINE、push 文字到 user／group／room，並處理文字與媒體事件。
- [API 參考](https://go-bot.pardn.io/zh/api-reference.md): go-bot 套件索引：core/telegram、core/discord、core/line 的 import path、建構子與共通生命週期方法。
- [Telegram API](https://go-bot.pardn.io/zh/api-reference-telegram.md): go-bot core/telegram 全部 exported 型別、常數、option 與方法的簽名和錯誤條件。
- [Discord API](https://go-bot.pardn.io/zh/api-reference-discord.md): go-bot core/discord 全部 exported 型別、option 與方法的簽名和錯誤條件。
- [LINE API](https://go-bot.pardn.io/zh/api-reference-line.md): go-bot core/line 全部 exported 型別、option 與方法的簽名和錯誤條件。
- [已移除 API](https://go-bot.pardn.io/zh/removed-apis.md): go-bot 依版本列出的已移除 API：v0.5.0 改用 core/ import path 與刪除 tts 套件，附替代做法。

## Optional

- [Release Notes](https://go-bot.pardn.io/released/index.md): pardnchiu/go-bot changelog by version