whatsapp.echo_message.* for its message echoes. WhatsApp Business App uses whatsapp.smb.* for coexistence synchronization. Use the event’s exact type to select the matching guide.
Before handling events, configure your webhook endpoint, validate the signature, and make processing idempotent.
Messages
Handle WhatsApp and SMS inbound messages, WhatsApp marketing preferences, and delivery updates for WhatsApp, Email, SMS, and Voice.Message status
Handle WhatsApp message statuses and Email, SMS, and Voice delivery updates.
Inbound messages
Parse WhatsApp message types, SMS replies, and WhatsApp marketing preferences.
Messenger
Use these events for ordinary one-to-one text messages, text edits, and message reactions on your connected Facebook Page.Messenger inbound text
Receive customer text messages and correlate repeated notifications by message ID.
Messenger inbound text edits
Update the same inbound message with corrected text and cumulative edit facts.
Messenger message updates
Handle saved submission and receipt snapshots, including unknown outcomes.
Messenger message reactions
Handle customer reactions and withdrawals without changing message delivery status.
Meta Business Agent
These events belong to Meta Business Agent onboarded through the Public REST API. Console-created Agents use a separate Inbox synchronization flow. See the Meta Business Agent guide for setup and lifecycle details.Echo message created
whatsapp.echo_message.created: Store outbound text and media from a Meta Business Agent.Echo message updated
whatsapp.echo_message.updated: Track delivery, read, and failure statuses for Meta Business Agent messages.Control handover
whatsapp.meta_business_agent.handover.updated: Handle Meta Business Agent control transfers.WhatsApp Business App
Use these examples for WhatsApp Business App coexistence: synchronize app history and messages sent from the app or a supported companion device.Business App history
whatsapp.smb.history: Synchronize historical inbound and outbound Business App messages.Business App message echoes
whatsapp.smb.message.created and whatsapp.smb.message.echoes: Synchronize messages sent from WhatsApp Business App or a supported companion device.Templates and accounts
Template events
Handle template reviews, category changes, Direct Send category detection, and quality updates.
Accounts and phone numbers
Handle account reviews, updates and deletion, plus phone-number deletion, display names, quality, and Business Usernames.
Calling
Call connect
Handle SDP offers and answers for WhatsApp calls.
Call status
Handle ringing, accepted, and rejected call states.
Call termination and capture
Handle call termination and asynchronous recording or transcription results.
Groups
Group lifecycle
Handle group creation and deletion.
Group participants
Handle participant and join-request changes.
Group settings
Handle group subject and description changes.
Group status
Handle group suspension and reinstatement.
Flows
Flow status
Process Flow lifecycle status changes.
Payments
Payment updates
Process WhatsApp payment transaction changes.
Contacts and opt-outs
Contact created
Process newly created contacts and notes.
Contact deleted
Reconcile deleted contacts and independently deleted notes.
Contact attributes changed
Process profile, custom attribute, tag, and note changes.
Contact unsubscribed
Handle newly created opt-out records.
Contact resubscribed
Handle deleted opt-out records.
Event index
Use the exact eventtype to open its walkthrough. Every event type in the current webhook schema has an example on an existing feature page.
Complete payload catalog
All webhook payloads
Find an event by its exact type and inspect its complete example payload.