# I tuoi webhook smettono di essere una scatola nera.

> Ispeziona ogni chiamata webhook in arrivo su Pocket Alert: header, payload, messaggio generato e motivo dell'errore. Fai il debug delle integrazioni webhook con fino a un anno di cronologia.

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

Ultimo aggiornamento: 2026-08-11

Ogni chiamata in arrivo registrata con header, payload, messaggio generato ed esito. Quando un'integrazione giura di aver inviato la richiesta, puoi verificarlo.

Documentazione: https://info.pocketalert.app/api/webhooks/history.html

## Scopri cosa è arrivato davvero

1. **Configura un servizio** — Crea un webhook e configura il tuo servizio con il suo URL, come faresti normalmente.
2. **Apri la cronologia** — Apri il webhook nella dashboard e vai alla sua cronologia.
3. **Espandi la chiamata** — Espandi una chiamata per vedere header, body, messaggio generato e il motivo dell'errore.

## Tutto ciò che un webhook fallito non ti dirà

Quando un alert non arriva, la domanda è sempre la stessa: il mittente ha davvero effettuato la chiamata e, se sì, cosa è andato storto da parte nostra?

- **Un log di ogni richiesta** — Ogni chiamata registrata, dalla più recente, espandibile direttamente in pagina. Metodo, IP di origine, dimensione e content type a colpo d'occhio.
- **Header e payload per intero** — Gli header completi e il body grezzo esattamente come sono arrivati, così puoi confrontare ciò che un servizio dichiara di inviare con ciò che ha inviato davvero.
- **Ciò che ha prodotto il tuo template** — Vedi il messaggio generato dal tuo template a partire dal payload, accanto al payload stesso. Gli errori nei template smettono di essere un'ipotesi.
- **Motivi di errore specifici** — I fallimenti includono un motivo preciso: JSON non valido, un messaggio vuoto causato da un %path% mancante, oppure un webhook inattivo.
- **Oscurati e cifrati** — Gli header Authorization, cookie e chiave API vengono oscurati prima del salvataggio, e i payload sono cifrati a riposo con la tua chiave.
- **Filtra, sfoglia o recupera** — Filtra per esito e sfoglia la cronologia nella dashboard, oppure recuperala dalle API e analizzala come preferisci.

## Come funziona la cronologia dei webhook

    
Ogni richiesta che raggiunge uno dei tuoi URL webhook viene registrata prima di essere elaborata, e l'esito viene associato al termine dell'elaborazione. Vedi quindi i fallimenti con la stessa chiarezza dei successi, incluse le chiamate a un webhook che hai disattivato e dimenticato.

    
Apri un webhook nella dashboard e la sua cronologia è lì, dalla più recente, con ogni riga espandibile per mostrare la query string, gli header completi e il body con formattazione JSON. Gli stessi dati sono disponibili tramite l'API REST, con filtri per `success` e `error`.

    
## Fare debug di un template

    
Il fallimento più comune non è un problema di rete, ma un segnaposto `%path%` che punta a un campo che il mittente non invia davvero. La cronologia mostra affiancati il payload grezzo e il messaggio generato dal template, e di solito il disallineamento diventa evidente in pochi secondi.

    
## Privacy

    
I payload spesso contengono dati sensibili, quindi vengono cifrati a riposo con la tua chiave personale, e gli header Authorization, cookie e chiave API vengono sostituiti con `[redacted]` prima del salvataggio. La conservazione va da 7 giorni nel piano Free fino a un anno intero nel piano Large.

## FAQ

### Cosa viene registrato per ogni chiamata webhook?

Timestamp, metodo HTTP, IP di origine, content type, query string, header completi, body grezzo, dimensione del payload, il messaggio generato dal tuo template, se è stato creato un alert, il motivo del fallimento quando non è stato creato, e quanto tempo ha richiesto l'elaborazione.

### Per quanto tempo viene conservata la cronologia dei webhook?

7 giorni nel piano Free, 30 in Starter, 90 in Medium e 365 in Large. Le chiamate più vecchie vengono rimosse automaticamente, così come le più datate quando un singolo webhook supera le 1.000 chiamate registrate.

### Il payload salvato è al sicuro?

Sì. I payload sono cifrati a riposo con la tua chiave personale, come il contenuto dei messaggi, e gli header Authorization, cookie e chiave API vengono sostituiti con [redacted] prima di essere salvati.

### Un servizio dice di aver inviato il webhook ma non è arrivato nulla. E ora?

La cronologia ti indica quale dei due casi si è verificato. Se non c'è alcuna registrazione, il mittente non ci ha mai raggiunti. Se una chiamata è registrata con un errore, ottieni il motivo: JSON non valido, un messaggio vuoto causato da un %path% inesistente nel payload, oppure un webhook disattivato.

### Dove posso vedere la cronologia?

Apri il webhook nella tua dashboard: la cronologia è lì, dalla più recente, con ogni chiamata espandibile. È disponibile anche un endpoint REST, se preferisci recuperarla via programmatica, con filtri per successo ed errore.

### La cronologia dei webhook funziona nel piano gratuito?

Sì, con 7 giorni di conservazione. Se ti servono periodi più lunghi, è proprio ciò che offrono i piani a pagamento.
