為您的客戶提供 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 即可連接號碼。
Tech Provider 每滾動 7 天可入職的新企業客戶數量:預設為 10,完成驗證與審核後為 200。
App Review 要求 Tech Provider 提供的螢幕錄影:一則訊息已發送與接收,以及一個訊息範本正在建立。
Meta 公布的 WhatsApp 應用程式 App Review 平均處理時間。
客戶可透過 Coexistence 連接的最舊 WhatsApp Business 應用程式版本。
Embedded Signup 回傳的代碼,伺服器用以換取客戶企業存取權杖的有效時限。
為客戶的號碼完成連接,有哪兩種方式?
兩種方式都使用 Meta 的 Embedded Signup 配合 Coexistence,最終結果相同:客戶的號碼已接入 Cloud API,仍可在 WhatsApp Business 應用程式中使用,而您的後端持有客戶自己的企業存取權杖。兩者的差異在於由誰承擔 Meta 的要求,以及彈出視窗周邊的程式碼由誰負責。
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On 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。系統不會要求客戶提供帳戶、電郵或信用卡資料。
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 碼,因此改用電腦會更方便。
您的後端會接收每位客戶自己的存取權杖,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 監察
驗證日期