Historial de eventos

BreezeAuth registra cada intento de entregar un evento a tus webhooks, haya tenido éxito o no. Puedes consultar estos registros en la consola de administración para confirmar que tu endpoint está recibiendo los eventos, o para averiguar por qué no.

Abrir el historial de eventos

Interpretar la lista

Cada fila es un intento de entrega, del más reciente al más antiguo:

Columna	Qué muestra
Evento	El tipo de evento, por ejemplo Membresía creada.
Intentos	Qué intento es esta fila: 1 intento para la entrega original, 2 intentos para el primer reintento, y así sucesivamente.
Estado	Exitoso si tu endpoint respondió 2xx en menos de 15 segundos, Fallido en caso contrario.
Creado el	Cuándo se hizo el intento.

Por tanto, un evento que falló y se reintentó aparece en varias filas, una por intento. Un evento entregado al primer intento aparece una sola vez, con 1 intento y Exitoso.

Detalles del intento

Selecciona una fila para abrir los detalles de ese intento:

Campo	Qué muestra
Intento	El número de intento (de 1 a 3).
Evento	El tipo de evento.
ID del evento	El identificador único del evento. Es la cabecera webhook-id y el campo uuid que recibió tu endpoint. Úsalo para encontrar el mensaje en tus propios registros. Todos los intentos del mismo evento lo comparten.
URL	La dirección a la que se envió este intento. Si la URL del webhook cambió entretanto, muestra la dirección que se usó entonces.
Estado	Exitoso o Fallido.
Código de error	En los intentos fallidos: el estado HTTP que devolvió tu endpoint, o un código de error de red. Consulta la tabla siguiente.
Mensaje de error	En los intentos fallidos: una descripción técnica del error.
Disparado el	Cuándo se hizo el intento.
Datos	El data del mensaje: los identificadores de los recursos implicados en el evento.

Errores habituales

Código de error	Qué significa	Qué hacer
301, 302, 307, 308	Tu endpoint respondió con una redirección, que BreezeAuth no sigue.	Actualiza el webhook con la URL final, normalmente la versión https:// o con barra final.
400, 401, 403	Tu endpoint rechazó el mensaje.	Revisa los registros del endpoint. Puede que esté fallando la comprobación de la firma o de la organización; consulta Verificar firmas.
404, 405	Nada en esa dirección acepta peticiones POST.	Revisa la ruta de la URL y que el endpoint acepte POST.
500, 502, 503, 504	Tu endpoint, o un proxy delante de él, ha tenido un error o no está disponible.	Revisa los registros y la disponibilidad del endpoint.
ECONNABORTED, ETIMEDOUT	No hubo respuesta en 15 segundos.	Responde primero y procesa en segundo plano. Consulta Recibir eventos de forma fiable. Si usas una lista de direcciones IP permitidas, comprueba que ningún cortafuegos esté descartando las direcciones de BreezeAuth.
ECONNREFUSED	El servidor rechazó la conexión: nada escucha en esa dirección y puerto, o un cortafuegos la rechazó.	Comprueba que el servicio está en marcha, que el puerto está abierto a internet y que las direcciones de BreezeAuth están permitidas.
ENOTFOUND	No se pudo resolver el nombre de dominio de la URL.	Busca erratas en la URL y revisa los registros DNS del dominio.
ECONNRESET	La conexión se cerró de forma inesperada.	Revisa los cortafuegos, balanceadores de carga y proxies entre internet y tu endpoint.
CERT_HAS_EXPIRED, DEPTH_ZERO_SELF_SIGNED_CERT, UNABLE_TO_VERIFY_LEAF_SIGNATURE	El certificado TLS del endpoint ha caducado, es autofirmado o está incompleto.	Instala un certificado válido de una autoridad de certificación pública, con la cadena intermedia.

Lista de diagnóstico

Si tu endpoint no recibe eventos:

• El webhook está Activado y suscrito al evento que esperas.
• El evento ocurrió realmente en esta organización.
• El Historial de eventos muestra intentos para el evento. Si no muestra ninguno, revisa los dos puntos anteriores.
• La URL es accesible desde internet, y no solo desde tu red interna.
• Si restringes el acceso por dirección IP, todas las direcciones de BreezeAuth están permitidas.
• La URL es la dirección final y no redirige.
• El endpoint responde 2xx en menos de 15 segundos.
• El endpoint verifica la firma usando el cuerpo sin procesar y la clave pública correcta.