透過 Coexistence 在 WhatsApp 上運行 Typebot 流程
Typebot 的 WhatsApp 頻道需要存取權杖、WhatsApp Business Account ID 和 Phone number ID,然後提供回呼 URL 和驗證權杖。請從已連接的號碼填寫前三項,將 Typebot 的選填 app secret 留空,並把其回呼 URL 和驗證權杖設為該號碼的 Webhook 目的地。
Typebot 將 WhatsApp 整合列為 Pro 方案的功能,Free 和 Starter 方案不包括在內。
只有在憑證中儲存了 app secret,Typebot 才會檢查 Webhook 簽署。
Typebot 的精靈會拒絕到期時間未設為永不到期的存取權杖。
同時用於 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 的資料庫中刪除。如果您日後再次設定目的地,請先重新執行精靈,產生新的權杖。
機械人如何處理 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.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,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期