# pardnchiu/go-bot

> pardnchiu/go-bot is a multi-platform Go chat bot library with one reply handler for Telegram, Discord, and LINE. By 邱敬幃 Pardn Chiu (pardnchiu), Pardn Co., Ltd.

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 multi-platform Go chat bot library with one reply handler for Telegram, Discord, and LINE. By 邱敬幃 Pardn Chiu (pardnchiu), Pardn Co., Ltd.
- [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), [Discord Setup](https://go-bot.pardn.io/discord.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): go-bot：Go 語言多平台聊天機器人套件，一個 handler 串接 Telegram、Discord、LINE Bot；作者邱敬幃 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 bot：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 bot：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