Cómo investigar errores en los webhooks recibidos
El historial de un listener permite comprobar si la integración llegó a la plataforma y por qué no se ejecutó una acción. Por ejemplo, el gateway puede aprobar una compra y enviar el correo del comprador en un campo distinto del configurado.
Necesitas permiso para consultar y administrar esta función en tu plataforma.
En la plataforma, abre tu foto de perfil y elige el panel administrativo. Después sigue: Integraciones → Webhooks → Recibidos.
1Localiza el evento recibido
Busca el listener de la integración y abre su icono de registros. Filtra por el período de la compra y actualiza. La imagen muestra el punto de entrada; cada listener registrado tiene su propio historial. Los registros se conservan durante 30 días.
2Lee el motivo antes de corregir
Inactive webhook significa que el listener estaba inactivo. Payload does not satisfy listener criteria indica que los filtros no coincidieron. Email não encontrado no payload requiere revisar el mapeo del correo; Usuário não encontrado, el registro del miembro y la opción de crearlo. Compara el JSON recibido con el mapeo de la acción.
3Cruza las evidencias
Si no hay registros, revisa período, retención, historial del gateway y URL registrada. La ausencia de un registro no demuestra por sí sola que no se envió nada. Tras un resultado exitoso, comprueba esa acción específica: una notificación exitosa no demuestra que se asignó una insignia. Para el acceso, revisa también la insignia y su vencimiento.
Consejo
Copia la URL con el control del propio listener. Antes de reenviar un evento, consulta Qué revisar antes de reenviar un evento de integración: algunas acciones acumulan efectos.
Preguntas frecuentes
¿HTTP 200 garantiza la entrega?
No. Un listener inactivo o un filtro que no coincide puede responder 200 sin ejecutar la acción. Revisa el resultado del registro.