Registra en el panel un endpoint HTTPS de tu sistema para recibir las devoluciones.
Webhooks de estado
Recibe en tu sistema el estado de los mensajes de WhatsApp.
Configure una URL para recibir eventos estandarizados de creación, entrega, lecturas y errores, y consulte el historial de entregas a través de la API independientemente de la conexión elegida.
Flujo
WPP Marketing notifica a su sistema cuando cambia el estado.
Los webhooks de estado son útiles para auditoría, conciliación, paneles internos, soporte y reglas en su propio sistema.
Active solo los estados que su sistema necesite procesar para evitar ruido operativo.
La creación, entrega, lectura o error se normalizan de la misma manera, independientemente de la conexión elegida.
Tu endpoint procesa el payload y el historial de entregas queda disponible en el panel y en GET /webhooks.
Eventos disponibles y consulta de entregas.
Los cuatro eventos usan el mismo contrato en cualquier conexión, y la API permite consultar el resultado de cada intento de entrega.
POST
MESSAGE_CREATED
El mensaje se creó en el flujo y recibió un identificador para seguimiento.
Criação
POST
MESSAGE_DELIVERED
El mensaje se entregó al destinatario cuando el canal devuelve confirmación.
Entrega
POST
MESSAGE_READ
El mensaje fue leído cuando la confirmación de lectura está disponible.
Leitura
POST
MESSAGE_ERROR
El mensaje encontró un error al enviar, validar o procesar.
Erro
GET
/webhooks
Consulta el historial de entregas con estado, intentos, respuesta HTTP y paginación. Requiere el scope webhooks:read.
Logs
Buenas prácticas
Prepara tu endpoint para recibir eventos repetidos y fuera de orden.
Los webhooks son entregas entre sistemas. Tu backend debe responder rápido, registrar logs y procesar con idempotencia.
Use una URL segura, pública y estable para recibir los eventos de retorno.
Responda con HTTP 200 o 204 después de recibir el evento y procese las tareas de larga duración en una cola interna.
Use identificadores de mensaje y de evento para evitar duplicados en reenvíos.
Registrar payload, fecha, estado HTTP y resultado del procesamiento para auditoría.
Use MESSAGE_ERROR para alertar a asistencia o la operación sobre fallas devueltas por cualquier conexión.
Los webhooks de estado son respuestas de WPP Marketing. Para enviar eventos comerciales de la tienda, use la Events API.
¿Quieres monitorear entregas y errores en tu sistema?
Configura una URL en el panel, elige los estados y sigue las entregas en el informe de webhooks.