Webhook-uri WhatsApp: direcționați mesajele către serverul dumneavoastră
Un webhook WhatsApp este un endpoint HTTPS pe care îl desemnați, iar Meta trimite către el evenimente: mesaje primite, statusuri de livrare, schimbări de calitate și actualizări ale contului. Pentru un număr Coexistence, destinația poate fi setată la serverul dumneavoastră, astfel încât conversațiile să nu treacă niciodată printr-un furnizor.
- Meta trimite evenimente direct la URL-ul dumneavoastră
- Endpoint-ul dumneavoastră, nu platforma unui furnizor
- O singură suprascriere pentru fiecare WhatsApp Business Account
Nimic de plătit timp de 7 zile. Anulați oricând.
Ce reprezintă integrarea completă: o singură destinație HTTPS pentru fiecare cont.
messages și smb_message_echoes, evenimentele din fluxul mesajelor direcționate către dumneavoastră.
Valoarea trimisă de Meta în verificarea GET, pe care endpoint-ul dumneavoastră trebuie să o returneze identic.
Ce trimite de fapt Meta către un webhook?
Evenimente, împărțite pe categorii, iar diferența dintre ele determină arhitectura.
Fluxul mesajelor conține ceea ce trimit clienții și, pentru un număr Coexistence, ecourile mesajelor trimise de echipa dumneavoastră din aplicația WhatsApp Business. Acestea sunt câmpurile messages și smb_message_echoes și sunt cele care conțin conținutul conversațiilor.
Fluxul operațional conține tot restul: account_update când se schimbă starea unei conexiuni, phone_number_quality_update când se modifică nivelul de calitate sau capacitatea de trimitere, account_alerts, account_review_update, business_capability_update și phone_number_name_update. Acestea nu conțin conținut conversațional și stau la baza monitorizării.
Un furnizor care se plasează în fluxul mesajelor primește primul grup. Unul care nu se plasează acolo nu îl primește.
Cum verifică Meta un endpoint?
Printr-o cerere GET înainte de a livra orice, iar eșecul acestei verificări este cel mai frecvent motiv pentru care o configurare aparent finalizată nu primește niciun mesaj.
Meta apelează URL-ul dumneavoastră cu hub.mode setat la subscribe, cu hub.verify_token și cu o valoare hub.challenge. Endpoint-ul trebuie să returneze această valoare challenge ca text brut în corpul răspunsului, fără JSON și fără nimic adăugat. Dacă nu face acest lucru, Meta nu începe niciodată livrarea, iar niciun dashboard nu va indica problema.
Endpoint-ul trebuie să folosească și HTTPS. Un endpoint care returnează un 404 fără conținut sau unul aflat în spatele unui nivel de autentificare care respinge Meta arată identic cu o configurare funcțională până când primul mesaj nu mai ajunge.
Poate destinația să indice către serverul dumneavoastră?
Da, iar acesta este aspectul care diferă între furnizori.
Meta permite unei aplicații să suprascrie locul în care un anumit WhatsApp Business Account livrează webhook-urile. Setăm această suprascriere la URL-ul dumneavoastră, mutând evenimentele din fluxul mesajelor de la callback-ul nostru la al dumneavoastră. Păstrăm evenimentele operaționale, deoarece dashboard-ul și alertele sunt construite pe baza lor.
Consecința ține de arhitectură, nu de o politică pe care o publicăm. Conținutul conversațiilor nu are unde să fie stocat la noi, deoarece nu ne este livrat niciodată. Un cont fără o suprascriere setată revine la callback-ul nostru implicit, unde handler-ul elimină aceste evenimente fără să le persiste.
Ce se întâmplă cu destinația când un număr se reconectează?
Este eliminată, iar acesta este cazul la care aproape nimeni nu se gândește.
Destinația nu este o proprietate a numărului de telefon. Este o suprascriere a abonamentului aplicației noastre la WhatsApp Business Account. Când o conexiune este eliminată, din cauza regulii Meta privind inactivitatea timp de paisprezece zile sau din alt motiv, aplicația este dezinstalată din acel cont, iar suprascrierea dispare odată cu ea.
Reconectarea restabilește trimiterea și monitorizarea. Nu restabilește livrarea către serverul dumneavoastră și nimic nu raportează o eroare, astfel că primul semn poate fi un client care spune că nu i-a răspuns nimeni. Reaplicăm suprascrierea la fiecare reconectare, deoarece acest lucru s-a întâmplat unui număr real care s-a reconectat fără probleme, apoi a devenit silențios.
Greșeli frecvente
- Returnarea unui JSON la cererea GET de verificare. Meta dorește valoarea brută hub.challenge și nimic altceva.
- Folosirea unui URL temporar sau de test. Meta continuă să livreze către acesta după ce instrumentul care l-a generat încetează să asculte.
- Presupunerea că destinația supraviețuiește unei reconectări. Ea aparține unui abonament al aplicației și este dezinstalată odată cu acesta.
- Plasarea endpoint-ului în spatele unei autentificări care respinge cererea Meta.
EasyCoexistence setează suprascrierea webhook-ului la endpoint-ul dumneavoastră, o validează înainte de apel și o reaplică automat după orice reconectare. De la US$ 9 pe număr pe lună, până la US$ 2 la volum, cu primele 7 zile gratuite.
Întrebări frecvente
Trec mesajele mele prin EasyCoexistence?
Nu. Suprascrierea trimite evenimentele din fluxul mesajelor direct de la Meta la endpoint-ul dumneavoastră. Evenimentele unui cont fără suprascriere revin la callback-ul nostru și sunt eliminate fără persistență.
Pot schimba ulterior destinația?
Da, oricând, din dashboard sau prin conectorul MCP. Transmiterea valorii null o resetează la valoarea implicită.
Ce se întâmplă dacă serverul meu este indisponibil când Meta livrează?
Meta reîncearcă livrarea o perioadă, apoi se oprește. Mesajele ajung în continuare în aplicația WhatsApp Business de pe telefon, astfel încât firma nu pierde nimic, chiar dacă integrarea nu funcționează.
Este suficient un webhook pentru mai multe numere?
Da. Direcționați fiecare număr către același endpoint și diferențiați-le folosind phone number id-ul primit în payload.
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ăNimic de plătit timp de 7 zile. Anulați oricând.Verificat la