將 Coexistence 號碼用作 Chatwoot 的 WhatsApp Cloud 收件匣
Chatwoot 的 WhatsApp Cloud 收件匣需要三個值:WhatsApp Business Account id、phone number id 和存取權杖。Coexistence 號碼三者俱備。用它們建立收件匣,再把號碼的 Webhook 目的地設為 Chatwoot 的 Webhook URL,並填入相同的驗證權杖,團隊便可在 Chatwoot 和手機上回覆客戶。
WABA id、phone number id 和存取權杖:Chatwoot 手動設定 WhatsApp Cloud 時所需的資料。
Chatwoot 會處理這個 Coexistence 事件,因此從 WhatsApp Business 應用程式發出的回覆會出現在對話中。
Meta 容許商業電話號碼設定自己的 Webhook 回呼 URL,以取代應用程式的預設值。
如何將 Coexistence 號碼連接到 Chatwoot?
分兩個地方,按以下次序進行。
在 Chatwoot 中,新增收件匣,選擇 WhatsApp,然後選用 WhatsApp Cloud 供應商的手動設定。輸入號碼、phone number id、WhatsApp Business Account id 和存取權杖。這些資料都可在 EasyCoexistence 控制台的連接頁面找到,助理也可透過 get_api_credentials 取得。Chatwoot 隨後會為該收件匣顯示一個 Webhook URL 和一個 Webhook 驗證權杖。
在 EasyCoexistence 中,把號碼的 Webhook 目的地設為該 URL,並輸入相同的驗證權杖。Meta 會向 Chatwoot 發出驗證請求,Chatwoot 回應後,之後每則發到該號碼的訊息都會進入收件匣。中間沒有任何環節,也就沒有需要維持運作的工作流程。
從手機發出的回覆會顯示在 Chatwoot 嗎?
會。在 Coexistence 號碼上,於 WhatsApp Business 應用程式輸入的回覆,Meta 會以 smb_message_echoes 事件回報。Chatwoot 的 Webhook 任務會識別這個欄位,並將該訊息記錄為發出的訊息,放進正確的對話。其原始碼直接描述了這個情況:商家同時從 Chatwoot 和應用程式回覆,訊息會同步到 Chatwoot。
這讓分工在實際運作中行得通。負責人可繼續在手機上回覆熟客,團隊則在辦公桌前處理共用收件匣,雙方都看到對方發出的內容,毋須轉寄截圖。
從 Chatwoot 發出的訊息,會透過同一號碼的 Cloud API 送出,所以手機上也會看到。
為何 Chatwoot 收件匣不應填寫應用程式密鑰?
因為這些傳送內容是用您沒有的密鑰簽署的。Meta 以擁有訂閱的應用程式的應用程式密鑰簽署每個 Webhook,而該應用程式就是 EasyCoexistence 應用程式,這個密鑰不會與任何人共用。
根據 Chatwoot 目前的原始碼,只有在手動設定的 WhatsApp Cloud 頻道已儲存應用程式密鑰,或頻道是透過 Chatwoot 自家的 Embedded Signup 建立時,才會檢查 X-Hub-Signature-256 標頭。沒有應用程式密鑰的手動收件匣會接受這些傳送內容;填了任何應用程式密鑰的,則會把每一則都當作未獲授權而拒絕。
此處真正起保護作用的是驗證權杖。請選用一個很長的隨機值,因為 Chatwoot 正是靠它分辨 Meta 的驗證請求和其他人的請求。
Chatwoot 在這個號碼上有哪些做不到的事?
無法同時在第二個地方接收 Webhook。Meta 只會把一個號碼的 Webhook 送到一個目的地,所以 Chatwoot 佔用期間,n8n 工作流程不會收到相同的事件。如果兩者都需要,請把目的地指向您自己搭建的小型轉發服務,由它把每次傳送內容轉發給 Chatwoot 和工作流程。
Coexistence 的限制與其他地方一樣:API 每秒最多發送 20 則訊息,自由格式訊息只能在客戶最後一則訊息後 24 小時內發出,之後一律須使用訊息範本。
WhatsApp Business 應用程式仍須至少每 14 天開啟一次,EasyCoexistence 會為您監察這一點。
常見錯誤
- 在 Chatwoot 收件匣填寫應用程式密鑰。傳送內容是用 EasyCoexistence 應用程式的密鑰簽署的,因此 Chatwoot 會把每一則都當作未獲授權而拒絕。
- 在 EasyCoexistence 使用的驗證權杖與 Chatwoot 顯示的不同。Meta 的驗證會失敗,收件匣永遠收不到任何訊息。
- 選用 Chatwoot 的 Embedded Signup,而非手動設定流程。這會透過 Chatwoot 自己的 Meta 應用程式連接號碼,形成另一個獨立的連接。
在 easycoexistence.com 連接號碼,把憑證複製到 Chatwoot 的 WhatsApp Cloud 收件匣,再把 Webhook 目的地設為 Chatwoot。每個號碼每月 US$ 9 起,隨號碼增加降至 US$ 1,首 3 天免費試用。
常見問題
這適用於自行託管的 Chatwoot 嗎?
適用。Webhook URL 使用您自己的 Chatwoot 網域,而非 app.chatwoot.com,其餘設定步驟相同。
使用 Chatwoot 需要自己的 Meta 應用程式嗎?
不需要。號碼是透過 EasyCoexistence 連接的,由它提供憑證並轉送 Webhook。Chatwoot 的指南只是假設您沒有 Meta 應用程式,才會說明如何建立。
可以把多個號碼接入 Chatwoot 嗎?
可以。每個號碼建立一個 WhatsApp Cloud 收件匣,並把每個號碼的 Webhook 目的地設為各自收件匣的 URL 和驗證權杖。
EasyCoexistence 看得到對話內容嗎?
看不到。Meta 會把 Webhook 直接送到 Chatwoot,EasyCoexistence 從不儲存對話內容。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期