La sección Datos de logs Webhook te permite auditar y operar cada llamada enviada por Pandapé a tus endpoints: ver su estado, filtrar por fecha o tipo de evento, reenviar un intento de forma individual o varios intentos de forma masiva, y confirmar el resultado de cada reenvío.
Este artículo aborda los siguientes temas:
Cómo acceder
- En tu cuenta de Pandapé ATS, ve a Configuración.
- En Otras configuraciones, entra a Webhooks y APIs.
- En la tarjeta Últimas 10 Solicitudes de Webhook, haz clic en Ver más para abrir el listado completo de logs.
Qué puedes consultar y gestionar
En esta sección puedes revisar el historial de llamadas de webhook, entender qué muestra cada columna, aplicar filtros para acotar resultados y abrir el detalle de cada intento para diagnóstico o reenvío.
Columnas de la tabla (qué significa cada una)
- Código de estado: resultado de la entrega según familias HTTP (p. ej., Informativo, Exitoso, Error del servidor, etc.). Consulta la tabla de Significado de los estados HTTP más abajo.
- Nombre: alias que asignaste al webhook. Al hacer clic sobre él, se abre el detalle completo del intento.
- Tipo: evento que disparó la llamada (p. ej., Se completó el cuestionario).
- URL: endpoint HTTPS de tu sistema al que Pandapé envía la notificación (p. ej., https://api.tuempresa.com/webhooks/candidatos).
- Fecha: momento en que se realizó el intento.
Consejos
- Revisa el detalle del log: haz clic en el Nombre (en azul) para abrir la ficha completa. Verás: Código de estado, Tipo de webhook, URL llamada, Fecha y hora, Headers enviados, Cuerpo (JSON enviado) y Respuesta del endpoint.
- Si necesitas reenviar: usa esta información para validar el endpoint, el token y el cuerpo del mensaje antes del reintento. Para el paso a paso, consulta Reenvío de webhooks.
Filtros clave (para encontrar rápido)
- Rango de fechas: limita el período a revisar (p. ej., últimos 7 días).
- Todos los eventos: muestra solo un evento concreto (p. ej., Candidato cambió de etapa en una oferta).
- Todos los estados: filtra por familias HTTP (p. ej., 4XX para detectar errores de autenticación o URL).
- Buscar: texto libre por nombre del webhook, parte de la URL, etc.
- Mostrar: ajusta cuántos registros ver por página.
Reenvío de webhooks
El reenvío permite volver a enviar cualquier llamada de webhook (haya fallado o haya sido exitosa), sin rehacer la configuración. Es útil cuando el sistema receptor perdió la información, corregiste una integración y quieres reprocesar el evento, o necesitas evidencias para auditoría.
Antes de reenviar, aplica filtros para acotar (rango de fechas, estados, tipo de evento) y enfocarte en los intentos de tu interés que deseas reenviar.
Nota
- Registro original: el log original nunca se modifica ni se borra; es el registro histórico del intento tal como ocurrió.
- Nuevos logs por reenvío: cada reenvío genera un nuevo log con su fecha y estado resultante, manteniendo la trazabilidad completa.
Reenvío individual:
En cada fila, haz clic en el icono ↻ Reenviar para repetir la llamada a la misma URL con el mismo cuerpo y parámetros del intento original.
Reenvío masivo:
- Selecciona varias filas con las casillas de verificación (o usa Seleccionar todo).
- Abre el menú de selección ▾ y elige Reenviar Webhooks.
- Confirma el reenvío. Esta acción enviará un reintento por cada fila seleccionada.
Significado de los estados HTTP
Cada webhook enviado desde Pandapé recibe una respuesta del sistema receptor en forma de código HTTP, que indica si la entrega fue exitosa o si se produjo algún error.
A continuación, encontrarás una guía rápida con el significado de cada familia de códigos:
Etiqueta |
Código de estado (HTTP) |
Descripción |
| 1XX – Informativo | Indica que la solicitud fue recibida y se está procesando. Es una respuesta temporal del servidor. | |
| 2XX – Exitoso | El webhook se entregó correctamente y el endpoint receptor respondió de forma satisfactoria. | |
| 3XX – Redireccionamiento | La solicitud fue redirigida a otra URL. Puede requerir ajustar la dirección del endpoint. | |
| 4XX – Error del cliente | El error proviene del sistema receptor (por ej., token inválido, URL incorrecta o falta de permisos). | |
| 5XX – Error del servidor | El servidor del sistema receptor tuvo un fallo interno. Reintenta cuando el servicio esté disponible. |