串接對話平台：Telegram

串接 Telegram 對話平台：建立 Telegram Bot 取得 Bot Token，在 MaiAgent 新增對話平台並綁定 Agent 的步驟。

串接前確認

• 已在 MaiAgent 平台上建立好一個「AI 助理」

• 已註冊 Telegram 帳號

開始串接

1. 進入左側選單 「對話平台」，點選右上方 「＋串接對話平台」 按鈕

2. 對話平台選擇 Telegram

3. 填寫對話平台名稱、選擇 Agent

4. 從 BotFather https://t.me/BotFather 取得 Bot Token

a. 點選「BotFather」連結：https://t.me/BotFather

b. 進入 Telegram BotFather 的頻道

c. 點選「OPEN IN WEB」（如果是網頁版）

點選後，BotFather 會要求您點選 start 開始對話：

d. 點選 「/newbot」，依指示輸入 Bot 名稱與用戶名稱，即可取得 Bot Token

5. 回到 MaiAgent 串接對話平台編輯介面，貼上剛取得的 Bot Token

建立表單有三個分頁：基本設定、功能設定、權限設定。基本設定 要填：

欄位	說明
名稱、AI 助理	平台名稱與要串接的 Agent（步驟 3）
Telegram 頻道 › Bot Token	貼上從 BotFather 取得的 Token。欄位下方提示「填寫 Bot Token 後，系統將自動為您設定 Webhook，無需額外設定」，不必像 LINE 一樣回到平台後台貼 Webhook 網址
聊天室設定 › 群組中僅在被 @ 提及時回應	開啟後，Agent 在 Telegram 群組裡只回應被 @ 提及的訊息；關閉則回應群組內所有訊息
啟用輸入中提示	Agent 處理回覆時，在 Telegram 顯示「輸入中」提示
啟用重置命令、重置命令	開啟後可新增一到多個指令文字；使用者傳送這些文字時，會為他另開一段新對話

功能設定（啟用 OCR、使用系統時間回答與時區、使用傳送者名稱回答）與 權限設定 兩個分頁與其他通訊平台相同，見功能設定與對話平台設定總覽。

貼上 Bot Token 後，點選右下角的「串接對話平台」按鈕，即可完成串接設定

6. 確認串接是否成功

您可以至剛設定的 Telegram Bot 進行對話

如果相關對話可在 MaiAgent 的所有對話中查看，就表示已成功串接！