頻道:Telegram、WhatsApp、VK
把 Telegram、WhatsApp 和 VK 連接到同一個專案,了解各頻道支援的功能及回覆會送往何處。
本頁內容
同一個 GetMyBot 專案可以在 Telegram、WhatsApp 和 VK 回覆。舉例來說,課程時間表的規則可以同時用於三個平台,回覆會送回使用者傳來訊息的頻道。
新增通訊平台時,請檢查按鈕與動作在該平台是否可用。各平台支援的功能不同,下文列出差異和連接方法。
什麼是頻道
頻道是已連接的收發平台,例如一個 Telegram 機器人、一個 WhatsApp Business 號碼或一個 VK 社群。一個 GetMyBot 專案可以有多個頻道。反應可共用:有人從 WhatsApp 傳訊時,機器人使用與 Telegram 相同的反應處理,並把回覆送回 WhatsApp。
按鈕、文字格式和動作並非在所有平台上都可用。編輯器可能隱藏不支援的設定,或轉換成可用形式。上線前,請在每個已連接的頻道檢查訊息。
主要頻道(primary_channel)
每個機器人都有一個主要頻道(primary_channel),代表最初與它關聯的平台。通常是 Telegram,但也可以直接建立沒有 Telegram 的 WhatsApp 或 VK 機器人。主要頻道在建立時決定,並顯示於機器人清單;其他頻道可稍後新增。
各頻道支援的功能
API 的 GET /api/channels/capabilities 提供最新、可由程式讀取的功能表。
Telegram 支援 inline 按鈕、回覆鍵盤、按鈕點擊觸發反應(callback)、表情回應、/start 深層連結、編輯、刪除與轉發訊息、將回覆當作觸發條件、成員事件、權限管理及審核。相片輪播可以在同一則訊息中用按鈕切換。文字格式支援 Plain、HTML 和 Markdown。Telegram 沒有 WhatsApp 的範本、互動清單或 24 小時對話時限。
WhatsApp 透過 WhatsApp Cloud API 連接,支援 inline 按鈕、callback、表情回應、/start 深層連結、訊息範本、互動清單及24 小時對話時限。文字格式支援 Plain 和 Markdown;不支援回覆鍵盤、編輯、刪除、轉發訊息、將回覆當觸發條件、成員事件、權限管理,或在同一則訊息中切換輪播相片。詳見 WhatsApp。
VK 支援訊息及附件、inline 按鈕、回覆鍵盤、callback、表情回應、/start 深層連結、編輯、刪除、轉發訊息、成員事件、封鎖與解除封鎖、核准已提交的封閉社群加入申請,以及付費訂閱 VK Donut 事件。只支援純文字,HTML 和 Markdown 標記會在顯示時移除。VK 沒有 WhatsApp 範本、互動清單、同一則訊息內的相片輪播或 24 小時對話時限。
所有頻道都支援 inline 按鈕、callback、表情回應和 /start 深層連結。支援相片的頻道可使用相片輪播區塊。若所有相片都有適當的檔案 ID,Telegram 可在同一則訊息中切換卡片;WhatsApp、VK,或缺少這些 ID 的 Telegram,會把卡片逐張作為相片訊息傳送。詳見訊息與按鈕。
VK Donut
如果 VK 社群已開通 VK Donut,機器人可以收到以下付費訂閱事件:
| 編輯器中的事件 | 事件代碼 | 可插入的值 |
|---|---|---|
| VK Donut:訂閱建立 | donut_subscription_created | {{event.donut_amount}}、{{event.donut_amount_without_fee}} |
| VK Donut:訂閱續期 | donut_subscription_prolonged | {{event.donut_amount}}、{{event.donut_amount_without_fee}} |
| VK Donut:訂閱到期 | donut_subscription_expired | 無 |
| VK Donut:訂閱取消 | donut_subscription_cancelled | 無 |
{{event.donut_amount}} 是付款金額;{{event.donut_amount_without_fee}} 是扣除 VK 手續費後的金額。到期和取消事件沒有金額,因為訂閱期結束不代表再次付款。
這是關於訂閱者的事件,而非訂閱者傳來的訊息。它不會使私訊對話變為可用、不會解除封鎖、不會更新「最後活動時間」,也不會增加訊息計數。若平台還沒有這位訂閱者的資料,會建立其記錄,以便管理標籤和權限。
「付費會員社群」可這樣設定:
- 對訂閱建立和續期事件建立反應,使用變更標籤新增有效期
ttl_days= 31 的「會員」標籤,再傳送封閉社群連結,請對方提交加入申請。 - 在對方提交申請後,另設核准步驟。「變更權限 → 核准申請」只能核准已提交的申請(
groups.approveRequest)。可把它放在「我已提交申請」按鈕觸發的反應,或下一次續期事件的反應中。 - 對標籤到期(
label_expired)建立反應,執行變更權限 → 移除成員。這樣即使 VK 沒有送來到期事件,會員也會在標籤到期時離開。詳見觸發條件。 - 對訂閱取消和到期事件建立反應,移除「會員」標籤,必要時立即移除成員。
VK 權限動作中的聊天(chat_id)必須填入所連接社群的數字 ID,也就是頻道清單中的 VK 社群 ID。VK 只能管理這個社群的成員。填入別的 ID 時,動作會在傳送到 VK 前被拒絕。若要管理另一個社群,請把它另外連接為頻道。
啟用事件的方法:
- Long Poll:連接頻道及平台每次啟動時都會自動訂閱,現有社群無須額外設定。
- Callback API:在社群設定的「API 使用 → Callback API → 事件類型 → VK Donut」啟用表中的四種事件。
連接頻道
請在專案新增頻道:
- 找到目標專案,按卡片上的新增頻道。
- 選擇 Telegram、WhatsApp 或 VK。
- 輸入憑證:Telegram 權杖、WhatsApp 的 Meta 憑證,或 VK 社群憑證。
- 按驗證,讓平台向通訊服務確認憑證。
- 按連接。
連接 WhatsApp 或 VK 後,頻道會顯示Webhook 網址(🔗 圖示)。要在 Meta 應用程式或 VK 社群設定中填入此網址,機器人才會收到傳入事件。WhatsApp 操作詳見 Webhook 設定。
下一步
頻道憑證
Telegram 使用完整的 BotFather 權杖。VK 需要社群權杖和數字社群 ID;若使用 Callback API,還需要密鑰及確認碼。WhatsApp 需要 Phone Number ID、WhatsApp Business Account ID、具有帳號權限的存取權杖、Webhook Verify Token 和 Meta 應用程式的 App Secret。
連接前請核對憑證。更換密鑰時,也要更新服務提供方的對應設定:Verify Token 用於驗證 Webhook 網址,App Secret 用於驗證傳入事件的簽章,兩者都不能取代 API 存取權杖。
傳入事件與 Webhook 網址
使用 VK Callback API 時,請在社群伺服器設定中登記 MyBot 顯示的網址,並填入相同的密鑰和確認碼。Long Poll 不需要公開網址,也不需要這兩個值。使用 WhatsApp 時,請在 Meta 應用程式登記網址、填入相同的 Verify Token,並訂閱所需的訊息事件。只有傳送訊息所需的憑證,並不足以讓機器人收到訊息。
Instagram 與 Messenger 授權
連接精靈會開啟 Meta 授權。請用有權管理目標 Facebook 粉絲專頁或專業 Instagram 帳號的帳號登入,授予所需權限,再選擇這個專案要使用的帳號。精靈會檢查權限、Webhook 訂閱及投遞就緒狀態;使用頻道前,請先解決未通過的檢查。現有連接也可重新選擇帳號。