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

為您的客戶提供 WhatsApp Embedded Signup:自建 Tech Provider 應用程式或託管頁面

SaaS 可以透過 Meta 的 Embedded Signup,以兩種方式將客戶的 WhatsApp Business 應用程式號碼連接至 Cloud API。一是自行成為 Meta Tech Provider,這需要完成企業驗證、提交附有兩段影片的 App Review,並自行建置 Embedded Signup。二是將客戶導向由已是 Tech Provider 的服務商營運的託管 Embedded Signup 頁面,然後接收完成的連接。

easyCoexistence 在一個顯示您名稱的託管頁面上,透過 Coexistence 執行 Meta 的 Embedded Signup,讓您的客戶無需您成為 Tech Provider 即可連接號碼。

10 to 200

Tech Provider 每滾動 7 天可入職的新企業客戶數量:預設為 10,完成驗證與審核後為 200。

2 videos

App Review 要求 Tech Provider 提供的螢幕錄影:一則訊息已發送與接收,以及一個訊息範本正在建立。

About 24 hours

Meta 公布的 WhatsApp 應用程式 App Review 平均處理時間。

2.24.17

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

30 seconds

Embedded Signup 回傳的代碼,伺服器用以換取客戶企業存取權杖的有效時限。

為客戶的號碼完成連接,有哪兩種方式?

兩種方式都使用 Meta 的 Embedded Signup 配合 Coexistence,最終結果相同:客戶的號碼已接入 Cloud API,仍可在 WhatsApp Business 應用程式中使用,而您的後端持有客戶自己的企業存取權杖。兩者的差異在於由誰承擔 Meta 的要求,以及彈出視窗周邊的程式碼由誰負責。

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn the customer's WhatsApp Business Account

成為 Tech Provider 需要符合哪些 Meta 要求?

Meta 在「Become a Tech Provider」指南中列出了相關步驟,您可在 App Dashboard 中,於 WhatsApp 用途下的 Tech Provider 入職流程找到該指南:

  • 具備 WhatsApp 用途的 Meta 應用程式,並已連接至您的 Business Portfolio。
  • 企業驗證,這是首要步驟:Meta 只會為已驗證的企業啟動 App Review。
  • 應用程式設定,例如圖示、私隱政策及類別。
  • 取得 whatsapp_business_messaging 與 whatsapp_business_management 的進階存取權限,須透過 App Review 提交,並為每項權限附上書面說明及螢幕錄影。
  • 共兩段錄影:由您的應用程式發送、並在 WhatsApp 中接收的訊息,以及您的應用程式建立訊息範本的過程。

獲得批准後,您需要建置什麼?

入職流程本身,Meta 的 Embedded Signup 指南已逐步說明:

  • 您網站上的流程,透過 Facebook Login for Business 及 Meta 的 JavaScript SDK 運作,並只能在應用程式中允許的 HTTPS 網域上執行。
  • 在流程設定中啟用 Coexistence,並記錄工作階段日誌,這是 Meta 對 Coexistence 的要求。
  • 伺服器端的呼叫,須在 30 秒內將回傳的代碼換取為客戶的企業存取權杖。
  • Webhook:您的應用程式需訂閱每個客戶的帳戶,並包含 account_update、history、smb_app_state_sync 及 smb_message_echoes 欄位。
  • 入職後 24 小時內完成聯絡人與歷史記錄同步;之後,客戶必須先執行退出,再重新執行流程。

託管頁面承擔哪些工作?

彈出視窗的整個部分。easyCoexistence 以其自有的 Meta 應用程式,作為 Tech Provider 透過 Coexistence 執行 Embedded Signup,頁面位於 easycoexistence.com,並顯示您的名稱。存取權杖換取、Webhook 訂閱及歷史記錄請求均在該頁面完成,您的後端會接收一個連接 ID。當工作階段設有 webhook_url 時,Meta 會將該號碼的訊息直接傳送至您的伺服器,同時一次性匯入聯絡人;若客戶同意分享,還可匯入最多 180 天的聊天記錄。您的程式碼之後即可使用客戶的權杖直接呼叫 Meta 的 Graph API,而 easyCoexistence 會持續監察該號碼,並在其變動時發送已簽署的事件。

客戶會看到什麼?

一個顯示您名稱的頁面,以及一個「連接」按鈕。在 Meta 的彈出視窗開啟前,清單會請客戶確認五項事項:WhatsApp Business 應用程式為最新版本、號碼已實際使用至少 7 天、號碼上沒有其他 API 供應商或自動化工具、沒有非官方應用程式,以及手機在手並可登入 Facebook。系統不會要求客戶提供帳戶、電郵或信用卡資料。

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

Meta 的彈出視窗中會發生什麼?

Meta 的流程會讓客戶以 Facebook 登入、授權應用程式並輸入號碼,然後顯示該號碼的 WhatsApp Business 應用程式個人檔案供客戶確認。客戶可選取或建立 Business Portfolio,接著在 WhatsApp Business 應用程式內掃描 QR 碼;Meta 也會向該號碼發送一則包含 QR 碼連結的 WhatsApp 訊息。在應用程式中,客戶點選「連接」,並選擇是否分享聊天記錄。最後是帳戶名稱、時區及 Meta 條款。在 Meta 推出以電話號碼為先的流程期間,步驟順序可能有所不同。

Meta 的彈出視窗顯示的是誰的名稱?

是要求存取權限的應用程式名稱。在託管頁面上,該名稱為 easyCoexistence,且無法更改;而彈出視窗周圍的頁面會顯示您在 partner_name 中設定的名稱。若您自行擁有 Tech Provider 應用程式,彈出視窗便會顯示您應用程式的名稱,但代價是需要完成上述的驗證、審核及建置工作。

14 天規則是什麼?

當持有 WhatsApp Business 應用程式的手機閒置約 14 天後,Meta 會中斷該 Coexistence 號碼的連接,並以 PRIMARY_INACTIVITY 作為原因。客戶只要使用同一號碼重新執行流程即可重新連接。透過託管頁面,easyCoexistence 會監察每個號碼,並向您的 events URL 發送附有該原因的 connection.disconnected 事件,因此為客戶發出新的連接連結,即可讓號碼恢復連接。

常見錯誤

  • 以 Embedded Signup v2 或 v3 進行建置。Meta 已於 2026 年 10 月 15 日棄用兩者,並將其請求改由 v4 處理。
  • 申請應用程式並未使用的權限。Meta 指出,不必要的權限是 App Review 拒絕提交的常見原因。
  • 為兩項權限只錄製一段影片。Meta 要求每項權限各自提供獨立的螢幕錄影及書面說明,並可能拒絕包含多項權限的影片。
  • 要求客戶從持有號碼的手機連接。Meta 彈出視窗會在該手機上以新分頁開啟,而同一部手機必須掃描 QR 碼,因此改用電腦會更方便。
使用 EasyCoexistence 完成這項設定

您的後端會接收每位客戶自己的存取權杖,Meta 會將訊息直接傳送至您的 Webhook,連接中斷則會以已簽署事件通知您。每個已連接號碼每月 US$ 9 起,最低降至 US$ 0.75,號碼越多越便宜,首 3 天免費。

常見問題

只有要為客戶的 WhatsApp 號碼進行入職,我需要成為 Meta Tech Provider 嗎?

只有在您使用自有的 Meta 應用程式執行 Embedded Signup 時才需要。將客戶導向由 Tech Provider 營運的託管頁面,即可連接其號碼,無需您自行完成企業驗證或 App Review。

WhatsApp 應用程式的 Meta App Review 需時多久?

Meta 公布的平均時間約為 24 小時。企業驗證必須先完成,審核才能開始;每次遭拒都會再增加一輪審核。

客戶可以繼續使用 WhatsApp Business 應用程式嗎?

可以。該應用程式在客戶的手機上會與 API 並行運作,兩者之間的訊息會互相同步。部分應用程式功能會有所改變:廣播名單會變為唯讀,而限時訊息及只限查看一次的訊息會被關閉。

誰需要向 Meta 支付訊息費用?

由客戶支付。Meta 會將透過 API 發送的訊息計入客戶自己的 WhatsApp Business Account,並使用其在該帳戶中新增的付款方式扣款;而從 WhatsApp Business 應用程式發送的訊息則維持免費。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期