# Vos exceptions arrivent sur votre téléphone.

> Recevez les exceptions de Sentry, Rollbar et Bugsnag en notifications push. Pointez le webhook de votre outil de suivi d’erreurs vers Pocket Alert et repérez les nouveaux problèmes en moins d’une seconde.

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

Dernière mise à jour : 2026-08-11

Quand Sentry, Rollbar ou Bugsnag détecte une nouvelle exception, le titre et la gravité arrivent sur votre téléphone en moins d’une seconde. Repérez l’erreur avant que vos utilisateurs ne la signalent.

## Trois étapes pour recevoir les alertes d’erreur sur votre téléphone

1. **Créer un webhook** — Créez un webhook Pocket Alert avec un modèle de message GJSON et copiez son URL de réception.
2. **Connecter l’outil de suivi** — Collez l’URL dans une Internal Integration Sentry (ou un webhook Rollbar/Bugsnag) et rattachez-la à une règle d’alerte.
3. **Associer et envoyer** — GJSON associe data.event.title, culprit, level et web_url à votre notification push. La prochaine exception fera vibrer votre téléphone.

## De la trace d’exécution à l’écran verrouillé

Votre outil de suivi d’erreurs envoie déjà un webhook. Pocket Alert le transforme en notification push impossible à manquer.

- **Compatible avec tous les outils de suivi** — Sentry, Rollbar, Bugsnag, Honeybadger et Airbrake déclenchent tous un webhook sortant lors d’un nouveau problème. Indiquez-leur Pocket Alert et c’est terminé.
- **Associez les champs avec GJSON** — Les chemins GJSON extraient data.event.title, data.event.culprit et data.event.level directement de la charge utile pour les intégrer à votre notification.
- **Niveau et règle dans le message** — Affichez le niveau d’erreur et la règle déclenchée directement dans la notification push, pour qu’une exception fatale se distingue d’un avertissement.
- **Un canal par environnement** — Chaque application possède son propre URL de webhook : la production, la préproduction et un service spécifique restent dans des canaux séparés.
- **Livraison en moins d’une seconde** — L’exception atteint votre téléphone en moins d’une seconde, bien avant l’envoi du récapitulatif par e-mail.
- **URL de webhook secrète** — L’URL de webhook est votre secret d’application, transmis via HTTPS. Régénérez-la chaque fois que vous avez besoin d’un nouveau point de terminaison.

## Envoyer les alertes d’erreur sur votre téléphone

### 1. Créer un webhook Pocket Alert

Sur la page [Webhooks](https://pocketalert.app/fr/webhooks), créez un webhook dont le modèle GJSON `message` lit la charge utile de l’alerte Sentry (tout est imbriqué sous `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"}'
```

Vous obtenez une URL entrante du type `https://p4a.me/wh/1234abcd`.

### 2. Configurer Sentry

Dans [Paramètres → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/), renseignez l’URL du webhook avec votre URL de réception et activez l’Alert Rule Action. Créez ensuite une règle d’alerte sur les problèmes et ajoutez l’intégration comme action :

```
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 envoie `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}` ; les chemins GJSON ci-dessus intègrent ces champs dans la notification push.

### 3. Autres outils (Rollbar, Bugsnag)

Rollbar (Paramètres → Notifications → Webhook) et Bugsnag (Integrations → Generic webhook) envoient une charge utile plus plate. Adaptez le modèle à leurs champs, par exemple `%data.item.title%` pour Rollbar ou `%error.exceptionClass%` pour Bugsnag, et collez la même URL de réception.

La [documentation des paramètres des webhooks](https://info.pocketalert.app/api/webhooks/settings.html) détaille tous les chemins GJSON et toutes les options de webhook.

## FAQ

### Comment recevoir les alertes d’erreur sur mon téléphone ?

Dans Sentry, créez une Internal Integration dont l’URL de webhook correspond à votre URL de réception Pocket Alert, puis activez l’Alert Rule Action et ajoutez-la à une règle d’alerte sur les problèmes. Lorsque la règle se déclenche, Sentry envoie une requête POST avec le problème et la notification push arrive sur votre téléphone en moins d’une seconde.

### Comment fonctionne la correspondance des champs ?

Les webhooks d’alerte de Sentry imbriquent les données sous data.event. Pocket Alert les lit avec des chemins GJSON : vous associez data.event.title au titre de la notification et data.event.culprit (ou web_url) au corps du message, et la notification push indique précisément le problème détecté.

### Puis-je afficher le niveau d’erreur et la règle ?

La charge utile contient data.event.level (warning, error, fatal) et le nom de la règle dans data.triggered_rule. Référencez les deux dans votre modèle de message GJSON afin qu’une exception fatale s’affiche différemment d’un avertissement.

### Puis-je séparer la production et la préproduction ?

Attribuez une application distincte à chaque environnement. Un webhook de production et un webhook de préproduction arrivent dans des canaux séparés, et vous pouvez désactiver la préproduction sans toucher à la production.

### Dois-je installer un agent ?

Aucun. Pocket Alert reçoit simplement le webhook que votre outil envoie déjà, il n’y a donc ni agent ni SDK à installer. Sentry, Rollbar, Bugsnag, Honeybadger et Airbrake prennent tous en charge les webhooks sortants.

### Une exception de production peut-elle passer outre le mode Ne pas déranger ?

Oui. Ajoutez "level":"critical" au message : sur Android, il est envoyé dans un canal de notification dédié qui contourne le mode Ne pas déranger. Vous accordez l’accès à ce mode une seule fois. Sur iPhone, les messages de niveau high et critical arrivent sous forme de notifications time-sensitive qui passent les modes Concentration. Chaque message accepte un niveau allant de silent à critical, ainsi un avertissement de préproduction peut rester silencieux pendant qu’une erreur fatale de production vous réveille. Dans l’offre gratuite, critical est livré comme high : toujours instantané, mais sans le contournement du mode Ne pas déranger.
