WhatsApp API za AI agente: službeni pristup za nekoliko minuta bez statusa Tech Provider
AI agent dobiva službeni WhatsApp pristup putem Cloud API-ja Mete, a broj koji ostaje u aplikaciji WhatsApp Business pridružuje se putem statusa Tech Provider ili Solution Partner. Možete ga steći sami, uz provjeru tvrtke, App Review snimke i izgradnju Embedded Signupa, ili se povezati putem pružatelja koji ga već ima: broj se pridruži za nekoliko minuta, a agent dobiva MCP alate ili API vjerodajnice.
easyCoexistence je nezavisni Meta Tech Provider: povezuje broj WhatsApp Business s Cloud API-jem putem funkcije Coexistence u nekoliko minuta, pa vaš agent dobiva službeni pristup dok tvrtka zadržava aplikaciju.
Što Meta zahtijeva od onoga tko uključuje broj koji ostaje u aplikaciji WhatsApp Business: status Tech Provider ili Solution Partner.
App Review traži jednu snimku poruke poslane iz vaše aplikacije i jednu snimku u kojoj vaša aplikacija stvara predložak.
Što App Review dodjeljuje za whatsapp_business_messaging i whatsapp_business_management, oba potrebna za dobivanje statusa Tech Provider.
Kada je Meta ukinula Embedded Signup v2 i v3 i zatražila od integracija prelazak na v4.
Fiksna propusnost broja koji se istodobno koristi u aplikaciji WhatsApp Business i u Cloud API-ju.
Koliko dugo poveznica za povezivanje ostaje važeća kada platforma preko Partner API-ja uključuje broj klijenta.
Što AI agent treba za službenu upotrebu WhatsApp-a?
Četiri stvari iz Metinog Cloud API-ja. ID broja telefona i pristupni token s dozvolom whatsapp_business_messaging, kako bi agent mogao pozvati endpoint za poruke. Webhook endpoint na koji Meta isporučuje dolazne poruke te, na broju dijeljenom s aplikacijom, smb_message_echoes za odgovore koje osoba upiše na telefonu. Odobreni predlošci, jer ručno upisana poruka stiže samo osobi koja je pisala u posljednja 24 sata. I način da se sazna kada veza pukne, jer aplikacija na telefonu nastavlja raditi kada API stane.
Prečac koji ljudi najprije pronađu jest automatizacija WhatsApp Weba, koja se prijavljuje kao povezani uređaj. To krši uvjete usluge i izlaže broj riziku od blokade, bez obzira na to što agent radi iznad toga.
Što uključuje put preko statusa Tech Provider?
Metin vlastiti slijed, navedenim redoslijedom. Svaki korak je besplatan, a nijedan se ne može ubrzati plaćanjem: pregledi se odvijaju prema Metinom rasporedu, a Meta ne objavljuje rokove, pa planirajte tjedne, a ne dane, prije nego se broj prvog klijenta poveže. Nakon toga pozadinski sustav mora stalno raditi: razmjena tokena nakon svake prijave, prijemnik webhookova, usmjeravanje po broju i praćenje prekida veze, primjerice Metina pravila o neaktivnosti od 14 dana.
Koji je kraći put?
Povežite broj putem pružatelja koji je već prošao taj postupak. Uz easyCoexistence tvrtka pokreće Embedded Signup Mete i skenira kod u aplikaciji WhatsApp Business, što traje oko dvije minute, a broj se pridruži Cloud API-ju u vlastitom Business Portfolio tvrtke dok aplikacija nastavlja raditi. Agent zatim dobiva pristup u obliku koji mu odgovara: MCP alate za asistente kao što su ChatGPT, Claude, Claude Code ili Codex, ili vjerodajnice i webhookove broja za kod koji sami pokrećete.
| 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 |
Kako agent dolazi do vjerodajnica broja?
Putem get_api_credentials ili sa stranice broja na nadzornoj ploči. Alat vraća osnovni URL Graph API-ja, ID računa WhatsApp Business, ID broja telefona, endpoint za slanje i, ako postoji, vlastiti pristupni token tvrtke, ograničen na njezine WhatsApp resurse. Ako klijentski token nije izdan, token se vraća kao null s napomenom da ponovno povezivanje broja s nadzorne ploče izdaje jedan, bez zamjene tokena koji radi. Nema tajnog ključa aplikacije (app secret) koji treba dohvatiti, jer Meta potpisuje webhookove ključem aplikacije easyCoexistence, koji se nikada ne dijeli. Alat zahtijeva aktivan plan, jer token može slati poruke.
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." }
}'Kako dolazne poruke stižu do agenta?
Svaki broj ima dva načina rada, a mijenja se alatom set_inbound_mode ili na stranici broja. Izravno na vaš poslužitelj: set_webhook_destination usmjerava Metu izravno na vaš HTTPS endpoint, koji mora odgovoriti na Metin GET handshake, a easyCoexistence nikada ne vidi poruke, pa su automatizacije isključene. Budući da Meta te isporuke potpisuje našim ključem aplikacije, stavite dugu nasumičnu tajnu u putanju URL-a i odbacujte zahtjeve bez nje.
Automatizacije uključene: Meta isporučuje poruke platformi easyCoexistence, automatizacije mogu odgovarati, a neobavezni Forward URL prima Metin izvorni payload pod ključem "value", potpisan s X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 od "<t>.<body>"> pomoću tajne prikazane jednom. Korak automatizacije Call my webhook također predaje poruku i posljednjih 10 poruka razgovora vašem agentu te šalje njegov odgovor kada je vaš odgovor {"reply": "..."} unutar 20 sekundi.
Koja ograničenja agent mora poštovati?
Metina, i jednaka su kod svakog pružatelja. Agent koji ih unaprijed poznaje izbjegava greške koje izgledaju kao bugovi:
- 20 poruka u sekundi po broju, koje je Meta odredila za brojeve dijeljene s aplikacijom WhatsApp Business.
- Ručno upisane poruke samo unutar 24 sata od posljednje poruke kupca; nakon toga, odobreni predložak.
- Predlošci se šalju isključivo putem API-ja, jer aplikacija na Coexistence broju ne može ih slati.
- Odgovori koje osoba upiše u aplikaciji stižu kao
smb_message_echoes; zaustavite agenta u tom razgovoru, inače kupac dobije dva odgovora. - Grupni razgovori nisu sinkronizirani s API-jem, pa agent radi u razgovorima jedan na jedan.
- Kontakti i do 6 mjeseci razgovora jedan na jedan uvoze se jednom, samo ako je izravno odredište webhooka spremljeno unutar 24 sata od povezivanja; broj s uključenim automatizacijama ne dobiva uvoz.
- Glasovni i video pozivi rade u aplikaciji, ali Cloud API ne prenosi pozive na Coexistence broju, pa agent radi tekstualno.
Može li platforma povezivati brojeve vlastitih klijenata na ovaj način?
Može, putem Partner API-ja, kako SaaS platforma ili agencija uključuje svoje klijente bez vlastitog statusa Tech Provider. Ključ kreirajte s create_api_key (počinje s ec_live_ i prikazuje se jednom), zatim pozovite POST /api/v1/connect-sessions s vašeg backenda ili create_connect_link iz asistenta, za hostiranu poveznicu valjanu 1 sat. Klijent tamo provodi Metin skočni prozor i skeniranje QR kôda te se vraća na vaš redirect_url s connection_id. GET /api/v1/connections/:id?credentials=1 zatim vraća vlastiti token klijenta, a događaji statusa, poput connection.disconnected, stižu potpisani s X-EC-Signature. Svaki broj naplaćuje se vašem računu po istim razinama cijene po broju.
Uobičajene pogreške
- Provjera X-Hub-Signature-256 na izravnom odredištu. Meta potpisuje ključem aplikacije easyCoexistence, koji se nikada ne dijeli, pa autentične isporuke ne prolaze provjeru; vjerujte dugoj nasumičnoj tajni u URL-u ili koristite prosljeđivanje s X-EC-Signature.
- Primanje putem čvora WhatsApp Trigger u n8n-u. On očekuje vašu vlastitu Meta aplikaciju; umjesto toga koristite generički čvor Webhook s tajnom u URL-u.
- Zanemarivanje smb_message_echoes. Agent tada odgovara osobi koja je već odgovorila s telefona, a kupac vidi dva odgovora.
- Spremanje izravnog odredišta webhooka nekoliko dana nakon povezivanja ili ostavljanje broja s automatizacijama. Metin jednokratni uvoz kontakata i do 6 mjeseci razgovora zahtijeva izravno odredište spremljeno unutar 24 sata od povezivanja.
Agent radi kroz više od 30 MCP alata ili kroz vjerodajnice i webhookove svakog broja, a svaki broj se nadzire 24/7 uz upozorenja. Od US$ 9 do US$ 0,75 po broju mjesečno, uz pad cijene kako dodajete brojeve, a prva 3 dana su besplatna.
Često postavljana pitanja
Trebam li vlastitu Meta aplikaciju?
Ne. Broj se uključuje kroz Meta aplikaciju easyCoexistence i ostaje u Business Portfolio tvrtke i njezinom WhatsApp Business računu. Vaš kod šalje s vlastitim tokenom tvrtke iz get_api_credentials, pa nijedna vaša aplikacija nije uključena, osim ako je kasnije sami ne izgradite.
Mogu li agent i tim istodobno koristiti broj?
Da. Meta zrcali poruke između Cloud API-ja i aplikacije WhatsApp Business, pa ono što agent pošalje dolazi u nit razgovora u aplikaciji na telefonu, a ono što tim upiše u aplikaciji stiže vašem sustavu kao smb_message_echoes.
Koji okviri za agente rade s njim?
Svaki klijent koji govori MCP preko HTTP-a s OAuth-om, na primjer ChatGPT, Claude, Claude Code, Codex i Cursor, te svaki kod koji poziva Metin Graph API: Node.js, Python, n8n, LangChain, OpenAI Agents SDK ili Vercel AI SDK. API ispod je Metin vlastiti, pa unutar agenta ne postoji ništa vlasničko.
Smije li opći AI asistent koristiti WhatsApp?
Metini Business Solution Terms, odjeljak 4.7, zabranjuju pružateljima općih AI asistenata da ih nude na platformi WhatsApp Business Platform kada je AI primarna funkcionalnost, kako Meta odredi, a vrijede od 15. siječnja 2026. Tvrtka koja koristi AI za vlastite klijente, za podršku, prodaju ili rezervacije nije meta, a regulatori u EU-u i Brazilu naložili su Meti da obustavi ili vrati pravilo za konkurentne asistente.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na