WhatsApp API pentru agenți AI: acces oficial în câteva minute, fără a deveni Tech Provider
Un agent AI primește acces oficial la WhatsApp prin Cloud API de la Meta, iar un număr care rămâne în aplicația WhatsApp Business se integrează printr-un Tech Provider sau Solution Partner. Puteți deveni unul, cu verificarea afacerii, videoclipuri pentru App Review și un flux Embedded Signup, sau vă puteți conecta printr-un furnizor care deja este unul: numărul se alătură în câteva minute, iar agentul primește instrumente MCP sau credențiale API.
easyCoexistence este un Tech Provider independent al Meta: conectează un număr WhatsApp Business la Cloud API prin Coexistence în câteva minute, astfel încât agentul dumneavoastră primește acces oficial, iar firma păstrează aplicația.
Ce cere Meta de la cel care integrează un număr care rămâne în aplicația WhatsApp Business: statutul de Tech Provider sau Solution Partner.
App Review cere un videoclip cu un mesaj trimis din aplicație și unul cu aplicația creând un template.
Ce acordă App Review pentru whatsapp_business_messaging și whatsapp_business_management, ambele necesare pentru a deveni Tech Provider.
Când Meta a depreciat Embedded Signup v2 și v3, cerând integrărilor să treacă la v4.
Debitul fix al unui număr folosit atât în aplicația WhatsApp Business, cât și în Cloud API.
Cât timp rămâne valid un link de conectare găzduit atunci când o platformă integrează numărul unui client prin Partner API.
De ce are nevoie un agent AI ca să folosească WhatsApp oficial?
Patru lucruri din Cloud API de la Meta. Un ID al numărului de telefon și un token de acces cu permisiunea whatsapp_business_messaging, ca agentul să poată apela endpoint-ul de mesaje. Un endpoint de webhook unde Meta livrează mesajele primite, plus, pe un număr partajat cu aplicația, smb_message_echoes pentru răspunsurile pe care o persoană le scrie din telefon. Template-uri aprobate, pentru că un mesaj cu text liber ajunge doar la cineva care a scris în ultimele 24 de ore. Și o modalitate de a afla când conexiunea se rupe, deoarece aplicația de pe telefon continuă să funcționeze când partea API se oprește.
Scurtătura pe care o găsesc oamenii primii este automatizarea WhatsApp Web, care se autentifică drept dispozitiv conectat. Aceasta încalcă termenii WhatsApp și pune numărul în pericol de blocare, indiferent ce face agentul de deasupra.
Ce presupune ruta Tech Provider?
Secvența proprie a Meta, în această ordine. Fiecare pas este gratuit, iar niciunul nu poate fi cumpărat mai repede: verificările au loc după programul Meta, iar Meta nu publică niciun termen, așa că planificați săptămâni, nu zile, înainte ca numărul primului client să se conecteze. După aceea, partea de backend trebuie să ruleze permanent: schimbul de token după fiecare înscriere, un receptor de webhook, rutarea pe număr și monitorizarea deconectărilor, cum este regula Meta a inactivității de 14 zile.
Care este ruta mai scurtă?
Conectați numărul printr-un furnizor care a parcurs deja acest proces. Cu easyCoexistence, firma rulează Embedded Signup de la Meta și scanează un cod cu aplicația WhatsApp Business, ceea ce durează aproximativ două minute, iar numărul se alătură Cloud API în propriul Business Portfolio, în timp ce aplicația continuă să funcționeze. Agentul primește apoi acces în forma pe care o acceptă: instrumente MCP pentru un asistent precum ChatGPT, Claude, Claude Code sau Codex, sau credențialele și webhook-urile numărului pentru codul pe care îl rulați.
| 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 |
Cum primește agentul credențialele numărului?
Prin get_api_credentials sau de pe pagina numărului din panoul de control. Instrumentul returnează URL-ul de bază al Graph API, ID-ul contului WhatsApp Business, ID-ul numărului de telefon, endpoint-ul de trimitere și, când există unul, token-ul de acces propriu al firmei, limitat la activele sale WhatsApp. Când nu a fost emis niciun token al clientului, token-ul revine null, cu o notă care arată că reconectarea numărului din panoul de control emite unul, fără să înlocuiască un token care funcționează. Nu există niciun app secret de preluat, deoarece Meta semnează webhook-urile cu app secret-ul easyCoexistence, care nu este niciodată partajat. Instrumentul necesită un plan activ, pentru că token-ul poate trimite mesaje.
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." }
}'Cum ajung mesajele primite la agent?
Fiecare număr are două moduri, comutate cu set_inbound_mode sau din pagina numărului. Direct către serverul dumneavoastră: set_webhook_destination îndreaptă Meta direct către endpoint-ul dumneavoastră HTTPS, care trebuie să răspundă la verificarea GET a Meta, iar easyCoexistence nu vede niciodată mesajele, deci automatizările sunt dezactivate. Deoarece Meta semnează aceste livrări cu app secret-ul nostru, puneți un secret lung și aleatoriu în calea URL-ului și respingeți cererile fără el.
Automatizări active: Meta livrează către easyCoexistence, automatizările pot răspunde, iar un Forward URL opțional primește payload-ul original al Meta sub „value”, semnat cu X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 al „<t>.<body>”> folosind un secret afișat o singură dată. Pasul „Call my webhook” al unei automatizări îi transmite agentului și mesajul, precum și ultimele 10 mesaje ale conversației, iar răspunsul este trimis dacă serverul dumneavoastră răspunde cu {"reply": "..."} în 20 de secunde.
Ce limite trebuie să respecte agentul?
Limitele Meta, care sunt aceleași prin orice furnizor. Un agent care le cunoaște dinainte evită erorile care par bug-uri:
- 20 de mesaje pe secundă pe număr, stabilite de Meta pentru numerele partajate cu aplicația WhatsApp Business.
- Mesajele cu text liber doar în 24 de ore de la ultimul mesaj al clientului; după aceea, un template aprobat.
- Template-urile se trimit doar prin API, deoarece aplicația de pe un număr Coexistence nu le poate trimite.
- Răspunsurile scrise de o persoană în aplicație sosesc ca
smb_message_echoes; opriți agentul în acea conversație, altfel clientul primește două răspunsuri. - Conversațiile de grup nu sunt sincronizate cu API-ul, deci agentul lucrează în conversații unu-la-unu.
- Contactele și până la 6 luni de conversații unu-la-unu se importă o singură dată, doar dacă o destinație directă de webhook este salvată în 24 de ore de la conectare; un număr cu automatizări active nu primește importul.
- Apelurile vocale și video continuă să funcționeze în aplicație, dar Cloud API nu transportă apeluri pe un număr Coexistence, deci agentul lucrează în text.
Poate o platformă să conecteze numerele clienților săi în acest fel?
Da, prin Partner API, care este modul în care un SaaS sau o agenție își integrează clienții fără statut propriu de Tech Provider. Creați cheia cu create_api_key (începe cu ec_live_ și se afișează o singură dată), apoi apelați POST /api/v1/connect-sessions din partea de backend a dumneavoastră sau create_connect_link din asistent, pentru un link găzduit valabil 1 oră. Clientul rulează acolo fereastra Meta și scanarea codului QR și revine la redirect_url cu un connection_id. GET /api/v1/connections/:id?credentials=1 returnează apoi token-ul propriu al clientului, iar evenimentele de stare, precum connection.disconnected, sosesc semnate cu X-EC-Signature. Fiecare număr este facturat contului dumneavoastră la aceleași trepte de preț pe număr.
Greșeli frecvente
- Validarea X-Hub-Signature-256 pe o destinație directă. Meta semnează cu app secret-ul easyCoexistence, care nu este niciodată partajat, așa că livrările autentice eșuează la verificare. Verificați în schimb un secret lung și aleatoriu din URL sau folosiți redirecționarea cu X-EC-Signature.
- Primirea prin nodul WhatsApp Trigger din n8n. Acesta așteaptă propria aplicație Meta; folosiți în schimb nodul generic Webhook cu un secret în URL.
- Ignorarea smb_message_echoes. Agentul răspunde atunci peste o persoană care a răspuns deja de pe telefon, iar clientul citește două răspunsuri.
- Salvarea destinației directe de webhook la câteva zile după conectare sau lăsarea numărului pe automatizări. Importul unic al Meta, cu contactele și până la 6 luni de conversații, necesită o destinație directă salvată în 24 de ore de la conectare.
Agentul lucrează prin peste 30 de instrumente MCP sau prin credențialele și webhook-urile fiecărui număr, iar fiecare număr este monitorizat 24/7, cu alerte. US$ 9 până la US$ 0.75 pe număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Am nevoie de propria aplicație Meta?
Nu. Numărul este integrat prin aplicația Meta a easyCoexistence și rămâne în Business Portfolio și în contul WhatsApp Business al firmei. Codul dumneavoastră trimite cu token-ul propriu al firmei, de la get_api_credentials, deci nu este implicată nicio aplicație a dumneavoastră, decât dacă o construiți ulterior.
Pot agentul și echipa să folosească numărul în același timp?
Da. Meta oglindește mesajele între Cloud API și aplicația WhatsApp Business, deci ce trimite agentul apare în firul conversației din aplicația de pe telefon, iar ce scrie echipa în aplicație ajunge în sistemul dumneavoastră ca smb_message_echoes.
Ce framework-uri de agenți funcționează cu el?
Orice client care vorbește MCP peste HTTP cu OAuth, precum ChatGPT, Claude, Claude Code, Codex și Cursor, și orice cod care apelează Graph API al Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK sau Vercel AI SDK. API-ul de dedesubt este al Meta, deci nu există nimic proprietar în interiorul agentului.
Este permis un asistent AI generalist pe WhatsApp?
Secțiunea 4.7 din Business Solution Terms ale Meta interzice furnizorilor de asistenți AI generaliști să îi ofere pe WhatsApp Business Platform atunci când AI-ul este funcționalitatea principală, așa cum stabilește Meta, în vigoare din 15 ianuarie 2026. O firmă care folosește AI pentru clienții săi, pentru suport, vânzări sau rezervări nu este ținta, iar autoritățile de reglementare din UE și Brazilia au ordonat Meta să suspende sau să retragă regula pentru asistenții rivali.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la