本文檔詳解 Telegram bot 與通道的串連流程、API token 配置及 webhook 設定。您將瞭解如何在 Chat App 控制台中實現向使用者主動發送訊息、接收使用者回複,並對多個 Telegram 機器人進行集中化營運與更新。
前提條件
已建立Telegram機器人,操作請參見:如何建立Telegram機器人。
已建立Telegram類型通道,操作請參見:建立及管理 Telegram 通道。
操作步驟
可以參考以下步驟串連公用首頁帳號。
在左側導覽列,選擇通道管理。
單擊需管理的Telegram類型的通道ID。
在通道操作頁面,進入机器人管理頁面,按需選擇创建机器人或连接已有机器人。
輸入 Telegram機器人Token。
單擊连接。
建立機器人
建立機器人需要企業在Telegram 用戶端中進行,機器人建立完成後複製 API Token,在輸入框中粘貼,單擊連線按鍵。
串連已有機器人
將 API Token 粘貼到輸入框中,單擊連線按鍵。串連成功後,您的機器人資訊將在頁面中進行顯示。
一個Telegram類型的通道僅支援串連一個機器人,如需管理多個機器人,請建立多個Telegram類型通道,並在通道中串連機器人。
更新 Token
當機器人的 API Token 泄露或到期時,可以在控制台中更新 Token。
更新 Token 將替換已有 Token,更新過程中可能出現短暫斷連,影響訊息發送。建議在業務低峰期操作。
在 Telegram 用戶端中開啟 BotFather,為目標機器人產生新的 API Token。
在机器人管理頁面,單擊更新Token。
在彈出的對話方塊中,粘貼新的 API Token。
單擊确定。
配置訊息工作台
訊息工作台用於集中查看和系統管理使用者發送給機器人的上行訊息。
在机器人管理頁面,單擊訊息工作台設定。
配置說明:
模式
說明
適用情境
启用消息工作台
所有使用者上行訊息均在訊息工作台中顯示。
需要查看全部上行訊息
关键字触发
僅當使用者訊息命中設定的關鍵字時,該訊息才在工作台中顯示。
需要過濾低價值訊息,聚焦重點內容
刪除機器人
刪除機器人後,將無法再通過此機器人發送訊息。已同步的群組和頻道資訊也會同步刪除,且無法恢複。
在机器人管理頁面,單擊删除。
在彈出的確認對話方塊中,單擊确定。
Webhook 設定
在机器人管理頁面,單擊设置Webhook。
通過 Webhook 可以接收訊息回執通知(例如訊息送達、已讀等狀態回調)。具體配置方法,請參見回執訊息簡介與配置流程。
後續步驟
完成機器人串連後,可以繼續以下操作: