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

Câmpurile webhook WhatsApp și destinația lor

Un WhatsApp Business Account livrează evenimente sub forma unor câmpuri denumite. Două conțin date despre conversații și sunt trimise la endpoint-ul dumneavoastră. Șase conțin starea operațională și stau la baza monitorizării. Arhitectura depinde de această diferențiere.

  • Două câmpuri pentru mesaje, șase operaționale
  • Direcționarea se stabilește pentru fiecare cont
  • Câmpuri denumite, nu un payload generic
Începeți perioada de probă gratuită

Nimic de plătit timp de 7 zile. Anulați oricând.

Fără stocarea mesajelorAplicația Business + Cloud APIMCP pentru Claude și ChatGPTGata în 2 minute
2

Câmpurile pentru mesaje sunt messages și smb_message_echoes.

6

Câmpurile operaționale sunt păstrate pentru monitorizare.

1

Setarea se face pentru fiecare WhatsApp Business Account, ceea ce le separă.

Ce conține fiecare câmp?

messages conține tot ce trimite un client către număr: text, referințe media, răspunsuri și reacții. smb_message_echoes conține ce trimite echipa dumneavoastră din aplicația WhatsApp Business. Acest câmp există doar pe un număr Coexistence și permite software-ului să vadă răspunsurile unui om.

account_update conține starea conexiunii: PARTNER_REMOVED când aplicația este dezinstalată din cont, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED și evenimente privind restricții sau încălcări. phone_number_quality_update conține modificări ale calificativului de calitate și ale debitului. account_alerts conține alertele emise de Meta pentru cont, iar account_review_update conține rezultatul unei verificări.

business_capability_update conține modificări ale limitei și capacităților de mesagerie, iar phone_number_name_update conține aprobările și respingerile numelui afișat.

De ce contează separarea pentru arhitectură?

Pentru că stabilește dacă datele conversației ajung vreodată la un furnizor.

Suprascrierea trimite cele două câmpuri pentru mesaje direct de la Meta la endpoint-ul dumneavoastră. Cele șase câmpuri operaționale continuă către furnizor, ceea ce permite un dashboard și alerte fără ca cineva să păstreze mesaje.

De aceea, afirmația că mesajele nu sunt stocate poate fi structurală, nu doar o politică. Dacă aceste câmpuri sunt livrate în altă parte, nu există o cale de cod pe care să poată fi stocate. În cazul nostru, un cont fără suprascriere revine la callback-ul implicit, unde handler-ul elimină aceste evenimente fără să le persiste.

La ce câmpuri ar trebui să se aștepte handler-ul dumneavoastră?

Doar la cele două câmpuri pentru mesaje, dacă suprascrierea este setată. Este recomandat ca handler-ul să ignore orice altceva, în loc să eșueze.

Meta adaugă câmpuri în timp, iar structura unui payload poate primi chei noi fără avertisment. Un handler care verifică numele câmpului și ignoră ce nu recunoaște continuă să funcționeze. Unul care presupune o anumită structură eșuează la primul eveniment necunoscut.

Merită să tratați explicit și smb_message_echoes, nu să îl considerați zgomot. Fără el, software-ul nu știe că un om a răspuns deja, iar un client poate primi două răspunsuri la aceeași întrebare.

Greșeli frecvente

  • Presupunerea unui payload generic. Fiecare eveniment își indică numele câmpului, iar handler-ul trebuie să îl verifice.
  • Ignorarea smb_message_echoes. Fără el, software-ul răspunde peste un om care a răspuns deja.
  • Eșecul la câmpuri necunoscute în locul ignorării lor. Meta adaugă câmpuri fără să ceară aprobare.
Faceți acest lucru cu EasyCoexistence

EasyCoexistence abonează câmpurile operaționale pentru monitorizare și trimite cele două câmpuri pentru mesaje la endpoint-ul dumneavoastră sau le elimină fără persistență dacă nu ați setat unul.

Întrebări frecvente

Pot primi doar anumite câmpuri?

Suprascrierea mută traseul mesajelor către dumneavoastră. Separarea operațională este fixă, deoarece monitorizarea se bazează pe ea.

smb_message_echoes există pe un număr Cloud API obișnuit?

Nu. Există deoarece un număr Coexistence permite trimiterea manuală din aplicație, pe lângă trimiterea software din API.

Ce se întâmplă cu evenimentele mesajelor dacă nu setez nicio destinație?

Ajung la callback-ul nostru implicit și sunt eliminate fără să fie persistate.

Numele câmpurilor sunt ale Meta sau ale dumneavoastră?

Sunt ale Meta. Nu am inventat niciunul dintre aceste nume, de aceea merită să le învățați o singură dată.

Continuați să citiți

The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

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

Câmpurile webhook-ului WhatsApp