# Fai in modo che le eccezioni arrivano sul tuo telefono.

> Ricevi come notifiche push le eccezioni di Sentry, Rollbar e Bugsnag. Punta il webhook del tuo error tracker a Pocket Alert e scopri i nuovi problemi in meno di un secondo.

<!-- source: https://pocketalert.app/it/use-cases/error-tracking-alerts -->

Ultimo aggiornamento: 2026-08-11

Quando Sentry, Rollbar o Bugsnag rilevano una nuova eccezione, titolo e gravità arrivano sul tuo telefono in meno di un secondo. Intercetta l'errore prima che i tuoi utenti lo segnalino.

## Tre passaggi per avere avvisi di errore sul telefono

1. **Crea un webhook** — Crea un webhook di Pocket Alert con un template di messaggio GJSON e copia il suo URL di ricezione.
2. **Collega lo strumento di monitoraggio** — Incolla l'URL in una Internal Integration di Sentry (o in un webhook di Rollbar/Bugsnag) e collegalo a una regola di avviso.
3. **Mappa e invia** — GJSON mappa data.event.title, culprit, level e web_url nella tua notifica push. L'eccezione successiva farà vibrare il tuo telefono.

## Dallo stack trace alla schermata di blocco

Il tuo strumento di monitoraggio degli errori invia già un webhook. Pocket Alert lo trasforma in una notifica push che non puoi perdere.

- **Funziona con ogni strumento di monitoraggio** — Sentry, Rollbar, Bugsnag, Honeybadger e Airbrake attivano tutti un webhook in uscita per ogni nuovo problema. Puntalo a Pocket Alert e hai finito.
- **Mappa i campi con GJSON** — I percorsi GJSON estraggono data.event.title, data.event.culprit e data.event.level direttamente dal payload e li inseriscono nella notifica.
- **Livello e regola nel messaggio** — Mostra il livello dell'errore e la regola attivata direttamente nella notifica push, così un'eccezione fatal appare diversa da un warning.
- **Un canale per ogni ambiente** — Ogni applicazione ha un proprio URL webhook, quindi produzione, staging e un servizio specifico restano in canali separati.
- **Consegna in meno di un secondo** — L'eccezione arriva al tuo telefono in meno di un secondo, molto prima del riepilogo via email.
- **URL webhook segreto** — L'URL webhook è il segreto della tua applicazione su HTTPS. Rigeneralo ogni volta che ti serve un endpoint nuovo.

## Invia avvisi di errore al tuo telefono

### 1. Crea un webhook di Pocket Alert

Nella pagina [Webhooks](https://pocketalert.app/it/webhooks) crea un webhook il cui template GJSON `message` legge il payload di avviso sui problemi di Sentry (tutto è annidato sotto `data.event`):

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sentry","default_level":"critical","message":"[%data.event.level%] %data.event.title%\n%data.event.culprit%\n%data.event.web_url%","application_id":"qm47b9pzxzxg"}'
```

Otterrai un URL in ingresso come `https://p4a.me/wh/1234abcd`.

### 2. Collega Sentry

In [Impostazioni → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/), imposta il Webhook URL sul tuo URL di ricezione e abilita la Alert Rule Action. Poi crea una regola di avviso sui problemi e aggiungi l'integrazione come azione:

```
Webhook URL:  https://p4a.me/wh/1234abcd
Permissions:  Issue & Event (Read)
Action:       Alert Rule Action — enabled

Alerts → Create Alert → When a new issue is created
→ Then send a notification via [your integration]
```

Sentry invia una POST con `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}`; i percorsi GJSON qui sopra estraggono questi campi nella notifica push.

### 3. Altri strumenti (Rollbar, Bugsnag)

Rollbar (Impostazioni → Notifications → Webhook) e Bugsnag (Integrations → Generic webhook) inviano un payload più piatto. Adatta il template ai loro campi, ad esempio `%data.item.title%` per Rollbar o `%error.exceptionClass%` per Bugsnag, e incolla lo stesso URL di ricezione.

La [documentazione delle impostazioni dei webhook](https://info.pocketalert.app/api/webhooks/settings.html) descrive tutti i percorsi GJSON e le opzioni dei webhook.

## FAQ

### Come ricevo avvisi di errore sul telefono?

In Sentry crea un'Internal Integration con un URL webhook impostato sul tuo URL di ricezione di Pocket Alert e con la Alert Rule Action abilitata, poi aggiungila a una regola di avviso sui problemi. Quando la regola si attiva, Sentry invia una POST con il problema e la notifica push arriva al tuo telefono in meno di un secondo.

### Come funziona la mappatura dei campi?

I webhook di avviso sui problemi di Sentry annidano i dati sotto data.event. Pocket Alert li legge con i percorsi GJSON: mappi data.event.title nel titolo della notifica e data.event.culprit, oppure web_url, nel corpo, così la notifica push ti dice esattamente quale problema si è attivato.

### Posso mostrare il livello dell'errore e la regola?

Il payload contiene data.event.level (warning, error, fatal) e il nome della regola in data.triggered_rule. Inseriscili entrambi nel tuo template di messaggio GJSON, così un'eccezione fatal appare diversa da un warning.

### Posso separare produzione e staging?

Assegna a ogni ambiente un'applicazione dedicata. Un webhook di produzione e uno di staging finiscono in canali separati, e puoi silenziare lo staging senza toccare la produzione.

### Devo installare un agent?

Nulla. Pocket Alert riceve semplicemente il webhook che il tuo strumento di monitoraggio già invia, quindi non c'è alcun agent o SDK da installare. Sentry, Rollbar, Bugsnag, Honeybadger e Airbrake supportano tutti i webhook in uscita.

### Un'eccezione di produzione può superare Non disturbare?

Sì. Aggiungi "level":"critical" al messaggio e su Android viene pubblicato su un canale di notifica dedicato che ignora Non disturbare: concedi l'accesso a Non disturbare una sola volta. Su iPhone, le notifiche high e critical arrivano come notifiche time-sensitive che superano le modalità Full immersion. Ogni messaggio accetta un livello da silent a critical, quindi un warning di staging può restare silenzioso mentre un fatal di produzione ti sveglia. Con il piano gratuito, critical viene consegnato come high: sempre istantaneo, ma senza l'esclusione da Non disturbare.
