如何透過 Embedded Signup 與 Coexistence 為 SaaS 加入 WhatsApp
SaaS 可透過 Meta 的 Embedded Signup 與 Coexistence 連接每位客戶現有的號碼,使號碼在 WhatsApp Business 應用程式中繼續運作,從而加入 WhatsApp。使用 easyCoexistence 的 Partner API 時,每位客戶只需一個連接工作階段,即可透過託管頁面完成此流程。Meta 會將該號碼的訊息傳送至你的 webhook_url,而你的後端則以客戶自己的存取權杖,透過 Cloud API 回覆。
同時使用 WhatsApp Business 應用程式與 Cloud API 的號碼,其固定吞吐量。
客戶號碼透過 Coexistence 可連接的最舊 WhatsApp Business 應用程式版本。
Meta 於入職時可共享的聊天記錄回溯期限,必須於 24 小時內完成同步。
用戶發送訊息或致電後,WhatsApp 的客戶服務窗口;每則新訊息都會重設該窗口。
Meta 停用 Embedded Signup v2 與 v3 的日期,相關整合已遷移至 v4。
WhatsApp 整合包含哪些部分?
共五個部分,easyCoexistence 負責第一和最後一個。你的產品負責對話邏輯、收件箱,以及你的模型或客戶員工撰寫的任何內容;Meta 則負責在號碼與你的伺服器之間傳遞訊息:
Coexistence 會為你的客戶帶來什麼改變?
客戶保留其號碼與手機。WhatsApp Business 應用程式在 Cloud API 旁繼續運作,因此員工可以在手機上回覆,而你的產品則透過 API 回覆。員工從應用程式發出的訊息,會以 smb_message_echoes 傳送至你的 Webhook。隨之而來的有三項限制:號碼以固定每秒 20 則訊息的速率發送;只有 API 可以發送範本;若手機閒置約 14 天,Meta 會斷開該號碼的連接。
連接步驟在你的產品中是怎樣的?
一個「連接 WhatsApp」按鈕,從你的後端呼叫 POST /connect-sessions,並傳入 redirect_url、客戶的 ID 作為 external_ref,以及附帶 webhook_verify_token 的 webhook_url,讓 Meta 在號碼連接的第一分鐘起就將其路由至你。客戶在託管頁面確認一份簡短的檢查清單,完成 Meta 的彈出視窗,用 WhatsApp Business 應用程式掃描二維碼,然後帶著 connection_id 返回你的產品。是否改由你自己的 Tech Provider 應用程式運行 Embedded Signup,可參閱 Embedded Signup 指南作出判斷。
訊息如何抵達你的後端?
由 Meta 直接傳送至 webhook_url,不經過 easyCoexistence,也不保留任何副本。messages 欄位載有客戶發來的內容以及你所發送訊息的狀態,smb_message_echoes 則載有員工從應用程式發出的內容。Meta 會以 easyCoexistence 的應用程式密鑰簽署每次傳遞,該密鑰從不分享,因此 URL 路徑中一組隨機的長密鑰即可完成驗證。同一個 WhatsApp Business 帳戶下的兩個號碼共用同一目的地,請依 value.metadata.phone_number_id 進行路由。
你的後端如何回覆並發送範本?
使用 Meta 的 Graph API,以及來自 GET /connections/{id}?credentials=1 的客戶存取權杖,該呼叫亦會返回 send_endpoint。自由格式文字須於對方最後一則訊息後 24 小時內發出;此後只能發送 Meta 已批准的範本:
- 回覆:在服務窗口內,以 type text 呼叫 POST /<
PHONE_NUMBER_ID>/messages。 - 範本:同一呼叫,但 type 設為 template,並附上範本名稱及其語言代碼。
- 建立範本:呼叫 POST /<
WABA_ID>/message_templates,之後輪詢其狀態,因為審核結果不會傳送至你的webhook_url。 - 媒體:呼叫 POST /<
PHONE_NUMBER_ID>/media 上載;收到的媒體會以 ID 形式傳送,你可用同一權杖擷取。
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'你的產品可否匯入客戶現有的聊天記錄?
可於連接時匯入一次。若工作階段已設定 webhook_url,easyCoexistence 會要求 Meta 傳送該號碼的聯絡人;如果客戶在應用程式中同意,還會傳送最多 180 天的聊天記錄,並以 smb_app_state_sync 及 history 的 Webhook 事件送達。Meta 只允許在連接後 24 小時內進行,因此在發出連結前,請確保端點已能正常回應。聊天記錄指南則說明了相關的負載格式。
誰需要向 Meta 支付訊息費用?
由你的客戶支付。Meta 會將你的後端透過 API 發送的訊息費用,計入客戶自己的 WhatsApp Business 帳戶,並以客戶在該帳戶中添加的付款方式扣款;沒有付款方式的商戶無法發送推廣範本。easyCoexistence 按已連接號碼向你的帳戶收費,從不就訊息收費,也不會在 Meta 的價格之上加價。
號碼斷開時會發生什麼事?
你的事件 URL 會收到 connection.disconnected,若已知原因,並附上 Meta 提供的原因。PRIMARY_INACTIVITY 即為 14 天規則;為該客戶建立新的連接工作階段,即可讓同一號碼重新連接。connection.token_missing 表示號碼在沒有客戶權杖的情況下完成連接,因此仍可接收訊息,但在新工作階段重新連接前無法發送。
常見錯誤
- 在 Webhook 端點能正常回應前就發出連接連結。聊天記錄匯入只進行一次,須在連接後 24 小時內完成;在 URL 可正常運作之前發送的內容會遺失。
- 服務窗口關閉後仍以自由格式文字回覆。用戶最後一則訊息後滿 24 小時,就只有獲批准的範本能夠送出。
- 以全速從同一號碼一次過發送推廣活動。Coexistence 號碼以每秒 20 則訊息的速率發送,因此應按此速率為各號碼的發送排隊。
- 以為員工可在手機上發送範本。在 Coexistence 中,只有 API 能發送範本,因此應將範本發送功能加入你的產品中。
easyCoexistence 透過 Meta 的 Embedded Signup 與 Coexistence,在一個顯示你名稱的託管頁面上為你的 SaaS 加入 WhatsApp:你的客戶保留其號碼與 WhatsApp Business 應用程式,Meta 將訊息傳送至你的伺服器,並以已簽署的事件傳達給你。同一 API 亦可連接 Instagram、Facebook、TikTok、YouTube、LinkedIn 及更多渠道。每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費試用。
常見問題
客戶可以連接已在其他 WhatsApp API 供應商處使用的號碼嗎?
只要該號碼仍在該處,就不可以。託管頁面的檢查清單要求號碼上沒有其他 API 供應商或自動化工具,因此客戶須先在該供應商處斷開此號碼。
我的 SaaS 可以為其客戶發送 WhatsApp 範本嗎?
可以,透過 Cloud API 並使用各客戶的存取權杖:先在其 WhatsApp Business 帳戶中建立範本,待 Meta 審核通過後再發送。
easyCoexistence 會讀取我客戶的 WhatsApp 訊息嗎?
不會。Meta 會將號碼的訊息直接傳送至你設定的 webhook_url。沒有設定 webhook_url 的號碼會退回 easyCoexistence 的回調,而這些訊息會被捨棄,不會被儲存。
easyCoexistence 每個 WhatsApp 號碼的收費是多少?
每個號碼每月由 US$ 9 降至 US$ 0.75,按你的連接總數所處的級別計算,首 3 天免費試用。Meta 的訊息費用則由各客戶自己的 WhatsApp Business 帳戶支付。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期