Register an HTTPS endpoint from your system in the dashboard to receive callbacks.
Status webhooks
Receive WhatsApp message statuses in your system.
Configure a URL to receive queue, creation, delivery, read, error, number-not-found, expiration, and logout events.
Flow
WPP Marketing notifies your system when the status changes.
Status webhooks are useful for auditing, reconciliation, internal dashboards, support, and rules in your own system.
Enable only the statuses your system needs to consume to avoid operational noise.
Delivery, read, error, expiration, invalid number or logout are detected in the operation.
The endpoint processes the payload, logs the event, and updates its own dashboard or internal rule.
Available return events.
These statuses help your system know what happened after a message entered the WhatsApp flow.
POST
QUEUE
Message entered the processing queue.
Fila
POST
MESSAGE_CREATED
Message was created in the flow and received an identifier for tracking.
Criação
POST
MESSAGE_DELIVERED
Message was delivered to the recipient when the channel returns confirmation.
Entrega
POST
MESSAGE_READ
Message was read when read receipt is available.
Leitura
POST
MESSAGE_ERROR
Message encountered an error during sending, validation, or processing.
Erro
POST
LOGOUT
WhatsApp connection was terminated and may require action from operations.
Conexão
Best practices
Prepare your endpoint to receive repeated and out-of-order events.
Webhooks are deliveries between systems. Your backend should respond quickly, log requests, and process idempotently.
Use a secure, public, and stable URL to receive callbacks.
Respond with HTTP 200 or 204 after receiving the event and process long-running tasks in an internal queue.
Use message and event identifiers to prevent duplication on redeliveries.
Log payload, date, HTTP status, and processing result for auditing.
Use error events, number not found and logout to alert support or operations.
Status webhooks are responses from WPP Marketing. To send store commercial events, use the Events API.
Want to track deliveries and errors in your system?
Configure a webhook URL in the dashboard and choose which statuses should be sent back to your application.