Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

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.

Începeți perioada de probă gratuită3 zile gratuite. Nu se percepe nimic până la finalul perioadei de probă.
+1 415 555 0188
Aplicația WhatsApp BusinessEchipa răspunde de pe telefon, ca înainte
Cloud APISistemele dumneavoastră sau un asistent AI, pe aceeași linie
Ambele interfețe văd aceeași conversație. Ce trimite API-ul apare în aplicație, iar ce scrie echipa în aplicație sosește ca eveniment smb_message_echoes, așa că software-ul nu răspunde niciodată peste un om care a răspuns deja.
Mesaje nestocate în mod implicitAplicația Business + Cloud APIMCP pentru Claude și ChatGPTGata în 2 minute

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.

ÎnainteUn număr, o singură alegere
Păstrați aplicația

Echipa răspunde de pe telefon. Nimic nu poate fi automatizat, integrat sau măsurat.

Fără API
Migrați la API

Software-ul poate accesa numărul. Aplicația Business nu mai funcționează pe el, iar echipa trece la alte instrumente.

Fără aplicație
AcumUn număr, ambele
Un singur număr
Aplicația WhatsApp BusinessCloud API

Meta 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.

Păstrează telefonulO firmă cu un singur număr

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.

Multe numere, un singur contO agenție, o firmă de consultanță sau un dezvoltator

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.

  1. 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.

    Necesită
    Un endpoint HTTPS care returnează hub.challenge la cererea GET trimisă de Meta
    Durată
    Aproximativ un minut
    Obțineți
    O destinație pe care Meta o poate verifica în momentul în care numărul se conectează
    Încă nu este nimic conectat. Aici se decide unde vor ajunge mesajele.
    Furnizor pe traseuStocate pe serverele lor
    Meta
    Platforma lorPrimește și stochează mesajele
    DumneavoastrăO copie, după programul lor
    EasyCoexistenceDoar configurare
    Meta
    Endpoint-ul dumneavoastrăÎncă neverificat
    NoiSetăm ruta, nu suntem pe ea
  2. Parcurgeț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.

    Necesită
    Acces la Business Portfolio și telefonul cu numărul
    Durată
    Două până la trei minute
    Obțineți
    Cloud API atașat unui număr pe care aplicația încă îl folosește
    Apare a doua interfață. Prima nu este eliminată.
    După o migrareO singură interfață
    Numărul
    Doar Cloud APIAplicația Business nu mai funcționează pe acest număr
    După CoexistenceDouă interfețe
    Numărul
    Aplicația WhatsApp BusinessAceleași conversații și același istoric
    Cloud APIPe aceeași linie
  3. Direcț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.

    Necesită
    Endpoint-ul de la pasul unu, acum verificat de Meta
    Durată
    Aplicat imediat ce se încheie onboarding-ul
    Obțineți
    Mesaje livrate de la Meta la dumneavoastră, fără noi pe calea mesajelor
    Ce evenimente merg unde după ce override-ul este activ.
    Evenimente operaționaleLivrate către noi
    account_updateSchimbări ale stării conexiunii
    phone_number_quality_updateCalitate și throughput
    account_review_updateRezultatele verificărilor
    Calea mesajelorLivrate către dumneavoastră
    messagesTot ce trimite un client
    smb_message_echoesCe trimite echipa din aplicație
    Serverul dumneavoastrăDirect, niciodată prin noi
  4. Menț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.

    Necesită
    Aplicația deschisă din când în când pe dispozitivul principal
    Durată
    Continuu
    Obțineți
    O conexiune supravegheată și o rută care rezistă la o reconectare
    Ce restabilește singură o reconectare și ce trebuie repus.
    Restabilite de MetaAutomat
    TrimitereaCloud API funcționează din nou
    Evenimente operaționaleMonitorizarea se reia
    Pierdute odată cu aplicațiaTrebuie reaplicat
    Override-ul webhook-ului dumneavoastrăDezinstalat odată cu aplicația
    Livrarea 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.
Text liberîntre 0 și 24 de ore după ultimul lor mesajDoar templatedupă aceea, până când scriu din nou
Ceasul repornește de fiecare dată când clientul trimite ceva. Aceasta este regula care strică integrările în producție, pentru că testarea are loc întotdeauna la câteva secunde după un mesaj, când textul liber încă funcționează.

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ă.

Livrate direct la endpoint-ul dumneavoastrăCalea mesajelor. În mod implicit, nu trece niciodată prin noi.
  • messagesTot ce trimite un client către număr
  • smb_message_echoesCe trimite echipa dumneavoastră din aplicația WhatsApp Business
Livrate către noiCalea operațională. Din asta este făcută monitorizarea.
  • account_updateStarea conexiunii: eliminată, offboarded, reconectată, restricționată
  • phone_number_quality_updateSchimbări ale calificativului de calitate și ale throughput-ului
  • account_alertsAlerte pe care Meta le ridică pentru cont
  • account_review_updateRezultatele unei verificări Meta
  • business_capability_updateSchimbări ale limitei de mesaje și ale capabilităților
  • phone_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.

Numărul a fost deconectatWebhook, sursă autoritară

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.

Conexiunea a fost inactivă paisprezece zileStare separată

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.

Ruta webhook-ului dumneavoastră a dispărut la o reconectareReaplicat automat

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.

Token-ul de acces a încetat să funcționezeDouă token-uri, un singur răspuns

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.

Calitatea a scăzutInterogat periodic

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.

2 minutes

Timpul obișnuit pentru conectarea unui număr prin scanarea unui cod din aplicația WhatsApp Business.

24 hours

Cât timp rămâne deschisă sesiunea pentru răspunsuri cu text liber.

20 msg/s

Volumul de trimitere pentru un număr Coexistence, stabilit de Meta și imposibil de mărit.

6 months

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ă.

Continuați să citiți