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.
El webhook informa el resultado de un mensaje; no es una solicitud de envío. Use el Messaging API para enviar mensajes y el Events API para activar automatizaciones con eventos comerciales compatibles.
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.
Registre una URL HTTPS pública y habilite los eventos en el panel. El contrato actual no envía una firma HMAC; configure la protección y validación adecuadas para el receptor sin asumir una firma que no existe.
Responda con un HTTP 2xx en hasta 15 segundos y procese tareas de larga duración en una cola interna. No se siguen redirecciones.
Use el id del evento, también enviado en Webhook-Id, para evitar el procesamiento duplicado y aceptar eventos fuera de orden. Webhook-Attempt indica el número de intento. Solo se registran y envían los eventos habilitados.
Consulte intentos y respuestas HTTP en GET /webhooks con webhooks:read. Los registros completados, entregados o con fallo definitivo se conservan durante 30 días. Proteja los datos personales y el contenido de los mensajes en sus propios registros.
Fallas de conexión, timeouts y respuestas 408, 425, 429 o 5xx pueden generar hasta siete intentos en total, con intervalos de 1, 5 y 15 minutos, y 1, 6 y 24 horas. Se respeta Retry-After hasta 24 horas. Otros errores 4xx detienen la entrega.
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.