Entregas
Cada vez que Dashboard Mágico manda un evento a un endpoint, registra una entrega: lo que se envió, lo que respondió tu sistema y cuántos intentos se hicieron. Con eso descubres por qué un aviso no llegó y reenvías lo que falló.
Dónde verlas
En la pestaña Webhooks de Sistema › API (/dashboard/api?tab=webhooks):
- la tarjeta Delivery Logs, debajo de la lista de endpoints, muestra las entregas de todos los endpoints del workspace;
- el número en la columna Deliveries de un endpoint abre solo las entregas de ese endpoint.
En los Delivery Logs, filtra por Date, Status y Webhook, y usa el botón de actualizar para traer las entregas más recientes. Cada fila muestra:
| Columna | Qué es |
|---|---|
| Date | Cuándo se creó la entrega. |
| Webhook | La URL del endpoint. |
| Event | El tipo de evento, como api_key.revoked. |
| Status | En qué punto está la entrega (mira abajo). |
| HTTP | El código con que respondió tu sistema, en verde cuando es 2xx. |
| Attempts | Cuántas veces se intentó el envío. |
Estados
| Estado | Qué significa |
|---|---|
| Pending | En la cola, todavía sin enviar. |
| Delivered | Tu sistema respondió con un código 2xx en hasta 30 segundos. |
| Failed | Tu sistema respondió con otro código, tardó más de 30 segundos o no se pudo alcanzar. |
Ver los detalles de una entrega
Haz clic en el ícono de ojo de la fila para abrir los detalles:
- el estado, el código HTTP y el mensaje de error, cuando lo hubo;
- los headers y el cuerpo de la solicitud que envió Dashboard Mágico — las credenciales de autenticación aparecen enmascaradas;
- los headers y el cuerpo de la respuesta de tu sistema (hasta 10.000 caracteres).
Si la solicitud ni siquiera llegó a su destino (dirección fuera de servicio, tiempo agotado), la respuesta aparece como Sin respuesta.
Nuevos intentos
Cuando una entrega falla, Dashboard Mágico lo intenta de nuevo por su cuenta, con un intervalo que se duplica en cada intento. Cada intento cuenta para la desactivación automática: después de 10 fallas seguidas, el endpoint se apaga (mira Webhooks).
Para reenviar una entrega que terminó como Failed, haz clic en el botón de reenviar de la fila (Retry). La entrega vuelve a la cola y se envía de nuevo, con los mismos datos.
:::tip El mismo evento puede llegar más de una vez
Por los nuevos intentos y el reenvío manual, tu sistema puede recibir el mismo evento dos veces. Usa el header X-Kobana-Event-Id para procesar cada evento una sola vez.
:::