專案與頻道
建立專案、連接機器人並查看狀態。了解多頻道、更換權杖、暫停與解除凍結。
本頁內容
專案集中管理一個機器人或服務的設定、反應和資料。頻道則把專案連接到實際的對話平台,例如 Telegram 機器人、網站聊天或其他通訊軟體。一所學校可以用同一個專案,同時服務 Telegram 和網站上的訪客。
先在專案建立專案,再新增頻道。連接 Telegram 時,需要 @BotFather 提供的機器人權杖。你可以在管理介面頂部切換專案。
連接機器人
- 開啟專案,按新增專案。在專案卡片按新增頻道並選擇 Telegram。第一個機器人也可以用首次使用的引導流程連接。
- 貼上 @BotFather 提供的權杖,按驗證。GetMyBot 會顯示找到的
@username,請確認是你的機器人。 - 按連接。權杖會以加密方式儲存,平台隨即開始接收事件。
連接後,Telegram 會與其他頻道一起顯示在專案卡片。卡片列出專案名稱、機器人的 @username、使用者數、啟用的反應數及今天的請求數。請求餘額可到付款或統計查看。
多個機器人
一個帳號可以同時管理多個專案和機器人,數量取決於方案中的「機器人數量上限」。在頁面頂部或專案切換專案後,「反應」、「聊天」和「統計」都會顯示所選專案的資料。
機器人如何接收訊息
連接後,GetMyBot 會自行接收 Telegram 的訊息、按鈕點擊、加入聊天和付款事件。只要權杖有效,無須另行設定接收方式。依伺服器設定,Telegram 可能把事件送到平台網址(webhook),也可能由平台定期向 Telegram 取得事件(long polling)。
啟用與停用
每個機器人都可在「設定」的「機器人狀態」卡片中啟用或停用。停用後不會回應訊息;變更立即生效,無須重新連接。
專案狀態與頻道連線狀態
專案中的專案狀態分為啟用、暫停和凍結,它本身並不代表 Telegram 訊息是否可送達。每個頻道另有自己的標記:在線、無訊號、已設定、已停用或專案未啟用。因此,只有網站聊天頻道的啟用專案,不會因為沒有 Telegram 而顯示為停止。
如果啟用中的專案只有一個啟用的 Telegram 頻道,在線表示處理該機器人的服務程序最近有回報;若沒有近期回報,則顯示無訊號。若啟用了多個 Telegram 頻道,則顯示已設定,因為共用的專案回報不能可靠地歸屬於其中一個頻道。其他平台的啟用頻道顯示已設定,表示已連接,並不保證每則訊息都會送達。
如果你在 @BotFather 中重新產生了 token(Bot Settings → Revoke / New token),請在設定 → 管道 → Telegram 🔑 中更新。新 token 必須屬於同一個機器人(Telegram 內部 ID 相同)——這樣才能保留所有反應、訂閱者與資料。 如果未顯示 Telegram 頻道,請在同一視窗中選擇«更換 Token»。
- 狀態可能延遲更新。 連接或重啟平台後,「在線」可能要到上述時間範圍內才出現。
- 如果啟用的 Telegram 頻道持續數分鐘顯示「無訊號」,請檢查權杖及設定中的「機器人健康狀態」卡片。除非你暫停專案或平台因方案限制將其凍結,專案仍維持啟用。
- 回報由服務程序共用,與哪台伺服器回覆你的請求無關。多個 Telegram 頻道時,它無法證明每個頻道都可用。
機器人離線時會發生什麼事
平台每分鐘檢查一次近期回報。啟用中的機器人若完全沒有近期回報,就會建立一件事故:平台判斷一次原因,然後自行嘗試恢復。
設定中的「機器人健康狀態」卡片會顯示以下四種原因:
- Webhook:Telegram 無法將事件送到平台,平台會重新註冊 webhook。
- 權杖已撤銷:
getMe回傳 401。這類事故不會自動重試;請在 @BotFather 更換權杖,再使用「更換權杖」。 - 沒有服務程序:沒有程序處理事件,平台會重啟機器人。
- 原因不明:Telegram 未回應檢查。
重啟與按「同步」相同:使用 getMe 驗證權杖,並重新註冊 webhook。每次重試之間的等待時間會逐漸增加;事故的重啟記錄會列出時間、結果和錯誤訊息,卡片也會顯示下次重試時間。
若機器人離線超過「機器人健康狀態」卡片設定的門檻(預設 5 分鐘),擁有者會在通知鈴鐺和電子郵件收到「機器人離線」;通知收件人清單中的聊天也會收到機器人訊息。每件事故只通知一次。回報恢復後,會收到包含中斷時長的「機器人恢復在線」。同一卡片保留過去事故的原因與時長。
方案限制導致的凍結
除了啟用或停用,機器人還可能被凍結。這由平台在目前方案不足以涵蓋已連接機器人數量時執行,原因只有兩種:
- 超過機器人上限:改用機器人數量較少的方案。
- 訂閱未續約:付費方案到期後,改按免費方案的上限計算。
凍結的機器人不再接收事件,事件接收會真正停止。資料、反應和訂閱者會完整保留,因此可以解除凍結。
解除凍結:購買足以容納所需機器人數量的方案。付費方案啟用時,平台會自動依由舊到新的順序恢復機器人,直到用完新方案的名額。無法指定優先恢復哪個機器人;若你需要恢復較新的機器人,先移除不需要的連接,再付款。
整個帳號凍結是另一種情況:所有機器人與群發都會暫停,後台會顯示「帳號已凍結」。只有支援團隊能解除。詳見付款與餘額。
個人檔案與同步
在「設定」按同步,可以從 Telegram 更新機器人的名稱,例如在 @BotFather 重新命名之後。機器人使用者的頭像會自動更新。
更換權杖
如果在 @BotFather 重新簽發權杖(Bot Settings → Revoke / New token),請到設定 → 更換權杖更新。新權杖必須屬於同一個機器人,亦即 Telegram 的內部 ID 相同,才能保留反應、訂閱者和資料。
將機器人轉交其他帳號
設定 → 更換擁有者會透過電子郵件邀請另一個 GetMyBot 帳號接手專案。邀請有效 72 小時。對方接受前,專案仍歸你所有,也可以取消轉交;接受後,擁有者改變,你將失去專案存取權。適合把專案交給客戶或同事。
機器人範本
範本是機器人設定及所有反應的快照,可用於其他機器人:
- 在「設定」按建立範本,為目前機器人的快照命名。
- 套用範本會以範本設定取代所選機器人的設定,並把範本中的反應加入現有反應。
這適合為多個專案建立同類型機器人。
從目錄安裝現成方案
現成方案目錄提供安裝精靈。填寫參數、檢查相容性和必要連接,然後確認將建立的資源清單。安裝後完成餘下步驟,並用測試請求走完整個流程。
這個精靈與上方套用機器人快照不同。安裝前檢查會指出缺少的參數或功能;清單上顯示步驟完成,並不表示外部服務已能正常運作。
現成方案的成效指標
選擇評估已安裝方案的時間區間。需要比較時,選擇可用的比較模式,並檢查樣本數和診斷結果。資料不足、無法比較與結果為零是不同情況。
下一步
- 設定、團隊與權限:行為設定、角色、範本和 API 權杖。
- 反應基礎:設定機器人的行為。
- 從 sambot 匯入:移轉現有機器人。
- 付款與餘額:方案和機器人數量上限。