Registre en el panel un endpoint HTTPS de su sistema para recibir los retornos.
Webhooks de estado
Recibe en tu sistema el estado de los mensajes de WhatsApp.
Configura una URL para recibir eventos de fila, creación, entrega, lectura, error, número no encontrado, expiración y cierre de sesión.
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 de su propio sistema.
Active solo los estados que su sistema necesita consumir para evitar ruido operacional.
Entrega, lectura, error, expiración, número inválido o cierre de sesión son detectados en la operación.
El endpoint procesa el payload, registra los logs y actualiza su panel interno o regla interna.
Eventos de retorno disponibles.
Estos estados ayudan a su sistema a saber qué sucedió después de que un mensaje ingresó en el flujo de WhatsApp.
POST
QUEUE
El mensaje ingresó en la cola de procesamiento.
Fila
POST
MESSAGE_CREATED
El mensaje fue creado en el flujo y recibió un identificador para seguimiento.
Criação
POST
MESSAGE_DELIVERED
El mensaje fue entregado al destino 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 de envío, validación o procesamiento.
Erro
POST
LOGOUT
La conexión de WhatsApp fue cerrada y puede requerir acción de la operación.
Conexão
Buenas prácticas
Prepare su endpoint para recibir eventos repetidos y fuera de orden.
Los webhooks son entregas entre sistemas. Su backend debe responder rápidamente, registrar logs y procesar con idempotencia.
Use 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 tareas demoradas en una fila interna.
Use identificadores de mensaje y evento para evitar duplicidades en reentregas.
Registre payload, fecha, estado HTTP y resultado del procesamiento para auditoría.
Use eventos de error, número no encontrado y cierre de sesión para alertar soporte o operación.
Los webhooks de estado son el retorno de WPP Marketing. Para enviar eventos comerciales de la tienda, use Events API.
¿Quieres seguir entregas y errores en tu sistema?
Configura una URL de webhook en el panel y elige qué estados deben volver a tu aplicación.