登入開始免費試用
Meta Tech Provider

透過 Coexistence 在 WhatsApp 上運行 Typebot 流程

Typebot 的 WhatsApp 頻道需要存取權杖、WhatsApp Business Account ID 和 Phone number ID,然後提供回呼 URL 和驗證權杖。請從已連接的號碼填寫前三項,將 Typebot 的選填 app secret 留空,並把其回呼 URL 和驗證權杖設為該號碼的 Webhook 目的地。

Pro

Typebot 將 WhatsApp 整合列為 Pro 方案的功能,Free 和 Starter 方案不包括在內。

Optional

只有在憑證中儲存了 app secret,Typebot 才會檢查 Webhook 簽署。

Never

Typebot 的精靈會拒絕到期時間未設為永不到期的存取權杖。

20 msg/s

同時用於 WhatsApp Business 應用程式和 Cloud API 的號碼,吞吐量為固定值。

Typebot 的哪些欄位使用已連接號碼的值?

Typebot 的 WhatsApp 精靈位於機械人的 Share 分頁之下,需要四項資料:app secret、System User Token、WhatsApp Business Account ID 和 Phone number ID。

其中三項直接來自連接。控制台會顯示該號碼的 WABA ID、Phone number ID 和存取權杖;如果由助理代您取得,get_api_credentials 工具會傳回相同的值。請把它們貼到對應的欄位。

app secret 是要留空的一項。Typebot 對傳入流量只用它做一件事:檢查 Meta 為每次傳送加上的 X-Hub-Signature-256 標頭。對於透過 Tech Provider 連接的號碼,Meta 使用提供者的 app secret 簽署,而這個密鑰不會與任何人共用,因此您在該欄位輸入任何值,都會令 Typebot 拒絕每一則真正的訊息。欄位留空時,Typebot 會略過此項檢查並接受傳送的內容。

Typebot 的回呼 URL 和驗證權杖應該放在哪裡?

放進該號碼的 Webhook 目的地,而不是 Meta 應用程式的控制台。

Typebot 的精靈會指示您,把它的 Callback URL 和 Verify Token 貼到您自己 Meta 應用程式的 WhatsApp 設定中。透過 EasyCoexistence 使用 Coexistence 時,不涉及您自己的應用程式:Meta 會把該號碼的事件,傳送到連接上所設定的任何目的地。因此,請從 Typebot 的最後一步複製兩個值,並在控制台或使用 set_webhook_destination 把它們設為目的地。

之後 Meta 會向 Typebot 發送驗證用的 GET 請求,Typebot 以 challenge 回應,從此時起,傳送到該號碼的每一則訊息都會到達機械人。Typebot 的驗證權杖只能使用一次:驗證一成功,它就會從 Typebot 的資料庫中刪除。如果您日後再次設定目的地,請先重新執行精靈,產生新的權杖。

1Typebot wizardToken, WABA id and phone number id; app secret empty
2Callback URL + verify tokenCopied from Typebot's last step
3Webhook destinationSet on the connected number
4Meta verifiesTypebot echoes the challenge, delivery starts

機械人如何處理 24 小時的視窗?

Typebot 回覆的是主動來訊的人,這使幾乎所有訊息都處於客戶服務視窗之內。每當客戶來訊,Meta 就會開啟一個 24 小時視窗,在視窗內可以不使用範本而傳送任何服務訊息類型。因此,只負責回答的機械人是最容易處理的情況。

要留意的是需要等待的流程。Wait 區塊,或客戶沉默超過一天後才恢復的工作階段,會嘗試在視窗之外傳送自由格式訊息,Meta 會以錯誤 131047 拒絕。Typebot 的工作階段過期逾時預設為 4 小時,最多可設定為 48 小時,它決定的是回頭的客戶何時開始新對話,而不是 Meta 是否接受該訊息。

由於採用 Coexistence,團隊仍然可以在 WhatsApp Business 應用程式中看到每一個對話,並可在機械人不應回答時,隨時用手機接手。

常見錯誤

  • 把 Meta 的 app secret 貼到 Typebot。傳送的內容是以 Tech Provider 的密鑰簽署,因此 Typebot 會因簽署無效而拒絕每一則訊息。
  • 重複使用舊的 Typebot 驗證權杖。它在一次驗證成功後就會被刪除,所以再次設定目的地時,需要從精靈取得新的權杖。
  • 分享回呼 URL。在簽署檢查關閉的情況下,只要知道該 URL 就可以送入請求,因此請像密碼一樣妥善保管。
使用 EasyCoexistence 完成這項設定

在 easycoexistence.com 連接號碼,把其存取權杖、WABA ID 和 Phone number ID 複製到 Typebot,並將 Typebot 的回呼 URL 設為 Webhook 目的地。每個號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 1,首 3 天免費。

常見問題

使用 Typebot 需要自己的 Meta 應用程式嗎?

不需要。Typebot 的指南假設您有一個,因為多數人自行連接號碼。透過 Tech Provider 使用 Coexistence 時,存取權杖和 ID 來自連接,Meta 會把 Webhook 傳送到 Typebot。

團隊在手機上仍能看到機械人的訊息嗎?

可以。透過 Cloud API 傳送的訊息,會顯示在同一號碼的 WhatsApp Business 應用程式中,因此團隊成員可以閱讀對話並接手。

Typebot 和 n8n 可以同時接收同一號碼的訊息嗎?

不可以。一個號碼只有一個 Webhook 目的地。如果兩者都需要這些事件,請把目的地指向 n8n,再讓工作流程把原始負載轉發到 Typebot 的回呼 URL。

Typebot 會儲存對話嗎?

Typebot 會保存自己的工作階段和結果資料,在任何頻道上都是如此。EasyCoexistence 從不儲存訊息內容:Meta 直接把訊息傳送到您設定的目的地。

繼續閱讀

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期

Typebot 配合 Coexistence 使用 WhatsApp