Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Cum adăugați WhatsApp într-un SaaS cu Embedded Signup și Coexistence

Un SaaS adaugă WhatsApp conectând fiecare număr existent al clientului prin Embedded Signup de la Meta, cu Coexistence, astfel încât numărul continuă să funcționeze în aplicația WhatsApp Business. Cu Partner API de la easyCoexistence, o sesiune de conectare per client rulează acest flux pe o pagină găzduită, Meta livrează mesajele numărului către webhook_url, iar backendul răspunde prin Cloud API cu token-ul propriu al clientului.

20 mps

Debitul fix al unui număr folosit atât cu aplicația WhatsApp Business, cât și cu Cloud API.

2.24.17

Cea mai veche versiune a aplicației WhatsApp Business cu care poate fi conectat numărul unui client prin Coexistence.

180 days

Cât de departe în timp merge istoricul conversațiilor pe care Meta îl poate partaja la onboarding; trebuie sincronizat în 24 de ore.

24 hours

Fereastra de serviciu pentru clienți WhatsApp după un mesaj sau un apel al utilizatorului; fiecare mesaj nou o resetează.

October 15, 2026

Data la care Meta a retras Embedded Signup v2 și v3, integrările fiind mutate la v4.

Care sunt componentele unei integrări WhatsApp?

Cinci, iar easyCoexistence preia prima și ultima. Produsul dumneavoastră păstrează logica conversației, inbox-ul și ce scriu modelul dumneavoastră sau personalul clienților, în timp ce Meta transportă mesajele între număr și serverul dumneavoastră:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Ce schimbă Coexistence pentru clienții dumneavoastră?

Își păstrează numărul și telefonul. Aplicația WhatsApp Business continuă să funcționeze alături de Cloud API, astfel că personalul răspunde de pe telefon, în timp ce produsul dumneavoastră răspunde prin API, iar ce trimit din aplicație ajunge la webhook-ul dumneavoastră ca smb_message_echoes. Vin cu trei limite: numărul trimite la un debit fix de 20 de mesaje pe secundă, doar API-ul poate trimite template-uri, iar Meta deconectează numărul când telefonul rămâne inactiv circa 14 zile.

Cum arată pasul de conectare în produsul dumneavoastră?

Un buton „Connect WhatsApp” care apelează POST /connect-sessions din backend cu un redirect_url, id-ul clientului ca external_ref și webhook_url cu webhook_verify_token, astfel că Meta direcționează numărul către dumneavoastră din primul minut. Clientul confirmă o listă scurtă de verificare pe pagina găzduită, rulează fereastra pop-up a Meta, scanează un cod QR cu aplicația WhatsApp Business și revine la dumneavoastră cu un connection_id. Dacă rulați Embedded Signup din propria aplicație Tech Provider, este explicat în ghidul Embedded Signup.

Cum ajung mesajele la backend?

De la Meta, direct către webhook_url, fără oprire la easyCoexistence și fără copie păstrată. Câmpul messages transportă ce trimit clienții și starea mesajelor dumneavoastră, iar smb_message_echoes transportă ce trimite personalul din aplicație. Meta semnează fiecare livrare cu secretul aplicației easyCoexistence, care nu este niciodată partajat, astfel că un secret lung și aleatoriu în calea URL-ului o autentifică. Două numere dintr-un același WhatsApp Business Account partajează o destinație: rutați după value.metadata.phone_number_id.

Cum răspunde backendul și trimite template-uri?

Cu Graph API de la Meta și token-ul clientului din GET /connections/{id}?credentials=1, care returnează și send_endpoint. Textul liber pleacă în 24 de ore de la ultimul mesaj al persoanei; după aceea, doar un template aprobat de Meta:

  • Răspuns: POST /<PHONE_NUMBER_ID>/messages cu type text, în fereastră.
  • Template: același apel cu type template, numele template-ului și codul său de limbă.
  • Crearea unui template: POST /<WABA_ID>/message_templates, apoi interogați periodic starea, deoarece rezultatele revizuirii nu ajung la webhook_url.
  • Media: POST /<PHONE_NUMBER_ID>/media pentru încărcare; media primită sosește ca ID, de preluat cu același token.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Poate produsul dumneavoastră să importe conversațiile existente ale clientului?

Odată, la conectare. Cu un webhook_url setat pe sesiune, easyCoexistence cere Meta să trimită contactele numărului și, dacă clientul este de acord în aplicație, până la 180 de zile de conversații, care sosesc ca webhook-uri smb_app_state_sync și history. Meta permite asta doar în 24 de ore de la conectare, așa că endpoint-ul trebuie să răspundă înainte ca linkul să fie trimis. Ghidul despre istoricul conversațiilor descrie payload-urile.

Cine plătește Meta pentru mesaje?

Clientul dumneavoastră. Meta facturează mesajele pe care backendul dumneavoastră le trimite prin API către WhatsApp Business Account al clientului, pe o metodă de plată pe care clientul o adaugă acolo, iar o firmă fără metodă de plată nu poate trimite template-uri de marketing. easyCoexistence vă taxează contul per număr conectat, nu taxează mesajele și nu adaugă niciun adaos la prețurile Meta.

Ce se întâmplă când un număr se pierde?

Adresa pentru evenimente primește connection.disconnected cu motivul Meta, când motivul este cunoscut. PRIMARY_INACTIVITY este regula de 14 zile, iar o nouă sesiune de conectare pentru acel client readuce același număr. connection.token_missing înseamnă că numărul s-a conectat fără token-ul clientului, deci primește mesaje, dar nu poate trimite până când o nouă sesiune îl reconectează.

Greșeli frecvente

  • Trimiteți linkul de conectare înainte ca endpoint-ul webhook-ului dumneavoastră să răspundă. Importul istoricului rulează o singură dată, în 24 de ore de la conectare, iar conținutul trimis înainte ca adresa dumneavoastră să funcționeze se pierde.
  • Răspundeți cu text liber după ce fereastra s-a închis. Odată ce trec 24 de ore de la ultimul mesaj al persoanei, trece doar un template aprobat.
  • Trimiterea unei campanii dintr-un singur număr la viteză maximă. Un număr Coexistence trimite cu 20 de mesaje pe secundă, deci puneți în coadă trimiterile fiecărui număr la acest debit.
  • Așteptarea ca personalul să trimită template-uri de pe telefon. În Coexistence doar API-ul le trimite, deci plasați trimiterea template-urilor în produsul dumneavoastră.
Faceți acest lucru cu EasyCoexistence

easyCoexistence adaugă WhatsApp în SaaS-ul dumneavoastră cu Embedded Signup de la Meta și Coexistence, pe o pagină găzduită care afișează numele dumneavoastră: clienții își păstrează numărul și aplicația WhatsApp Business, Meta livrează mesajele către serverul dumneavoastră, iar evenimentele semnate ajung la dumneavoastră. Același API conectează Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale. US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Poate un client să conecteze un număr aflat la alt furnizor de API WhatsApp?

Nu cât timp este acolo. Lista de verificare găzduită cere un număr fără alt furnizor de API sau instrument de automatizare, deci clientul îl deconectează mai întâi de la acel furnizor.

Poate SaaS-ul meu să trimită template-uri WhatsApp pentru clienții săi?

Da, prin Cloud API cu token-ul fiecărui client: creați template-ul în WhatsApp Business Account al clientului, așteptați revizuirea Meta, apoi trimiteți-l.

Citește easyCoexistence mesajele WhatsApp ale clienților mei?

Nu. Meta livrează mesajele unui număr direct la webhook_url setat de dumneavoastră. Un număr fără webhook_url revine la callback-ul easyCoexistence, unde mesajele sunt eliminate fără a fi stocate.

Cât costă easyCoexistence per număr WhatsApp?

US$ 9 până la US$ 0.75 pe număr pe lună, în funcție de banda totalului conexiunilor dumneavoastră, cu primele 3 zile gratuite. Taxele Meta pentru mesaje merg în contul WhatsApp Business al fiecărui client.

Continuați să citiți

API unificat pentru rețele sociale în SaaS: o singură integrare pentru WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canaleIntegrare pentru WhatsApp, Instagram, Facebook, TikTok, YouTube și LinkedIn ale clienților: ce este unificat, ce decide fiecare rețea și apelurile.Cum adăugați postări TikTok în SaaS-ul dumneavoastrăAdăugați postări TikTok în SaaS-ul dumneavoastră: conectați contul fiecărui client, publicați acum sau mai târziu și urmăriți fiecare postare până la publicare.API multi-client pentru social media: o cheie API, conturile multor cliențiO cheie API pentru conturile de social media și WhatsApp ale clienților: etichetați fiecare cont cu external_ref, separați token-urile și rutați webhook-urile.WhatsApp Embedded Signup pentru clienții dumneavoastră: propria aplicație Tech Provider sau o pagină găzduităCum conectează un SaaS numerele WhatsApp ale clienților prin Coexistence: ce cere Meta unui Tech Provider, ce preia o pagină găzduită și ce văd clienții.Cum importați istoricul conversațiilor și contactele din aplicația WhatsApp Business prin APIImportați contactele și conversațiile din ultimele 180 de zile prin Coexistence: webhook-uri de istoric, chunk_order, progres și codul 2593109.Fereastra de 24 de ore pentru serviciul cliențiCe este fereastra pentru clienți, când se deschide și se închide, ce puteți trimite în interior sau în afara ei și de ce răspunsurile din interior sunt gratuite.

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la