Chat App Message Service：如何建立Telegram機器人

業務情境

Chat App Message Service支援通過 Telegram 通道觸達全球使用者。使用 Telegram 通道前，需要先在 Telegram 平台建立一個機器人，擷取 API Token 作為接入憑證。此外，還需要為機器人配置群組和頻道的系統管理權限，以支援群發訊息、社群營運等情境。

方案概覽

建立 Telegram 機器人並完成許可權配置的操作流程如下：

1. 通過 BotFather 建立新機器人。

2. 設定機器人的名稱和使用者名稱。

3. 擷取並儲存 API Token。

4. 完善機器人資料（可選）。

5. 配置群組和頻道的系統管理權限。

BotFather 是 Telegram 官方提供的機器人管理工具，所有機器人的建立和配置操作均通過與 BotFather 對話完成。

步驟一：開啟 BotFather 並建立機器人

使用登入的 Telegram 帳號，在 Telegram 用戶端（手機端、案頭端或 Web 版）中開啟 BotFather。有以下兩種方式：

• 搜尋：在 Telegram 搜尋方塊中輸入 BotFather，選擇帶有官方認證標識的帳號。

• 連結：直接存取 https://t.me/BotFather。

開啟後，單擊 Start 開始對話，然後發送以下命令建立新機器人：/newbot，BotFather 將依次引導完成機器人名稱和使用者名稱的設定。

步驟二：設定機器人名稱

BotFather 首先要求輸入機器人的顯示名稱（Name）。該名稱面向終端使用者展示，支援中文、英文或其他語言。輸入名稱後直接發送即可。例如：

• 客服助手

• My Shop Assistant

• Order Service Bot

步驟三：設定機器人使用者名稱

BotFather 隨後要求設定機器人的使用者名稱（Username）。使用者名稱需滿足以下規則：

• 僅支援英文字母、數字和底線。

• 必須以 bot 結尾。

樣本：my_demo_bot、MyShopHelperBot。

以下使用者名稱不符合規則，無法使用：

如果使用者名稱已被佔用，BotFather 會提示重新輸入。可以嘗試添加數字或底線來調整，例如 my_shop_bot、service_01_bot。

步驟四：擷取並儲存 API Token

機器人建立成功後，BotFather 返回一條包含 API Token 的訊息，格式如下：123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx

API Token 是機器人調用 Telegram Bot API 的核心憑證，也是後續接入 Chat App Message Service時的必填資訊。建議記錄以下內容，後續配置時需要使用：

步驟五：完善機器人資料（可選）

機器人建立完成後，可在 BotFather 中進一步完善機器人資訊。以下設定非必需，但有助於提升使用者體驗：

步驟六：配置機器人許可權

如果需要將機器人加入群組或頻道使用，需要開啟相應的許可權。以下操作均在 BotFather 對話中完成。

驗證機器人

完成建立和許可權配置後，執行以下驗證確認機器人工作正常：

1. 在 Telegram 搜尋方塊中搜尋機器人使用者名稱（例如 my_demo_bot），確認可以搜尋到。

2. 開啟機器人首頁，單擊 Start，確認機器人響應正常。

3. 訪問 https://t.me/<機器人使用者名稱>，確認連結可正常開啟。

4. 將機器人加入測試群組或頻道，確認許可權配置生效。

後續步驟

機器人建立並配置完成後，在中建立 Telegram 類型通道，綁定該機器人的 API Token，即可開始使用 Telegram 通道發送訊息。

常見問題