GetMyBot 知識庫

頻道: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 手續費後的金額。到期和取消事件沒有金額,因為訂閱期結束不代表再次付款。

這是關於訂閱者的事件,而非訂閱者傳來的訊息。它不會使私訊對話變為可用、不會解除封鎖、不會更新「最後活動時間」,也不會增加訊息計數。若平台還沒有這位訂閱者的資料,會建立其記錄,以便管理標籤和權限。

「付費會員社群」可這樣設定:

  1. 對訂閱建立和續期事件建立反應,使用變更標籤新增有效期 ttl_days = 31 的「會員」標籤,再傳送封閉社群連結,請對方提交加入申請。
  2. 在對方提交申請後,另設核准步驟。「變更權限 → 核准申請」只能核准已提交的申請(groups.approveRequest)。可把它放在「我已提交申請」按鈕觸發的反應,或下一次續期事件的反應中。
  3. 對標籤到期(label_expired)建立反應,執行變更權限 → 移除成員。這樣即使 VK 沒有送來到期事件,會員也會在標籤到期時離開。詳見觸發條件。
  4. 對訂閱取消和到期事件建立反應,移除「會員」標籤,必要時立即移除成員。

VK 權限動作中的聊天(chat_id)必須填入所連接社群的數字 ID,也就是頻道清單中的 VK 社群 ID。VK 只能管理這個社群的成員。填入別的 ID 時,動作會在傳送到 VK 前被拒絕。若要管理另一個社群,請把它另外連接為頻道。

啟用事件的方法:

  • Long Poll:連接頻道及平台每次啟動時都會自動訂閱,現有社群無須額外設定。
  • Callback API:在社群設定的「API 使用 → Callback API → 事件類型 → VK Donut」啟用表中的四種事件。

連接頻道

請在專案新增頻道:

  1. 找到目標專案,按卡片上的新增頻道。
  2. 選擇 Telegram、WhatsApp 或 VK。
  3. 輸入憑證:Telegram 權杖、WhatsApp 的 Meta 憑證,或 VK 社群憑證。
  4. 按驗證,讓平台向通訊服務確認憑證。
  5. 按連接。

連接 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 訂閱及投遞就緒狀態;使用頻道前,請先解決未通過的檢查。現有連接也可重新選擇帳號。