Un singur număr.Aplicația și API-ul, în același timp.
Coexistence este modul oficial Meta pentru a folosi aplicația WhatsApp Business și Cloud API pe același număr, simultan. Echipa continuă să răspundă de pe telefon, cu aceleași conversații și același istoric, în timp ce software-ul trimite și primește mesaje pe aceeași linie.
EasyCoexistence conectează numărul, apoi monitorizează conexiunea.
Alegerea care exista odată și care nu mai există
Coexistence nu este un API nou. Este dispariția unei bifurcații care împiedica aproape orice firmă mică să automatizeze ceva.
Echipa răspunde de pe telefon. Nimic nu poate fi automatizat, integrat sau măsurat.
Fără APISoftware-ul poate accesa numărul. Aplicația Business nu mai funcționează pe el, iar echipa trece la alte instrumente.
Fără aplicațieMeta conectează Cloud API la un număr pe care aplicația WhatsApp Business încă îl folosește. Ambele interfețe sunt active pe aceeași linie și fiecare vede ce trimite cealaltă.
Cine folosește un număr în acest fel
Două grupuri care vor lucruri opuse de la aceeași funcție, motiv pentru care conexiunea contează mai mult decât orice dashboard construit peste ea.
O echipă mică, un număr scris pe o dubă sau pe o vitrină și seri petrecute răspunzând la aceleași patru întrebări. Nu înlocuiesc pe nimeni. Vor ca mesajele de confirmare, mementourile și primul răspuns după program să se întâmple fără un om, în timp ce telefonul funcționează în continuare pentru tot restul.
Mulți clienți, fiecare cu un număr pe care nimeni nu are voie să-l migreze sau să-l atingă. Au nevoie ca aceste numere să fie accesibile sistemelor pe care le construiesc și au nevoie să adauge următorul număr fără un apel de vânzări. Coexistence este singura cale oficială către un număr la care personalul clientului încă răspunde manual.
Cum ajunge un număr pe ambele și unde merg evenimentele de mesaje
Patru pași. Singurul care atinge telefonul este o scanare, iar pasul care vă decide arhitectura este primul.
Pregătiți endpoint-ul înainte de începerea onboarding-ului
Meta verifică o destinație înainte să livreze ceva acolo. Apelează URL-ul dumneavoastră cu un GET care conține hub.mode=subscribe, hub.verify_token setat de dumneavoastră și un hub.challenge, iar endpoint-ul trebuie să returneze challenge-ul brut, neschimbat.
Destinația trebuie să folosească HTTPS, iar un verify token este obligatoriu. Le validăm pe amândouă înainte de apel, așa că un URL greșit eșuează la noi, în loc să pară conectat și să nu livreze nimic.
Încă nu este nimic conectat. Aici se decide unde vor ajunge mesajele. Furnizor pe traseuStocate pe serverele lorPlatforma lorPrimește și stochează mesajeleDumneavoastrăO copie, după programul lorEasyCoexistenceDoar configurareEndpoint-ul dumneavoastrăÎncă neverificatNoiSetăm ruta, nu suntem pe eaParcurgeți Embedded Signup de la Meta și scanați în aplicație
Se deschide fereastra Meta. Alegeți Business Portfolio, WhatsApp Business Account și numărul deja înregistrat în aplicația WhatsApp Business, apoi aprobați conexiunea pe telefon scanând un cod.
Tot aici alegeți dacă partajați istoricul de conversații existent. Este o alegere unică, făcută în timpul onboarding-ului, și nu mai poate fi schimbată ulterior. Aplicația Business continuă să funcționeze imediat ce scanarea se încheie.
Apare a doua interfață. Prima nu este eliminată. După o migrareO singură interfațăDoar Cloud APIAplicația Business nu mai funcționează pe acest numărDupă CoexistenceDouă interfețeAplicația WhatsApp BusinessAceleași conversații și același istoricCloud APIPe aceeași linieDirecționați evenimentele de mesaje către propriul sistem
Meta permite unei aplicații să schimbe locul în care sunt livrate webhook-urile unui anumit WhatsApp Business Account. Setăm acest override la URL-ul dumneavoastră, ceea ce mută cele două câmpuri ale căii mesajelor, messages și smb_message_echoes, direct de la Meta la dumneavoastră.
Păstrăm câmpurile operaționale, pentru că din ele este făcută monitorizarea: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update și phone_number_name_update. Astfel, dashboard-ul rămâne util, iar conținutul conversațiilor nu trece niciodată pe la noi.
Ce evenimente merg unde după ce override-ul este activ. Evenimente operaționaleLivrate către noiCalea mesajelorLivrate către dumneavoastrămessagesTot ce trimite un clientsmb_message_echoesCe trimite echipa din aplicațieServerul dumneavoastrăDirect, niciodată prin noiMențineți conexiunea activă și treceți cu bine de o reconectare
Meta deconectează un număr Coexistence după aproximativ paisprezece zile fără activitate pe dispozitivul principal. Această deconectare se poate reconecta, iar noi o înregistrăm ca stare separată, nu o tratăm ca pe un client care pleacă.
Partea care îi prinde pe mulți nepregătiți este efectul unei deconectări asupra rutei. Meta stochează destinația ca override pe abonamentul aplicației noastre la cont, așa că un PARTNER_REMOVED dezinstalează aplicația și ia override-ul cu ea. Reconectarea restabilește trimiterea și monitorizarea, dar nu și destinația dumneavoastră. O repunem automat, pentru că primul număr care a atins această regulă s-a reconectat fără probleme și a încetat în tăcere să mai livreze către serverul clientului.
Ce restabilește singură o reconectare și ce trebuie repus. Restabilite de MetaAutomatTrimitereaCloud API funcționează din nouEvenimente operaționaleMonitorizarea se reiaPierdute odată cu aplicațiaTrebuie reaplicatOverride-ul webhook-ului dumneavoastrăDezinstalat odată cu aplicațiaLivrarea mesajelor către dumneavoastrăSe oprește în tăcereÎl reaplicăm noiLa fiecare reconectare
De ce echipele folosesc un număr în acest fel
- Păstrați numărul care este deja tipărit pe dube, bonuri și pe site, precum și fluxul de lucru de pe mobil din jurul lui.
- Adăugați trimitere prin API, procesare de webhook-uri și template-uri fără să mutați pe nimeni într-un instrument nou.
- Țineți traficul de mesaje în afara inboxului partajat al unui furnizor, astfel încât conversațiile să nu stea pe platforma altcuiva.
- Oferiți unei agenții o modalitate de a ține numerele multor clienți într-un singur cont, fiecare conectat în Business Portfolio al propriului client.
Eligibilitate și limite practice
- Numărul trebuie să fie deja activ în aplicația WhatsApp Business. Un număr din aplicația WhatsApp obișnuită trebuie mutat mai întâi acolo.
- Partajarea istoricului de conversații existent este o alegere unică, făcută în timpul onboarding-ului, și nu mai poate fi schimbată ulterior.
- Conversațiile de grup sunt excluse din API pe numerele Coexistence, la orice furnizor.
- Dispozitivul principal are nevoie de activitate periodică. Meta deconectează conexiunea după aproximativ paisprezece zile fără activitate.
- Căile de verificare și de obținere a insignei Meta diferă pentru numerele Coexistence, iar disponibilitatea regională se schimbă odată cu politica Meta.
Ce direcționăm către dumneavoastră și ce păstrăm
Meta permite unei aplicații să schimbe locul în care un WhatsApp Business Account își livrează webhook-urile. Setăm acest override la URL-ul dumneavoastră, ceea ce împarte evenimentele în două.
messagesTot ce trimite un client către numărsmb_message_echoesCe trimite echipa dumneavoastră din aplicația WhatsApp Business
account_updateStarea conexiunii: eliminată, offboarded, reconectată, restricționatăphone_number_quality_updateSchimbări ale calificativului de calitate și ale throughput-uluiaccount_alertsAlerte pe care Meta le ridică pentru contaccount_review_updateRezultatele unei verificări Metabusiness_capability_updateSchimbări ale limitei de mesaje și ale capabilitățilorphone_number_name_updateAprobări și respingeri ale numelui afișat
Dacă un număr nu are setat niciun override, evenimentele sale de mesaj ajung la callback-ul nostru implicit, unde handler-ul le aruncă fără să le salveze. Acest lucru este impus în cod, nu promis într-o politică: nu există nicio cale de stocare pe care conținutul conversațiilor să o poată urma.
Regula celor paisprezece zile și ce strică ea fără ca nimeni să o spună
Meta deconectează o conexiune Coexistence după aproximativ paisprezece zile fără activitate pe dispozitivul principal. Se poate reconecta, așa că o înregistrăm ca stare separată, nu ca pe un client care a plecat.
Consecința care costă apare mai târziu. Destinația mesajelor dumneavoastră nu este o setare a numărului, ci un override pe abonamentul aplicației noastre la WhatsApp Business Account. O deconectare dezinstalează aplicația, iar override-ul dispare odată cu ea. Reconectați, trimiterea funcționează, monitorizarea funcționează, iar mesajele nu mai ajung la serverul dumneavoastră, fără ca ceva să raporteze o eroare.
Reaplicăm override-ul la fiecare reconectare. Acest comportament există pentru că s-a întâmplat: un număr a atins această regulă, s-a reconectat fără probleme și a încetat în tăcere să mai livreze mesaje.
Un handshake eșuat în acel moment, pentru că serverul dumneavoastră era căzut sau token-ul s-a schimbat, este înregistrat în cronologia conexiunii, iar destinația este păstrată, nu ștearsă, așa că este suficient să o salvați din nou pentru a rezolva problema.
Ce se strică în tăcere și cum aflăm
Aplicația WhatsApp Business continuă să funcționeze în aproape toate defecțiunile de mai jos, motiv pentru care nimeni nu observă. Acestea sunt cele pe care le verificăm și modul în care o facem.
Detectat din webhook-ul account_update al Meta, mai exact PARTNER_REMOVED, nu dedus dintr-un câmp care devine false. În mod deliberat nu citim is_on_biz_app pentru asta, pentru că este în mod legitim false pe numerele care nu sunt Coexistence și genera deconectări false.
Regula Meta privind inactivitatea dispozitivului principal. Se poate reconecta, așa că este înregistrată ca stare separată, nu ca un client care a plecat, iar reconectarea restabilește trimiterea și monitorizarea.
Destinația există ca override pe abonamentul aplicației noastre la cont, așa că o deconectare o dezinstalează. Trimiterea revine la reconectare, livrarea către serverul dumneavoastră nu. Reaplicăm override-ul de fiecare dată, pentru că un număr căruia i s-a întâmplat asta s-a reconectat fără probleme și a încetat în tăcere să mai livreze.
Păstrăm token-ul clientului și propriul nostru System User token pentru același cont. Când unul este respins, celălalt citește contul și stabilește care dintre cele două s-a stricat de fapt, așa că un token revocat nu mai arată ca un număr pierdut.
Interogată periodic de la Meta. Un calificativ RED marchează conexiunea ca degradată, iar calitatea, nivelul de mesagerie și nivelul de throughput sunt salvate la fiecare verificare, astfel încât un declin este vizibil înainte să coste o trimitere.
A conecta un număr și a supraveghea un număr sunt produse diferite. Al doilea este motivul pentru care există acesta.
Timpul obișnuit pentru conectarea unui număr prin scanarea unui cod din aplicația WhatsApp Business.
Cât timp rămâne deschisă sesiunea pentru răspunsuri cu text liber.
Volumul de trimitere pentru un număr Coexistence, stabilit de Meta și imposibil de mărit.
Cât istoric al conversațiilor sincronizează Meta cu API-ul când un număr se conectează prima dată.
Întrebări frecvente
Trebuie ca echipa mea să înceteze folosirea telefonului?
Nu. Acesta este întregul scop al Coexistence. Aplicația WhatsApp Business continuă să funcționeze pe același număr, cu aceleași conversații, iar API-ul rulează alături de ea.
Îmi voi pierde conversațiile existente?
Nu. Ele rămân în aplicație, iar Meta sincronizează aproximativ șase luni de istoric cu API-ul când numărul se conectează, astfel încât software-ul are context, în loc să pornească de la zero.
Pot anula conexiunea?
Da. Un număr poate fi deconectat, iar aplicația continuă să funcționeze ca înainte. Conectarea nu modifică permanent numărul.
Este același lucru cu API-urile WhatsApp neoficiale?
Nu, iar diferența stabilește dacă numărul rămâne activ. Coexistence este funcția oficială Meta pentru Cloud API. Gateway-urile neoficiale folosesc WhatsApp Web ca dispozitiv conectat, încalcă termenii și duc la suspendarea numerelor.
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ă3 zile gratuite. Nu se percepe nimic până la finalul perioadei de probă.