登入開始免費試用
easyCoexistence 官方 API

如何透過 Embedded Signup 與 Coexistence 為 SaaS 加入 WhatsApp

SaaS 可透過 Meta 的 Embedded Signup 與 Coexistence 連接每位客戶現有的號碼,使號碼在 WhatsApp Business 應用程式中繼續運作,從而加入 WhatsApp。使用 easyCoexistence 的 Partner API 時,每位客戶只需一個連接工作階段,即可透過託管頁面完成此流程。Meta 會將該號碼的訊息傳送至你的 webhook_url,而你的後端則以客戶自己的存取權杖,透過 Cloud API 回覆。

20 mps

同時使用 WhatsApp Business 應用程式與 Cloud API 的號碼,其固定吞吐量。

2.24.17

客戶號碼透過 Coexistence 可連接的最舊 WhatsApp Business 應用程式版本。

180 days

Meta 於入職時可共享的聊天記錄回溯期限,必須於 24 小時內完成同步。

24 hours

用戶發送訊息或致電後,WhatsApp 的客戶服務窗口;每則新訊息都會重設該窗口。

October 15, 2026

Meta 停用 Embedded Signup v2 與 v3 的日期,相關整合已遷移至 v4。

WhatsApp 整合包含哪些部分?

共五個部分,easyCoexistence 負責第一和最後一個。你的產品負責對話邏輯、收件箱,以及你的模型或客戶員工撰寫的任何內容;Meta 則負責在號碼與你的伺服器之間傳遞訊息:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

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 形式傳送,你可用同一權杖擷取。
Reply inside the customer service window
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 完成這項設定

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 監察

驗證日期