如何建立 Telegram 機器人並加入你的頻道
把機器人設為可以發文的 Telegram 頻道管理員:用 @BotFather 建立機器人、保管好權杖、發一則測試貼文,並在貼文沒有送達時排除問題。
要把機器人加入 Telegram 頻道,就把它設為頻道管理員:開啟頻道資訊,新增管理員,搜尋機器人的使用者名稱,再開啟「發布訊息」(Post messages)權限。如果你需要自己的機器人,先用 @BotFather 建立,並保存它給你的權杖。正式使用前,先發一則測試貼文。
本指南涵蓋機器人、權杖、權限、測試貼文和問題排除,不談如何撰寫機器人程式。Studio 和其他透過你自己的機器人發文的工具,都需要同樣的設定。發布時間和排程貼文失敗的問題,請參考 Telegram 排程指南。
機器人在頻道裡能做什麼
機器人是一種特殊的 Telegram 帳號,不需要電話號碼。誰拿到它的權杖,誰就能讓它發文。
機器人不能當頻道訂閱者,只能當管理員。發文是你授予它的其中一項權限,它發出的貼文會以頻道名稱署名。
本指南的例子是虛構的:一家陶藝工作室經營公開頻道 Harbor Street Pottery,想用機器人發布窯燒時間表。
用 @BotFather 建立機器人
Telegram 的 BotFather 指南說明了以下步驟:
- 在 Telegram 開啟 @BotFather,並確認拼字完全正確。
- 傳送
/newbot。 - 輸入名稱。名稱之後可以修改。
- 輸入使用者名稱:長度 5 到 32 個字元,只能用拉丁字母、數字或底線,並以「bot」結尾。使用者名稱之後無法修改。
- 從回覆中複製權杖。它的格式像
123456789:AAF…。
這家工作室把機器人命名為 Harbor Pottery Poster,使用者名稱是 @harbor_pottery_poster_bot。請選一個團隊成員在管理員清單中一眼就認得出的名稱。
保管好機器人權杖
Telegram 提醒,任何拿到權杖的人都能控制你的機器人。請把它當成密碼看待:
- 存放在密碼管理工具裡。
- 只貼到你要連接的工具中。
- 別讓它出現在螢幕截圖、聊天訊息、工單和共用文件裡。
- 不要為了讓別人發文而分享權杖,改在發布工具中給他們存取權(參考與團隊共用社群帳號)。
如果權杖外洩,請到 @BotFather 撤銷它,在那裡傳送 /mybots 就能開啟機器人的設定。你會拿到新的權杖,舊的權杖則會失效,所以要更新每個用過舊權杖的工具。
在這個例子裡,工作室老闆不小心把權杖貼進共用文件,於是撤銷它,再用新權杖重新連接工具。
把機器人加入頻道並設為管理員
開啟頻道資訊,進入管理員清單,選擇新增管理員,再搜尋機器人的使用者名稱。有些應用程式把管理員放在「管理頻道」(Manage Channel)底下,各應用程式的標籤也不盡相同。
Telegram 接著會詢問要授予哪些管理員權限。只開啟工具需要的權限,然後儲存:
| 權限 | 允許的操作 | 發文機器人需要嗎? |
|---|---|---|
| 發布訊息(Post messages) | 以頻道身分發文,並刪除自己最近發出的貼文 | 需要,必須開啟 |
| 編輯訊息(Edit messages) | 釘選貼文,以及編輯不是機器人發出的貼文 | 工具需要時才開啟 |
| 刪除訊息(Delete messages) | 刪除不是機器人發出的貼文 | 工具需要時才開啟 |
| 變更頻道資訊、邀請使用者、新增管理員(Change channel info, invite users, add admins) | 經營頻道本身 | 不需要 |
Harbor Street Pottery 的機器人只獲得「發布訊息」權限,沒有其他權限。
如果是群組,就改為把機器人加為成員。它會以自己的名稱發文,只有在群組禁止成員傳送訊息時,才需要管理員權限。
發一則測試貼文並檢查
從你連接的工具發一則簡短、清楚標明是測試的貼文,例如「測試:窯燒時間表貼文,請忽略」。訂閱者可能會看到,所以內容要無傷大雅。接著檢查:
- 它出現在正確的頻道,而不是名稱相似的頻道。
- 它以頻道名稱署名(例子中是 Harbor Street Pottery)。
- 如果之後會發連結或照片,它們的顯示效果符合預期。
測試完後刪除這些貼文。在頻道中刪除的貼文,所有訂閱者都不會再看到。
排除機器人無法發文的問題
| 你看到的情況 | 該怎麼做 |
|---|---|
| 機器人無法以訂閱者身分加入 | 把它加為管理員,並給予「發布訊息」權限 |
| 機器人已是管理員,但頻道什麼都沒收到 | 在它的權限中開啟「發布訊息」 |
| 工具拒絕這個權杖 | 重新複製一次;如果已經撤銷,就改用新的權杖 |
| 原本能發文,後來停了 | 檢查權杖、管理員清單和機器人的權限 |
| 貼文發到錯誤的聊天 | 把工具重新連接到正確的頻道 |
如果設定都沒問題,但排程貼文沒有送達,請使用發布失敗檢查清單。
在 Studio 中連結 Telegram 分三個步驟:用 @BotFather 建立機器人,貼上它的權杖(Studio 會檢查權杖並顯示機器人的名稱),然後按下「加入頻道」。Telegram 內建的選擇畫面會把機器人加為可以發布、編輯和刪除訊息的管理員,頻道也會自動出現在 Studio 中。選擇「改用群組」則可以連結群組。如果權杖失效,Studio 會在該帳號上顯示「重新連結」。重新連結會用新權杖再走一次同樣的步驟。Studio 目前還沒推出,但你可以加入候補名單。
