Cum le permiteți utilizatorilor să conecteze conturile WhatsApp, Instagram și TikTok la aplicație
Pentru a le permite utilizatorilor să conecteze conturi WhatsApp, Instagram și TikTok la aplicația dumneavoastră, creați o sesiune de conectare prin Partner API-ul easyCoexistence și trimiteți utilizatorul la URL-ul găzduit. Acolo, acesta conectează un număr WhatsApp prin Embedded Signup-ul Meta sau se autentifică în Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, apoi revine la redirect_url cu noul id de conexiune sau de canal. Link-urile sunt valabile o oră.
Cât timp funcționează un link de conectare; după aceea sesiunea apare ca expirată și este nevoie de una nouă.
Câte sesiuni de conectare poate ține deschise simultan un cont, alături de limita de 100 de sesiuni noi pe oră.
O sesiune este creată, deschisă, conectată, anulată sau expirată, așa cum arată GET /connect-sessions/:id.
Cel mai lung URL de callback alternativ pe care Meta îl acceptă pentru a trimite webhook-urile de mesaje ale unui număr WhatsApp în altă parte.
Cum funcționează un link de conectare?
Ca o pagină de finalizare a comenzii. Backend-ul dumneavoastră creează o sesiune, interfața trimite clientul la URL-ul ei, clientul se conectează pe o pagină de la easycoexistence.com, iar browserul revine la redirect_url. Apoi backend-ul confirmă rezultatul și preia credențialele noii conexiuni, toate cu cheia dumneavoastră API.
Ce conține cererea?
Un corp JSON trimis la https://easycoexistence.com/api/v1/connect-sessions, cu cheia dumneavoastră API ca token Bearer. Doar redirect_url este obligatoriu:
redirect_url: un URL https la care ajunge clientul ulterior.- channel: whatsapp, implicit, sau o rețea socială deschisă contului dumneavoastră, după numele ei cu litere mici, precum instagram, tiktok sau youtube.
external_ref: id-ul dumneavoastră pentru acest client, de până la 200 de caractere.partner_name: numele afișat pe pagina găzduită, de până la 80 de caractere; implicit, numele contului dumneavoastră.webhook_urlîmpreună cuwebhook_verify_token: doar pentru numere și întotdeauna împreună. Meta livrează acolo mesajele numărului din momentul conectării.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'Ce primiți înapoi?
Un răspuns 201 cu sesiunea. Trimiteți clientul la url și păstrați id-ul, care începe cu cs_, pentru a căuta sesiunea mai târziu. expires_at se stabilește la o oră după creare, iar connection_id sau channel_id se completează după ce clientul se conectează, în funcție de canalul sesiunii. GET /connect-sessions/:id returnează aceeași structură oricând.
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}Ce erori poate returna crearea unei sesiuni?
Fiecare eroare are același corp, un obiect cu un code și un message, iar message spune ce trebuie corectat. Crearea unei sesiuni poate returna:
- 400
invalid_jsonsauinvalid_request: corpul nu este un obiect JSON sau un câmp nu a trecut validarea, de exemplu unredirect_urlcare nu este https. - 400
channel_unavailable: canalul nu este deschis acestui cont; message enumeră cele care sunt. - 401 unauthorized: cheia API lipsește sau este invalidă.
- 402
billing_required: contul nu are încă un card, iar tot ce este conectat prin el se facturează pe acesta. - 429
cap_reached: sunt deja deschise 50 de sesiuni; așteptați să se termine sau să expire câteva. - 429
rate_limited: mai mult de 100 de sesiuni în această oră; message spune cât trebuie să așteptați.
Unde ajunge clientul după aceea?
Pe redirect_url, cu rezultatul adăugat în șirul de interogare. Același rezultat apare pe sesiune, pe care backend-ul dumneavoastră îl citește cu GET /connect-sessions/:id:
- session: id-ul sesiunii, cs_ urmat de caractere aleatorii.
- status: connected sau cancelled, când clientul a ales Anulare și revenire.
external_ref: id-ul dumneavoastră pentru client, dacă sesiunea l-a avut.connection_id: id-ul noului număr, pentru /connections.channel_id: id-ul noului cont social, pentru /channels.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…Ce statusuri poate avea o sesiune?
Cinci. GET /connect-sessions/:id arată statusul curent, împreună cu opened_at, finished_at și last_error, care spune de ce a eșuat ultima încercare:
- created: creată de backend-ul dumneavoastră, încă nedeschisă.
- opened: clientul a încărcat pagina găzduită.
- connected: un număr sau un cont social s-a conectat, iar id-ul său apare în sesiune.
- cancelled: clientul a plecat prin Anulare și revenire.
- expired: ora s-a scurs înainte ca sesiunea să se termine.
Cât timp funcționează un link?
O oră de la creare. După aceea, pagina găzduită îi spune clientului că link-ul a expirat, cu un buton înapoi către redirect_url marcat status=cancelled, iar sesiunea apare ca expirată. Un cont poate avea 50 de sesiuni deschise și poate crea 100 pe oră, deoarece Meta numără fiecare proces de înscriere pentru prima dată în raport cu o limită la nivel de aplicație, comună tuturor conturilor.
Ce face external_ref?
Leagă fiecare conexiune de clientul dumneavoastră. Valoarea trimisă este stocată pe numărul sau canalul creat de sesiune, adăugată la redirecționare și inclusă în fiecare eveniment de status despre el, astfel încât GET /connections?external_ref=customer_4821 și GET /channels?external_ref=customer_4821 listează ce a conectat acel client. O autentificare Facebook sau LinkedIn poate aduce mai multe pagini Facebook deodată: redirecționarea numește prima, iar filtrul listează restul. Folosiți un id stabil din baza dumneavoastră de date, nu un e-mail care se poate schimba.
Ce se întâmplă dacă clientul anulează sau autentificarea eșuează?
Depinde de unde s-a întâmplat, iar sesiunea păstrează înregistrarea:
- Fereastra Meta eșuează sau este închisă: clientul apasă din nou Connect pe aceeași pagină, cât timp link-ul este deschis.
- Autentificarea socială este anulată sau refuzată: clientul revine la pagina găzduită cu motivul și poate încerca din nou până expiră link-ul.
- Contul este deja conectat printr-un alt cont easyCoexistence:
last_errorspune asta, iar clientul se autentifică cu altul. - Clientul alege Anulare și revenire:
redirect_urlprimește status=cancelled, iar sesiunea se închide, deci creați una nouă pentru o altă încercare. - Link-ul a expirat: creați o sesiune nouă.
Ce se întâmplă dacă un număr se conectează fără token-ul clientului?
Meta termină uneori Embedded Signup-ul fără să emită token-ul propriu de business al clientului. Pagina găzduită cere atunci încă o rulare, care durează câteva secunde. Dacă clientul o omite, sesiunea apare ca connected cu token_ready false, iar URL-ul dumneavoastră de evenimente primește connection.token_missing: numărul primește mesaje, pentru că id-urile sale sunt valide, dar nu poate trimite până când o nouă sesiune de conectare îl reconectează și emite token-ul.
Ce se întâmplă dacă webhook_url nu trece verificarea Meta?
Numărul se conectează oricum. Meta verifică un webhook_url printr-un handshake GET, pe care endpoint-ul dumneavoastră îl trece reflectând hub.challenge atunci când hub.verify_token corespunde. Dacă eșuează, last_error de pe sesiune începe cu webhook_url was not applied și dă motivul Meta, iar PUT /connections/:id/webhook stabilește destinația după ce endpoint-ul răspunde. Dacă este setat în 24 de ore de la conectare, mai primește importul unic al contactelor și, dacă clientul a fost de acord să-l partajeze, istoricul conversațiilor.
Ce vede clientul?
O pagină pe easycoexistence.com cu numele dumneavoastră din partner_name și fără cont, e-mail sau card de completat. Pentru un număr WhatsApp, apare o scurtă listă de verificare a eligibilității, apoi fereastra Meta și un cod QR de scanat cu aplicația WhatsApp Business. Pentru un cont social, apare un singur buton, de exemplu Continuă cu TikTok, care deschide ecranul de consimțământ al rețelei în aceeași filă, deci funcționează și pe telefoane.
Greșeli frecvente
- Încrederea doar în șirul de interogare. Oricine poate scrie status=connected într-un URL, deci confirmați cu GET /connect-sessions/:id din backend înainte de a marca clientul ca fiind conectat.
- Încorporarea link-ului într-un iframe. Trimiteți clientul la el printr-o redirecționare sau o filă nouă, cum sunt concepute să funcționeze pagina găzduită și autentificările pe care le deschide.
- Crearea link-urilor din timp. Fiecare funcționează o oră, iar fiecare deschis se numără în limita de 50, deci creați sesiunea când clientul este pe punctul de a se conecta.
- Trimiterea unui webhook_url mai lung de 200 de caractere. Meta acceptă URL-uri de callback alternative de până la 200 de caractere, deci unul mai lung nu se aplică, iar numărul se conectează fără el.
easyCoexistence conectează numerele WhatsApp ale clienților dumneavoastră și conturile lor de Instagram, Facebook, TikTok, YouTube și LinkedIn, plus alte canale, la software-ul dumneavoastră printr-un singur link găzduit. Apoi oferă backend-ului dumneavoastră credențialele fiecărei conexiuni, webhook-urile și evenimentele de status semnate. De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile de probă gratuită.
Întrebări frecvente
Poate fi folosit un link de conectare de două ori?
Nu. Un link se termină cu un număr sau cu o autentificare socială, care pe Facebook sau LinkedIn poate aduce mai multe pagini. După aceea apare ca connected, deci creați o sesiune nouă pentru următoarea conexiune.
Pot trimite link-ul prin e-mail sau chat?
Da, cu condiția ca clientul să-l deschidă în decurs de o oră. Id-ul sesiunii din URL este cel care autorizează pagina, deci trimiteți fiecare link doar clientului pentru care a fost creat.
Funcționează pagina găzduită pe telefoane?
Autentificările sociale da, pentru că se deschid în aceeași filă. Un număr WhatsApp se conectează cel mai bine de pe un computer: pe telefon, fereastra Meta se deschide ca filă nouă, iar telefonul este necesar pentru scanarea codului QR.
Cum aflu că un client s-a conectat fără a interoga periodic?
Setați un URL pentru evenimente de status în panoul de control, la Profile, Developers. easyCoexistence trimite apoi connection.connected sau channel.connected, semnate și cu external_ref, imediat ce conexiunea este făcută.
Continuați să citiți
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