AI 代理的 WhatsApp API:數分鐘獲官方存取權,無需成為 Tech Provider
AI 代理透過 Meta 的 Cloud API 獲得官方 WhatsApp 存取權,而仍留在 WhatsApp Business 應用程式內的號碼,須經由 Tech Provider 或解決方案合作夥伴接入。您可以自行成為其中一種,需完成商業驗證、App Review 影片及 Embedded Signup 建置;或者透過已具備此資格的服務商連接,號碼數分鐘內即可加入,代理則獲得 MCP 工具或 API 憑證。
easyCoexistence 是獨立的 Meta Tech Provider:透過 Coexistence 在數分鐘內將 WhatsApp Business 號碼連接至 Cloud API,使您的代理獲得官方存取權,而商戶仍保留應用程式。
Meta 要求為仍留在 WhatsApp Business 應用程式中的號碼辦理接入的一方,須具備 Tech Provider 或解決方案合作夥伴身分。
App Review 要求提交兩段影片:一段展示從您的應用程式發送訊息,另一段展示應用程式建立訊息範本。
App Review 為 whatsapp_business_messaging 與 whatsapp_business_management 授予的權限,兩者均為成為 Tech Provider 所必需。
Meta 棄用 Embedded Signup v2 與 v3 時,要求整合方遷移至 v4。
同時使用 WhatsApp Business 應用程式與 Cloud API 的號碼,其吞吐量固定。
平台透過 Partner API 為客戶接入號碼時,託管連接連結的有效時間。
AI 代理要正式使用 WhatsApp,需要哪些條件?
Meta 的 Cloud API 需要四項要件。第一,電話號碼 ID,以及具備 whatsapp_business_messaging 權限的存取權杖,使代理能呼叫 messages 端點。第二,Webhook 端點,供 Meta 傳送收到的訊息;若號碼與應用程式共用,還需 smb_message_echoes,以接收使用者在手機上輸入的回覆。第三,已獲批准的訊息範本,因為手動輸入的訊息只能送達 24 小時內曾發來訊息的人。第四,一套能及時察覺連接中斷的機制,因為 API 端停止運作時,手機上的應用程式仍會照常運行。
人們最先找到的捷徑是 WhatsApp Web 自動化,它會以已連結裝置的身分登入。這既違反 WhatsApp 的條款,也會令號碼面臨遭封禁的風險,無論其上的代理如何運作。
Tech Provider 路徑涉及哪些步驟?
依照 Meta 規定的次序,共有以下步驟。每一步均免費,但無法付費加快:審核依 Meta 的時間表進行,Meta 並未公布時間表,因此在首位客戶的號碼成功連接前,請以數週而非數日來規劃。之後後端必須持續運行:每次註冊後的存取權杖交換、Webhook 接收器、按號碼分流,以及監察斷線情況,例如 Meta 的 14 天不活躍規則。
較短的途徑是什麼?
透過已完成該流程的服務商連接號碼。使用 easyCoexistence 時,商戶執行 Meta 的 Embedded Signup,並以 WhatsApp Business 應用程式掃描二維碼,約需兩分鐘。號碼隨即加入商戶自有 Business Portfolio 中的 Cloud API,而應用程式照常運作。代理按其所用的形式取得存取權:適用於 ChatGPT、Claude、Claude Code 或 Codex 等助手的 MCP 工具,或供您所運行程式碼使用的號碼憑證與 Webhook。
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
代理如何取得號碼的憑證?
透過 get_api_credentials,或從控制台中該號碼的頁面取得。此工具會回傳 Graph API 基礎 URL、WhatsApp Business 帳戶 ID、電話號碼 ID、發送端點,以及在存在時由商戶自身的存取權杖,其權限範圍限於該商戶的 WhatsApp 資產。若未發出客戶端權杖,權杖會回傳 null,並附註說明:從控制台重新連接號碼即可發出權杖,而不會取代仍有效的權杖。不需要取得應用程式密鑰,因為 Meta 以 easyCoexistence 的應用程式密鑰簽署 Webhook,該密鑰從不對外分享。由於權杖可用於發送訊息,此工具需要有效的方案。
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'收到的訊息如何送達代理?
每個號碼有兩種模式,可透過 set_inbound_mode 或號碼頁面切換。直接送至您的伺服器:set_webhook_destination 會將 Meta 直接指向您的 HTTPS 端點,該端點必須能回應 Meta 的 GET 握手請求。easyCoexistence 不會接收訊息,因此自動化功能會關閉。由於 Meta 以我們的應用程式密鑰簽署這些傳送,請在 URL 路徑中加入一段長而隨機的密鑰,並拒絕沒有該密鑰的請求。
啟用自動化:Meta 將訊息傳送至 easyCoexistence,自動化可自動回覆。可選的轉發 URL 會在 "value" 下接收 Meta 的原始負載,並以 X-EC-Signature 簽署:t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>">,所用密鑰僅顯示一次。自動化中的「呼叫我的 Webhook」步驟,亦會將訊息及該對話最近 10 則訊息交給您的代理;若您的回應為 {"reply": "..."},且於 20 秒內送達,則會發送該回覆。
代理須遵守哪些限制?
這些限制來自 Meta,無論經由哪個服務商,均相同。預先了解這些限制的代理,可避免那些看似程式錯誤的故障:
- 每個號碼每秒 20 則訊息,由 Meta 為與 WhatsApp Business 應用程式共用的號碼所設定。
- 僅可在客戶最後一則訊息後 24 小時內傳送手動輸入的訊息;之後須使用已獲批准的範本。
- 範本只能透過 API 發送,因為 Coexistence 號碼上的應用程式無法發送範本。
- 使用者在應用程式中輸入的回覆會以
smb_message_echoes送達;請暫停該對話的代理,否則客戶會收到兩則回覆。 - 群組對話不會同步至 API,因此代理只在一對一對話中運作。
- 聯絡人及最多 6 個月的一對一對話只會匯入一次,且僅當在連接後 24 小時內已儲存直接 Webhook 目的地時才會匯入;啟用自動化的號碼則不會獲得匯入。
- 語音及影片通話仍可在應用程式中進行,但 Cloud API 不會在 Coexistence 號碼上傳輸通話,因此代理只以文字運作。
平台能否以此方式為其客戶連接號碼?
可以,透過 Partner API。SaaS 或代理商無需自身具備 Tech Provider 身分,即可為客戶接入號碼。使用 create_api_key 建立金鑰(以 ec_live_ 開頭,僅顯示一次),然後從您的後端呼叫 POST /api/v1/connect-sessions;或從助手呼叫 create_connect_link,取得有效期為 1 小時的託管連結。客戶在該頁面完成 Meta 的彈出視窗及二維碼掃描,然後返回您的 redirect_url 並附帶 connection_id。之後 GET /api/v1/connections/:id?credentials=1 會回傳客戶自己的權杖,而 connection.disconnected 等狀態事件則以 X-EC-Signature 簽署後送達。每個號碼按相同的每號碼收費級別計入您的帳戶。
常見錯誤
- 在直接目的地上驗證 X-Hub-Signature-256。Meta 以 easyCoexistence 的應用程式密鑰簽署,而該密鑰從不對外分享,因此真正的傳送會通過不了驗證;請信任 URL 中一段長而隨機的密鑰,或改用附 X-EC-Signature 的轉發。
- 使用 n8n 的 WhatsApp Trigger 節點接收。該節點要求您自己的 Meta 應用程式;請改用通用的 Webhook 節點,並在其 URL 中加入密鑰。
- 忽略 smb_message_echoes。代理便會在已有人從手機回覆的對話上再次作答,而客戶會看到兩則回覆。
- 在連接數日後才儲存直接 Webhook 目的地,或讓號碼保持自動化。Meta 一次性匯入聯絡人及最多 6 個月對話,需要在連接後 24 小時內儲存直接目的地。
代理可透過超過 30 個 MCP 工具,或透過各號碼的憑證及 Webhook 運作;每個號碼全天候 24/7 監察,並設有警報。每個已連接號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。
常見問題
我需要自己的 Meta 應用程式嗎?
不需要。號碼透過 easyCoexistence 的 Meta 應用程式接入,並保留在商戶自有的 Business Portfolio 與 WhatsApp Business 帳戶中。您的程式碼以 get_api_credentials 取得的商戶自身權杖發送,因此除非您日後自行建立,否則不涉及您的任何應用程式。
代理與團隊能否同時使用該號碼?
可以。Meta 會在 Cloud API 與 WhatsApp Business 應用程式之間同步訊息,因此代理發出的內容會出現在手機應用程式的對話串中,而團隊在應用程式中輸入的內容,則會以 smb_message_echoes 送達您的系統。
哪些代理框架可與之搭配?
任何透過 OAuth 以 HTTP 使用 MCP 的客戶端,例如 ChatGPT、Claude、Claude Code、Codex 及 Cursor;以及任何呼叫 Meta Graph API 的程式碼,包括 Node.js、Python、n8n、LangChain、OpenAI Agents SDK 或 Vercel AI SDK。底層 API 屬於 Meta 本身,因此代理內並無任何專有技術。
WhatsApp 是否允許通用 AI 助手使用?
Meta 商業解決方案條款第 4.7 條,禁止通用 AI 助手服務商,在 AI 為主要功能(由 Meta 認定)的情況下,於 WhatsApp Business Platform 上提供該等服務,自 2026 年 1 月 15 日起生效。商戶為自身客戶使用 AI 處理支援、銷售或預約,並非此條款的針對對象;而歐盟及巴西的監管機構,已命令 Meta 暫停或撤回針對競爭對手助手的該條款。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期