Register an HTTPS endpoint of your system in the panel to receive responses.
Status webhooks
Receive WhatsApp message status in your system.
Configure a URL to receive queue events, creation, delivery, reading, errors, number not found, expiration, and logout.
Flow
WPP Marketing notifies your system when the status changes.
Status webhooks are useful for auditing, reconciliation, internal dashboards, support, and your own system rules.
Activate only the statuses your system needs to consume to avoid operational noise.
Delivery, read, error, expiration, invalid number, or logout are detected during operation.
The endpoint processes the payload, logs, and updates your own dashboard or internal rule.
Return events available.
These statuses help your system understand 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 destination when the channel returns confirmation.
Entrega
POST
MESSAGE_READ
Message was read when the read confirmation is available.
Leitura
POST
MESSAGE_ERROR
Message encountered a sending, validation, or processing error.
Erro
POST
LOGOUT
WhatsApp connection was closed and may require operation action.
Conexão
Good practices
Prepare your endpoint to receive repeated and out-of-order events.
Webhooks are deliveries between systems. Your backend should respond quickly, log events, and process with idempotency.
Use a secure, public, and stable URL to receive return events.
Respond with HTTP 200 or 204 after receiving the event and process long tasks in the internal queue.
Use message and event identifiers to avoid duplication in re-deliveries.
Record payload, date, HTTP status, and processing results for auditing.
Use error events, not found numbers, and logout to alert support or operations.
Status webhooks are returns from WPP Marketing. To send commercial events from the store, use Events API.
Want to track deliveries and errors in your system?
Configure a webhook URL on the dashboard and choose which statuses should return to your application.