WhatsApp

GetMyBot 透過 WhatsApp Cloud API（Meta Graph API）連接 WhatsApp。連接後，機器人接收來自 WhatsApp 的入站訊息並對其套用你的反應，客服可以在對話中繼續溝通。多頻道概覽見 頻道 頁面。

連接 WhatsApp 頻道

連接需要來自你的 Meta 應用程式（WhatsApp Cloud API）的五項憑證。它們全部 必填：

  • Phone number ID — WhatsApp Business 號碼的識別碼。
  • WABA ID — WhatsApp Business Account 的識別碼。
  • Access token — Meta 應用程式的存取權杖。
  • Verify token — 由你自行設定的任意字串。用於在 Meta 中驗證 Webhook（見下文）。
  • App secret — Meta 應用程式的密鑰。用於校驗入站 Webhook 的 HMAC 簽章（標頭 X-Hub-Signature-256）。

介面中的步驟：

  1. 開啟 機器人 → 「新增頻道」 → WhatsApp。
  2. 填寫以上五個欄位，如需要可填寫頻道名稱（選填）。
  3. 點擊 「驗證」 ——GetMyBot 會透過 Meta 校驗憑證。
  4. 點擊 「連接」。

在 Meta 中設定 Webhook

連接後，頻道會出現一個形如 {位址}/ch/{channelID} 的 Callback URL（介面中為 Webhook 圖示 🔗）。需要將它連同你的 Verify token 一起填入 Meta 應用程式：WhatsApp → Configuration → Webhook。

運作原理：

  1. Meta 向 Callback URL 發送 驗證請求，並將傳入的 verify_token 與你的 Verify token 比對。相符則視為 Webhook 已確認。
  2. 之後 Meta 會向該位址發送事件（入站訊息、投遞狀態、範本審核結果）。
  3. 每個入站請求都帶有 X-Hub-Signature-256 簽章；GetMyBot 使用 App secret 校驗簽章——因此連接時需要這項憑證。

24 小時工作階段視窗

WhatsApp 限制主動發起的溝通：自由訊息 只能在使用者最後一則入站訊息之後的 24 小時 內發送給使用者。使用者每發送一則新的入站訊息，視窗就會重新整理。

超出 24 小時視窗後無法發送自由訊息——再次聯繫使用者（re-engage）的唯一方式是 已核准的訊息範本。因此範本是 WhatsApp 中群發和提醒的關鍵工具。

訊息範本

範本（message template）是與 Meta 事先約定好的訊息，可以在工作階段視窗之外發送。範本管理在 GetMyBot 介面中進行。

在哪裡管理範本

機器人 → 在 WhatsApp 頻道上點擊 「訊息範本」 圖示（📄）→ 對話框 「WhatsApp 頻道範本」。對話框中有以下按鈕：

  • 「建立範本」 — 建構一個新範本。
  • 「同步」 — 從 Meta 拉取範本目錄（更新狀態和清單）。

範本類別

  • MARKETING（行銷） — 活動、公告、群發。
  • UTILITY（服務） — 關於使用者操作的通知（訂單狀態、提醒）。
  • AUTHENTICATION（身分驗證） — 驗證碼。

範本欄位

  • 名稱 — 小寫拉丁字母、數字和 _，最多 512 個字元。
  • 語言 — Meta 語言區域。
  • 類別 — 以上三者之一。

對於 行銷 和 服務 類別，另外還有：

  • 標頭 — 無 / 文字 / 圖片 / 影片 / 文件。媒體標頭需上傳範例檔案。
  • 內文 — 必填，最多 1024 個字元。變數用 {{1}}、{{2}} …… 表示，從 1 到 N 嚴格按順序，不得跳號。
  • 頁尾 — 最多 60 個字元。
  • 按鈕 — 最多 10 個：快速回覆、連結（最多 2）、電話（1）、複製代碼（1）。
  • 每個變數 {{n}} 都需要設定一個 範例值 ——這是 Meta 審核的要求。

對於 身分驗證 類別，內文由 Meta 固定；可設定項為：驗證碼有效期（1–90 分鐘）、安全建議和複製驗證碼按鈕的文字。

審核

點擊 「建立」 按鈕會立即將範本提交給 Meta 審核——沒有單獨的「提交審核」步驟。審核結果非同步返回（透過 Webhook），範本清單自動重新整理。狀態：

  • PENDING（審核中）
  • APPROVED（已核准）
  • REJECTED（已拒絕） — 附帶原因
  • 以及 PAUSED、DISABLED、IN_APPEAL、PENDING_DELETION。

可以編輯處於 APPROVED、REJECTED、PAUSED 狀態的範本。名稱和語言不可變更；已核准範本的類別也會被鎖定。

在反應中使用範本

發送範本是反應的一個動作：

  1. 在反應建構器中開啟 「動作」 → 「新增動作」 → 「發送 WhatsApp 範本」。
  2. 僅當機器人連接了支援範本的 WhatsApp 頻道時，該動作才可用。
  3. 只能選擇 已核准（APPROVED） 的範本。
  4. 填寫參數：內文中變數 {{n}} 的值、文字標頭、透過連結指定的媒體標頭、URL 按鈕參數。參數中可以使用替換變數。

實際的發送頻道由事件所在頻道決定：如果事件來自 WhatsApp，範本就會發往 WhatsApp。

對話與附件

客服可以在 WhatsApp 對話中回覆並發送附件——圖片、影片或文件——但受 24 小時視窗約束（視窗之外無法自由溝通）。來自訂閱者的入站媒體透過代理拉取並在對話中顯示。

計費

GetMyBot 按類別 — marketing / utility / authentication / service — 統計 WhatsApp 對話（conversations）。在目前版本中，這 僅用於可觀測性的記錄（record-only）：不會因對話扣減餘額。

延伸閱讀

  • 頻道 — 多頻道與能力矩陣。
  • 反應基礎 — 如何建構機器人行為。
  • 群發 — 批次發送（在 WhatsApp 中透過已核准的範本）。