Register an HTTPS endpoint from your system in the dashboard to receive callbacks.
Status webhooks
Receive WhatsApp message statuses in your system.
Set up a URL to receive standardized events for creation, delivery, read receipts and errors, and check delivery history via the API regardless of the chosen connection.
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.
Creation, delivery, reading, or error are normalized the same way regardless of the connection selected.
Your endpoint processes the payload and the delivery history becomes available in the dashboard and via GET /webhooks.
Available events and delivery lookup.
All four events use the same contract on any connection, and the API allows querying the result of each delivery attempt.
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
GET
/webhooks
View delivery history with status, attempts, HTTP response, and pagination. Requires the webhooks:read scope.
Logs
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 MESSAGE_ERROR to alert support or operations about failures returned by any connection.
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?
Set up a URL in the dashboard, choose the statuses, and track deliveries in the webhooks report.