# Tus webhooks dejan de ser una caja negra.

> Inspecciona cada llamada de webhook que llega a Pocket Alert: cabeceras, payload, mensaje renderizado y motivo del fallo. Depura tus integraciones de webhooks con hasta un año de historial.

<!-- source: https://pocketalert.app/es/features/webhook-history -->

Última actualización: 2026-08-11

Cada llamada entrante registrada con sus cabeceras, payload, mensaje generado y resultado. Cuando una integración jura que envió la petición, puedes comprobarlo.

Documentación: https://info.pocketalert.app/api/webhooks/history.html

## Descubre qué llegó realmente

1. **Apunta un servicio a él** — Crea un webhook y apunta tu servicio a su URL, como harías normalmente.
2. **Abre el historial** — Abre el webhook en tu panel y entra en su historial.
3. **Expande la llamada** — Expande cualquier llamada para ver las cabeceras, el cuerpo, el mensaje generado y qué salió mal.

## Todo lo que un webhook fallido no te dice

Cuando una alerta no llega, la pregunta es siempre la misma: ¿el emisor realmente hizo la llamada y, si la hizo, qué salió mal en nuestro lado?

- **Un registro de cada petición** — Cada llamada registrada, de la más reciente a la más antigua, expandible en línea. Método, IP de origen, tamaño y tipo de contenido de un vistazo.
- **Cabeceras y payload completos** — Las cabeceras completas y el cuerpo sin procesar tal como llegaron, para que compares lo que un servicio dice que envía con lo que realmente envió.
- **Lo que produjo tu plantilla** — Consulta el mensaje que generó tu plantilla a partir del payload, junto al propio payload. Los errores de plantilla dejan de ser una suposición.
- **Motivos de fallo específicos** — Los fallos incluyen un motivo concreto: JSON no válido, un mensaje vacío por un %path% que falta o un webhook inactivo.
- **Redactado y cifrado** — Las cabeceras Authorization, cookie y clave de API se redactan antes de almacenarse, y los payloads se cifran en reposo con tu clave.
- **Filtra, pagina o descarga** — Filtra por resultado y navega por el historial en el panel, o descárgalo desde la API y analízalo tú mismo.

## Cómo funciona el historial de webhooks

    
Cada petición que llega a una de tus URL de webhook se registra antes de procesarse, y el resultado se añade cuando termina el procesamiento. Así ves las llamadas fallidas tan claramente como las exitosas, incluidas las llamadas a un webhook que desactivaste y olvidaste.

    
Abre un webhook en el panel y su historial estará ahí, del más reciente al más antiguo. Cada fila se expande para mostrar la query string, las cabeceras completas y el cuerpo con formato JSON. Los mismos datos están disponibles en la API REST, con filtros para `success` y `error`.

    
## Depurar una plantilla

    
El fallo más común no es un problema de red, sino un marcador `%path%` que apunta a un campo que el emisor no envía realmente. El historial muestra el payload sin procesar y el mensaje que generó tu plantilla uno al lado del otro, lo que suele hacer evidente la discrepancia en segundos.

    
## Privacidad

    
Los payloads suelen contener secretos, por eso se cifran en reposo con tu clave personal, y las cabeceras Authorization, cookie y clave de API se sustituyen por `[redacted]` antes de almacenarse. La retención va desde 7 días en el plan gratuito hasta un año completo en Large.

## Preguntas frecuentes

### ¿Qué se registra en cada llamada a un webhook?

Marca de tiempo, método HTTP, IP de origen, tipo de contenido, query string, cabeceras completas, el cuerpo sin procesar, el tamaño del payload, el mensaje que generó tu plantilla, si se creó una alerta, un motivo de fallo cuando no se creó y cuánto tardó el procesamiento.

### ¿Cuánto tiempo se guarda el historial de webhooks?

7 días en el plan gratuito, 30 en Starter, 90 en Medium y 365 en Large. Las llamadas más antiguas se eliminan automáticamente, al igual que las entradas más antiguas cuando un mismo webhook supera las 1.000 llamadas registradas.

### ¿Es seguro el payload almacenado?

Sí. Los payloads se cifran en reposo con tu clave personal, igual que el contenido de los mensajes, y las cabeceras Authorization, cookie y clave de API se sustituyen por [redacted] antes de almacenar nada.

### Un servicio dice que envió el webhook, pero no llegó nada. ¿Y ahora qué?

El historial te indica cuál es el caso. Si no hay ningún registro, el emisor nunca llegó a nosotros. Si una llamada aparece con error, verás el motivo: JSON no válido, un mensaje vacío por un %path% que no existe en el payload, o un webhook que estaba desactivado.

### ¿Dónde veo el historial?

Abre el webhook en tu panel y su historial estará ahí, del más reciente al más antiguo, con cada llamada expandible. También hay un endpoint REST si prefieres consultarlo de forma programática, con filtros para éxito y error.

### ¿Funciona el historial de webhooks en el plan gratuito?

Sí, con 7 días de retención. Si necesitas más tiempo, eso es lo que amplían los planes de pago.
