# L’instant où un déploiement se termine.

> Recevez une notification push dès qu’un déploiement réussit ou échoue. Ajoutez une étape à GitHub Actions, GitLab CI ou Jenkins : le résultat arrive sur votre téléphone en quelques secondes.

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

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

Ajoutez une étape de notification à GitHub Actions, GitLab CI ou Jenkins, ou branchez un webhook de déploiement Vercel ou Netlify sur Pocket Alert. Le résultat du déploiement arrive sur votre téléphone en moins d’une seconde après la fin de la tâche, avec le commit, la branche et l’environnement.

## Trois étapes pour les alertes de déploiement

1. **Obtenez la clé ou l’URL du webhook** — Créez une clé API pour un appel CLI ou curl, ou un webhook, puis copiez son URL de réception.
2. **Ajoutez une étape ou un webhook** — Ajoutez une étape de notification à votre pipeline, ou collez l’URL de réception dans les notifications de déploiement de Vercel ou Netlify.
3. **Déployez en toute confiance** — Livrez une mise en production et votre téléphone vibre avec le résultat, le commit et l’environnement.

## Chaque mise en production sur votre téléphone

Lorsqu’une mise en production échoue discrètement, vous le savez en quelques secondes, bien avant qu’un utilisateur ne signale le site défaillant.

- **S’intègre à n’importe quel pipeline** — GitHub Actions, GitLab CI, Jenkins et CircleCI nécessitent chacun une seule étape à la fin du pipeline.
- **Succès ou échec** — Envoyez en cas de succès, d’échec ou dans les deux cas. Lancez l’étape de notification avec if: failure() pour n’être informé que des mises en production défaillantes.
- **Contexte du déploiement** — Placez le commit, la branche, l’environnement et l’URL d’exécution dans le message pour savoir exactement ce qui a été livré.
- **Canaux par environnement** — Une application distincte par environnement garde les déploiements de production, de préproduction et de prévisualisation dans leurs propres canaux.
- **Instantané à la fin** — La notification push arrive dès la fin de la tâche, vous pouvez donc fermer l’onglet du pipeline.
- **Aucune configuration** — Un seul appel CLI ou curl dans votre tâche. Aucun bot Slack à installer.

## Être notifié à chaque déploiement

### 1. Pipeline CI/CD (CLI ou curl)

Ajoutez une étape à la fin de votre tâche GitHub Actions, GitLab CI, Jenkins ou CircleCI. Avec la CLI :

```
pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"
```

Ou appelez directement l’API des messages avec curl, afin de ne rien installer sur le runner :

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'
```

### 2. Vercel ou Netlify (webhook)

Créez un webhook pour que Vercel ou Netlify puisse envoyer sa propre charge utile de déploiement à Pocket Alert. Le champ `message` est un modèle GJSON qui associe leurs champs à la notification push :

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'
```

Vous obtenez une URL de réception du type `https://p4a.me/wh/1234abcd`. Collez-la dans les paramètres de webhook de Vercel (événements tels que `deployment.succeeded`). Pour Netlify, ajoutez-la comme webhook sortant de notification de déploiement et associez ses champs, par exemple `%name% is %state% on %branch%`.

La [documentation des paramètres de webhook](https://info.pocketalert.app/api/webhooks/settings.html) couvre l’API des messages et l’association des champs GJSON.

## FAQ

### Comment recevoir des notifications de déploiement ?

Ajoutez une étape de notification à la fin de votre pipeline dans GitHub Actions, GitLab CI, Jenkins ou CircleCI. Exécutez la CLI Pocket Alert ou un appel curl, et le résultat du déploiement arrive sous forme de notification push dès que la tâche se termine.

### Puis-je n’être alerté que pour les déploiements échoués ?

Oui. Utilisez le statut de la tâche pour envoyer un message de succès ou d’échec, et ne lancez l’étape de notification que avec if: failure() afin que seule une mise en production défaillante vous alerte.

### Puis-je inclure le commit et l’environnement ?

Placez le commit, la branche, l’environnement et l’URL du pipeline dans le corps du message. L’alerte vous indique alors ce qui a été livré et où, et renvoie directement vers l’exécution.

### Quels outils CI/CD sont pris en charge ?

Toute commande exécutable fonctionne : GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines ou un simple script de déploiement. Pour Vercel et Netlify, créez un webhook Pocket Alert et collez son URL de réception dans les paramètres de notification de déploiement.

### Puis-je séparer les alertes de production et de préproduction ?

Créez une application distincte par environnement : production, préproduction et prévisualisation. Les déploiements en production arrivent alors dans leur propre canal, et vous distinguez les mises en production d’un coup d’œil.

### Un échec de déploiement en production peut-il passer le mode Ne pas déranger ?

Oui. Envoyez les déploiements échoués avec level=critical : sur Android, ils sont publiés sur un canal dédié qui contourne le mode Ne pas déranger, et sur iPhone, ils s’affichent comme notifications urgentes qui passent le mode Concentration. Les confirmations de succès courantes peuvent être envoyées avec level=silent, afin de rester dans l’historique sans vibration.
