WhatsApp API para sa AI agents: opisyal na access sa loob ng ilang minuto, nang hindi nagiging Tech Provider
Nakukuha ng AI agent ang opisyal na WhatsApp access sa pamamagitan ng Cloud API ng Meta, at ang numerong nananatili sa WhatsApp Business app ay sumasali rito sa pamamagitan ng Tech Provider o Solution Partner. Maaari ninyong maging isa, na may business verification, App Review videos at Embedded Signup build, o kumonekta sa provider na isa na: sumasali ang numero sa loob ng ilang minuto at nakukuha ng agent ang MCP tools o API credentials.
Ang easyCoexistence ay isang independent na Meta Tech Provider: ikinokonekta nito ang WhatsApp Business number sa Cloud API sa pamamagitan ng Coexistence sa loob ng ilang minuto, kaya nakukuha ng agent ninyo ang opisyal na access habang pinapanatili ng negosyo ang app.
Ang hinihingi ng Meta sa sinumang nag-o-onboard ng numerong nananatili sa WhatsApp Business app: status na Tech Provider o Solution Partner.
Hinihingan ng App Review ng isang video ng mensaheng ipinadala mula sa iyong app, at isa pa ng iyong app na gumagawa ng template.
Ang ibinibigay ng App Review para sa whatsapp_business_messaging at whatsapp_business_management, parehong kailangan para maging Tech Provider.
Nang i-deprecate ng Meta ang Embedded Signup v2 at v3, sinabihan ang mga integration na lumipat sa v4.
Nakapirming throughput ng numerong ginagamit sa WhatsApp Business app at Cloud API nang sabay.
Gaano katagal nananatiling valid ang hosted connect link kapag ino-onboard ng platform ang numero ng customer sa pamamagitan ng Partner API.
Ano ang kailangan ng AI agent para gumamit ng WhatsApp nang opisyal?
Apat na bagay mula sa Cloud API ng Meta. Phone number ID at access token na may whatsapp_business_messaging permission, para matawagan ng agent ang messages endpoint. Isang webhook endpoint kung saan inihahatid ng Meta ang mga papasok na mensahe, at, sa numerong kasama ng app, ang smb_message_echoes para sa mga sagot na tina-type ng tao sa telepono. Mga approved template, dahil ang typed na mensahe ay umaabot lamang sa taong nagsulat sa loob ng huling 24 na oras. At paraan para malaman kapag nasira ang koneksyon, dahil patuloy na gumagana ang app sa telepono kahit huminto ang API side.
Ang shortcut na unang nakikita ng marami ay WhatsApp Web automation, na nagla-log in bilang linked device. Nilalabag nito ang terms ng WhatsApp at inilalagay sa panganib ng ban ang numero, anuman ang gawin ng agent sa ibabaw nito.
Ano ang kasama sa Tech Provider route?
Ang sunod-sunod na proseso ng Meta mismo, sa ganitong pagkakasunod. Libre ang bawat hakbang, at walang paraan para mabilis itong mabili: tumatakbo ang review ayon sa iskedyul ng Meta at walang inilalabas na timeline ang Meta, kaya magplano para sa mga linggo, hindi araw, bago kumonekta ang numero ng unang customer. Pagkatapos nito, kailangang patuloy na tumakbo ang backend: ang token exchange pagkatapos ng bawat signup, isang webhook receiver, routing kada numero, at pagmo-monitor para sa mga pagkawala ng koneksyon gaya ng 14-day inactivity rule ng Meta.
Ano ang mas maikling ruta?
Ikonekta ang numero sa pamamagitan ng provider na dumaan na sa prosesong iyon. Sa easyCoexistence, pinapatakbo ng negosyo ang Embedded Signup ng Meta at nag-scan ng code gamit ang WhatsApp Business app, na tumatagal ng mga dalawang minuto, at sumasali ang numero sa Cloud API sa sariling Business Portfolio ng negosyo habang patuloy na gumagana ang app. Pagkatapos ay nakukuha ng agent ang access sa anyong naiintindihan nito: MCP tools para sa assistant gaya ng ChatGPT, Claude, Claude Code o Codex, o ang credentials at webhooks ng numero para sa code na pinapatakbo ninyo.
| 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 |
Paano kukunin ng agent ang credentials ng numero?
Sa pamamagitan ng get_api_credentials, o mula sa pahina ng numero sa dashboard. Ibinabalik ng tool ang Graph API base URL, ang WhatsApp Business Account ID, ang phone number ID, ang send endpoint at, kapag mayroon, ang sariling access token ng negosyo, na naka-scope sa mga WhatsApp asset nito. Kapag walang client token na naibigay, ibinabalik na null ang token kasama ng tala na ang muling pagkonekta ng numero mula sa dashboard ay magbibigay ng isa, nang hindi pinapalitan ang token na gumagana na. Walang app secret na kukunin, dahil pinipirmahan ng Meta ang webhooks gamit ang app secret ng easyCoexistence, na hindi kailanman ibinabahagi. Kailangan ng tool ang aktibong plan, dahil nakapagpapadala ang token.
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." }
}'Paano nakakarating ang mga papasok na mensahe sa agent?
Bawat numero ay may dalawang mode, na pinapalitan gamit ang set_inbound_mode o sa pahina ng numero. Direkta sa iyong server: itinuturo ng set_webhook_destination ang Meta nang diretso sa iyong HTTPS endpoint, na dapat sumagot sa GET handshake ng Meta, at hindi kailanman nakikita ng easyCoexistence ang mga mensahe, kaya naka-off ang automations. Dahil pinipirmahan ng Meta ang mga delivery na iyon gamit ang app secret ng easyCoexistence, maglagay ng mahaba at random na secret sa URL path at tanggihan ang mga request na wala nito.
Automations na naka-on: inihahatid ng Meta sa easyCoexistence, maaaring sumagot ang automations, at tumatanggap ang opsyonal na Forward URL ng orihinal na payload ng Meta sa ilalim ng "value", pinirmahan ng X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 ng "<t>.<body>"> gamit ang secret na ipinapakita nang isang beses. Ang hakbang ng automation na Call my webhook ay nagbibigay din sa agent ng mensahe at ng huling 10 mensahe ng chat, at ipinapadala ang sagot nito kapag ang sagot ninyo ay {"reply": "..."} sa loob ng 20 segundo.
Anong limitasyon ang dapat sundin ng agent?
Limitasyon ng Meta, at pareho sila kahit anong provider ang gamitin. Ang agent na nakakaalam nito nang maaga ay makakaiwas sa mga failure na mukhang bug:
- 20 mensahe kada segundo kada numero, itinakda ng Meta para sa mga numerong kasama ng WhatsApp Business app.
- Typed na mensahe lamang sa loob ng 24 na oras mula sa huling mensahe ng customer; pagkatapos nito, approved template.
- Lumalabas lamang ang mga template sa pamamagitan ng API, dahil hindi kayang magpadala nito ang app sa numerong Coexistence.
- Ang mga sagot na tina-type ng tao sa app ay dumarating bilang
smb_message_echoes; i-pause ang agent sa chat na iyon, o makakatanggap ng dalawang sagot ang customer. - Hindi naisi-sync sa API ang group chats, kaya gumagana ang agent sa one-to-one chats.
- Ang contacts at hanggang 6 na buwan ng one-to-one chats ay ini-import nang isang beses, at kung may naka-save na direct webhook destination lamang sa loob ng 24 na oras mula sa koneksyon; hindi nakakakuha ng import ang numerong may naka-on na automations.
- Patuloy na gumagana sa app ang voice at video calls, pero hindi dinadala ng Cloud API ang calls sa numerong Coexistence, kaya text ang gamit ng agent.
Puwede bang ikonekta ng platform ang sarili nitong numero ng customer sa ganitong paraan?
Oo, sa pamamagitan ng Partner API, na paraan ng SaaS o agency para mag-onboard ng kanilang mga customer nang walang sariling Tech Provider status. Gumawa ng key gamit ang create_api_key (nagsisimula sa ec_live_ at ipinapakita nang isang beses), pagkatapos ay tawagin ang POST /api/v1/connect-sessions mula sa iyong backend, o create_connect_link mula sa assistant, para sa hosted link na valid nang 1 oras. Pinapatakbo ng customer doon ang popup ng Meta at ang QR scan, at bumabalik sa iyong redirect_url kasama ang connection_id. Ibinabalik ng GET /api/v1/connections/:id?credentials=1 ang sariling token ng customer, at dumarating ang mga status event gaya ng connection.disconnected na pinirmahan ng X-EC-Signature. Sinisingil sa iyong account ang bawat numero sa parehong per-number bands.
Mga karaniwang pagkakamali
- Pag-validate ng X-Hub-Signature-256 sa direct destination. Pinipirmahan ng Meta gamit ang app secret ng easyCoexistence, na hindi kailanman ibinabahagi, kaya nabibigo ang totoong delivery sa check; pagkatiwalaan ang mahaba at random na secret sa URL, o gamitin ang forwarding na may X-EC-Signature.
- Pagtanggap gamit ang WhatsApp Trigger node ng n8n. Inaasahan nito ang sarili ninyong Meta app; gamitin na lang ang generic na Webhook node na may secret sa URL nito.
- Pag-balewala sa smb_message_echoes. Sumasagot ang agent sa ibabaw ng taong nakasagot na mula sa telepono, at dalawang sagot ang nababasa ng customer.
- Pag-save ng direct webhook destination pagkalipas ng ilang araw mula sa pagkonekta, o pag-iwan ng numero sa automations. Kailangan ng isang-beses na import ng Meta ng contacts at hanggang 6 na buwan ng chats ang direct destination na naka-save sa loob ng 24 na oras mula sa koneksyon.
Gumagana ang agent sa mahigit 30 MCP tools o sa pamamagitan ng credentials at webhooks ng bawat numero, at binabantayan ang bawat numero 24/7 na may alerts. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, na may unang 3 araw na free trial.
Mga madalas itanong
Kailangan ko ba ng sarili kong Meta app?
Hindi. Ino-onboard ang numero sa pamamagitan ng Meta app ng easyCoexistence, at nananatili ito sa sariling portfolio at WhatsApp Business Account ng negosyo. Nagpapadala ang code ninyo gamit ang sariling token ng negosyo mula sa get_api_credentials, kaya walang sariling app na kasali maliban kung gumawa kayo ng isa sa hinaharap.
Puwede bang gamitin ng agent at ng team ang numero nang sabay?
Oo. Sinasalamin ng Meta ang mga mensahe sa pagitan ng Cloud API at ng WhatsApp Business app, kaya lumalabas sa chat thread ng app sa telepono ang ipinapadala ng agent, at ang tina-type ng team sa app ay umaabot sa sistema ninyo bilang smb_message_echoes.
Aling agent frameworks ang gumagana rito?
Anumang client na nagsasalita ng MCP sa HTTP na may OAuth, gaya ng ChatGPT, Claude, Claude Code, Codex at Cursor, at anumang code na tumatawag sa Graph API ng Meta: Node.js, Python, n8n, LangChain, ang OpenAI Agents SDK o ang Vercel AI SDK. Ang API sa ilalim nito ay sa Meta mismo, kaya walang proprietary na bahagi sa loob ng agent.
Pinapayagan ba ang general-purpose na AI assistant sa WhatsApp?
Pinaghihigpitan ng Business Solution Terms ng Meta, seksyon 4.7, ang mga provider ng general-purpose na AI assistant na mag-alok nito sa WhatsApp Business Platform kung saan ang AI ang pangunahing functionality, ayon sa pagtukoy ng Meta, at may bisa mula Enero 15, 2026. Ang negosyong gumagamit ng AI para sa sarili nitong customer, para sa suporta, benta o booking, ay hindi ang target, at inutusan ng mga regulator sa EU at Brazil ang Meta na suspendihin o bawiin ang patakaran para sa mga karibal na assistant.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong