WhatsApp API za AI agente: zvanični pristup za nekoliko minuta, bez postajanja Tech Providerom
AI agent dobija zvanični WhatsApp pristup preko Meta-ovog Cloud API-ja, a broj koji ostaje u aplikaciji WhatsApp Business se povezuje preko statusa Tech Provider ili Solution Partner. Možete postati jedan od njih uz verifikaciju firme, App Review snimke i izgradnju Embedded Signup toka, ili se povezati preko provajdera koji to već jeste: broj se pridruži za nekoliko minuta, a agent dobija MCP alate ili API kredencijale.
easyCoexistence je nezavisni Meta Tech Provider: povezuje broj WhatsApp Business sa Cloud API-jem preko Coexistencea za nekoliko minuta, pa vaš agent dobija zvanični pristup dok firma zadržava aplikaciju.
Šta Meta zahteva od onoga ko povezuje broj koji ostaje u aplikaciji WhatsApp Business: status Tech Provider ili Solution Partner.
App Review traži jedan snimak poruke poslate iz vaše aplikacije i jedan snimak u kojem vaša aplikacija kreira šablon.
Šta App Review odobrava za whatsapp_business_messaging i whatsapp_business_management, oba potrebna da biste postali Tech Provider.
Kada je Meta ukinula Embedded Signup v2 i v3 i pozvala integracije da pređu na v4.
Fiksna propusnost broja koji se koristi istovremeno u aplikaciji WhatsApp Business i Cloud API-ju.
Koliko dugo hosted link za povezivanje ostaje važeći kada platforma poveže broj kupca preko Partner API-ja.
Šta AI agentu treba da bi zvanično koristio WhatsApp?
Četiri stvari iz Meta-ovog Cloud API-ja. ID broja telefona i access token sa dozvolom whatsapp_business_messaging, kako bi agent mogao da poziva endpoint za poruke. Webhook endpoint na koji Meta isporučuje dolazne poruke, a na broju koji se deli sa aplikacijom i smb_message_echoes za odgovore koje osoba ukuca na telefonu. Odobreni šabloni, jer poruku koja se kuca može da dobije samo osoba koja je pisala u poslednja 24 sata. I način da znate kada veza pukne, jer aplikacija na telefonu nastavlja da radi kada API strana prestane.
Prečica koju ljudi prvo pronađu je automatizacija WhatsApp Weba, koja se prijavljuje kao povezani uređaj. To krši uslove WhatsAppa i ugrožava broj rizikom od blokade, bez obzira na to šta agent radi iznad toga.
Šta uključuje Tech Provider put?
Meta-ov sopstveni niz koraka, tim redom. Svaki korak je besplatan i nijedan se ne može kupiti brže: pregledi idu po Meta-inom rasporedu, a Meta ne objavljuje rok, pa računajte na nedelje, a ne na dane, pre nego što se broj prvog kupca poveže. Posle toga backend mora da radi stalno: razmena tokena posle svakog prijavljivanja, prijemnik za webhookove, rutiranje po broju i praćenje prekida veze, na primer Metinog pravila o neaktivnosti od 14 dana.
Koji je kraći put?
Povežite broj preko provajdera koji je već prošao taj proces. Uz easyCoexistence, firma pokreće Meta-ov Embedded Signup i skenira kod aplikacijom WhatsApp Business, što traje oko dva minuta, a broj se pridružuje Cloud API-ju dok ostaje u sopstvenom Business Portfolio, a aplikacija nastavlja da radi. Agent potom dobija pristup u obliku koji mu odgovara: MCP alate za asistenta kao što su ChatGPT, Claude, Claude Code ili Codex, ili kredencijale broja i webhookove 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 dobija kredencijale broja?
Preko get_api_credentials ili sa stranice broja u kontrolnoj tabli. Alat vraća osnovnu URL adresu Graph API-ja, ID WhatsApp Business naloga, ID broja telefona, endpoint za slanje i, kada postoji, firmin sopstveni access token, ograničen na njena WhatsApp sredstva. Kada klijent token nije izdat, token se vraća kao null uz napomenu da ponovno povezivanje broja iz kontrolne table izdaje jedan, bez zamene tokena koji radi. Nema app secret-a koji treba preuzeti, jer Meta potpisuje webhookove tajnim ključem aplikacije easyCoexistence, koji se nikada ne deli. Alat zahteva aktivni plan, jer token može da šalje 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 režima, koja se menjaju preko set_inbound_mode ili na stranici broja. Direktno na vaš server: set_webhook_destination usmerava Meta ravno na vaš HTTPS endpoint, koji mora da odgovori na Metin GET handshake, a easyCoexistence nikada ne vidi poruke, pa su automatizacije isključene. Pošto Meta potpisuje te isporuke našim app secret-om, stavite dugi nasumični tajni ključ u putanju URL-a i odbijajte zahteve bez njega.
Automatizacije uključene: Meta isporučuje easyCoexistence-u, automatizacije mogu da odgovore, a opcioni Forward URL prima Metin originalni payload pod ključem „value", potpisan sa X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 od „<t>.<body>"> uz tajni ključ prikazan jednom. Korak automatizacije Call my webhook takođe prosleđuje poruku i poslednjih 10 poruka četa vašem agentu, i šalje njegov odgovor kada je vaš odgovor {"reply": "..."} u roku od 20 sekundi.
Koja ograničenja agent mora da poštuje?
Meta-ova, i ona su ista preko svakog provajdera. Agent koji ih unapred zna izbegava greške koje izgledaju kao bagovi:
- 20 poruka u sekundi po broju, koje Meta određuje za brojeve koji se dele sa aplikacijom WhatsApp Business.
- Poruke koje se kucaju samo u roku od 24 sata od poslednje poruke kupca; posle toga, odobreni šablon.
- Šabloni se šalju samo preko API-ja, jer aplikacija na Coexistence broju ne može da ih šalje.
- Odgovori koje osoba ukuca u aplikaciji stižu kao
smb_message_echoes; pauzirajte agenta na tom četu, inače kupac dobija dva odgovora. - Grupni četovi se ne sinhronizuju sa API-jem, pa agent radi u razgovorima jedan na jedan.
- Kontakti i do 6 meseci razgovora jedan na jedan uvoze se jednom, samo ako je direktna webhook destinacija sačuvana u roku od 24 sata od povezivanja; broj sa uključenim automatizacijama ne dobija uvoz.
- Glasovni i video pozivi rade i dalje u aplikaciji, ali Cloud API ne prenosi pozive na Coexistence broju, pa agent radi u tekstu.
Mogu li platforme da povezuju brojeve svojih kupaca na ovaj način?
Da, preko Partner API-ja, što je način na koji SaaS ili agencija uvodi svoje kupce bez sopstvenog statusa Tech Provider. Kreirajte ključ pomoću create_api_key (počinje sa ec_live_ i prikazuje se jednom), zatim pozovite POST /api/v1/connect-sessions sa vašeg backenda, ili create_connect_link iz asistenta, za hostovani link važeći 1 sat. Kupac tamo pokreće Metin iskačući prozor i skenira QR kod, pa se vraća na vaš redirect_url sa connection_id. Zatim GET /api/v1/connections/:id?credentials=1 vraća sopstveni token kupca, a događaji statusa, poput connection.disconnected, stižu potpisani sa X-EC-Signature. Svaki broj se naplaćuje vašem nalogu po istim pojasevima po broju.
Česte greške
- Validiranje X-Hub-Signature-256 na direktnoj destinaciji. Meta potpisuje tajnim ključem aplikacije easyCoexistence, koji se nikada ne deli, pa autentični događaji ne prolaze proveru; oslonite se na dugi nasumični tajni ključ u URL-u ili koristite prosleđivanje sa X-EC-Signature.
- Prijem preko čvora WhatsApp Trigger u n8n-u. On očekuje sopstvenu Meta aplikaciju; koristite generički čvor Webhook sa tajnim ključem u URL-u.
- Ignorisanje smb_message_echoes. Agent tada odgovara preko osobe koja je već odgovorila sa telefona, pa kupac čita dva odgovora.
- Čuvanje direktne webhook destinacije danima posle povezivanja ili ostavljanje broja sa automatizacijama. Metin jednokratni uvoz kontakata i do 6 meseci četova traži direktnu destinaciju sačuvanu u roku od 24 sata od povezivanja.
Agent radi preko više od 30 MCP alata ili preko kredencijala i webhookova svakog broja, a svaki broj se nadgleda 24/7 uz upozorenja. US$ 9 do US$ 0.75 po broju mesečno, uz pad cene kako dodajete brojeve, i prvih 3 dana besplatno.
Često postavljana pitanja
Treba li mi sopstvena Meta aplikacija?
Ne. Broj se uvodi preko Meta aplikacije easyCoexistence i ostaje u sopstvenom Business Portfolio i u WhatsApp Business nalogu firme. Vaš kod šalje sa tokenom firme iz get_api_credentials, pa vaša aplikacija nije uključena, osim ako je kasnije sami ne napravite.
Mogu li agent i tim da koriste broj istovremeno?
Da. Meta preslikava poruke između Cloud API-ja i aplikacije WhatsApp Business, pa ono što agent pošalje stiže u niz četa u aplikaciji na telefonu, a ono što tim ukuca u aplikaciji stiže u vaš sistem kao smb_message_echoes.
Koji okviri za agente rade sa ovim?
Svaki klijent koji govori MCP preko HTTP-a sa OAuth-om, kao što su ChatGPT, Claude, Claude Code, Codex i Cursor, i svaki kod koji poziva Metin Graph API: Node.js, Python, n8n, LangChain, OpenAI Agents SDK ili Vercel AI SDK. API ispod je Metin sopstveni, pa u agentu nema ničeg vlasničkog.
Da li je AI asistent opšte namene dozvoljen na WhatsAppu?
Meta-ovi Business Solution Terms, odeljak 4.7, zabranjuju provajderima AI asistenata opšte namene da ih nude preko WhatsApp Business Platform tamo gde je AI primarna funkcionalnost, kako Meta odredi, a pravilo važi od 15. januara 2026. Firma koja koristi AI za sopstvene kupce, za podršku, prodaju ili rezervacije nije meta tog pravila, a regulatori u EU i Brazilu naložili su Meti da obustavi ili vrati pravilo za rivalske asistente.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na