# Faites en sorte qu’un workflow terminé faites vibrer votre téléphone.

> Recevez les résultats de GitHub Actions en notifications push. Ajoutez une étape Pocket Alert à votre workflow et soyez prévenu sur votre téléphone, en moins d’une seconde, d’un build en échec ou d’un déploiement terminé.

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

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

Pocket Alert envoie les résultats GitHub Actions sur votre téléphone sous forme de notifications push. Ajoutez une étape curl à un workflow : dès qu’un build, un déploiement ou une release se termine, le résultat arrive sur votre iPhone ou votre Android en moins d’une seconde, sans avoir à surveiller l’onglet Actions.

## Trois étapes pour recevoir les alertes GitHub Actions sur votre téléphone

1. **Créez une application** — Ajoutez une application dans Pocket Alert et enregistrez votre clé API comme secret de dépôt POCKETALERT_API_KEY.
2. **Configurez l’étape** — Ajoutez une étape de notification qui appelle l’API des messages avec curl, en utilisant if: failure() et if: success() pour choisir les résultats.
3. **Associez et envoyez** — Intégrez le dépôt, le sha et le workflow dans le message. La prochaine exécution fera vibrer votre téléphone.

## De l’exécution du workflow à l’écran verrouillé

Votre workflow sait déjà quand un job se termine. Pocket Alert transforme ce moment en notification push impossible à manquer.

- **Une étape dans votre workflow** — Un seul appel curl vers l’API des messages transforme n’importe quelle étape de workflow en notification push. Aucune configuration de runner, aucun service supplémentaire.
- **Clé en secret de dépôt** — Lisez votre clé API depuis ${{ secrets.POCKETALERT_API_KEY }} pour qu’elle reste hors des journaux et soit régénérable depuis le tableau de bord.
- **Alertez sur les résultats de votre choix** — Associez if: failure() et if: success() pour envoyer les builds en échec et les déploiements réussis sous forme de messages distincts et clairement étiquetés.
- **Un canal par dépôt** — Chaque application possède son propre identifiant, si bien que les exécutions par dépôt et par environnement restent dans des canaux séparés.
- **Livraison en moins d’une seconde** — L’étape se déclenche dès la fin du job, et le résultat arrive sur votre téléphone en moins d’une seconde.
- **Contexte complet de l’exécution** — Intégrez github.repository, github.sha et github.workflow dans le message pour savoir exactement de quelle exécution il s’agit.

## Envoyez les alertes GitHub Actions sur votre téléphone

### 1. Créez une application et enregistrez votre clé API

Ajoutez une application dans Pocket Alert et copiez votre clé API. Enregistrez-la comme secret de dépôt nommé `POCKETALERT_API_KEY` dans Paramètres → Secrets and variables → Actions.

### 2. Ajoutez une étape de notification qui appelle l’API des messages

```
- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'
```

### 3. Envoyez vers une application précise

Ajoutez `application_id` au corps de la requête pour envoyer la notification push vers une seule application (retrouvez le TID dans le tableau de bord) :

```
-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'
```

La [documentation de démarrage](https://info.pocketalert.app/getting-started.html) présente tous les champs acceptés par l’API des messages.

## FAQ

### Comment recevoir les alertes GitHub Actions sur mon téléphone ?

Ajoutez une étape qui exécute curl sur https://api.pocketalert.app/v1/messages avec votre clé API dans l’en-tête Token. Placez-la à la fin du job pour qu’un déploiement terminé ou un build en échec envoie immédiatement une notification push sur votre téléphone.

### Comment garder la clé confidentielle ?

Stockez votre clé API comme secret du dépôt et lisez-la avec ${{ secrets.POCKETALERT_API_KEY }}, envoyée dans l’en-tête Token. La clé n’apparaît jamais dans les journaux, et vous pouvez la régénérer depuis le tableau de bord Pocket Alert.

### Puis-je n’être alerté qu’en cas d’échec ?

Utilisez if: failure() et if: success() sur deux étapes distinctes. Un build en échec déclenche un message, un déploiement réussi en déclenche un autre, et vous ne branchez que les résultats qui vous intéressent.

### Puis-je séparer les alertes par dépôt ?

Attribuez une application à chaque dépôt ou environnement. Les workflows frontend, backend et release arrivent dans des canaux séparés que vous pouvez couper indépendamment.

### Puis-je inclure le commit et le workflow ?

Insérez dans le corps du message le contexte de l’exécution, comme ${{ github.repository }}, ${{ github.sha }} et ${{ github.workflow }}, pour que la notification push vous indique précisément quelle exécution s’est terminée.

### Quel point de terminaison l’étape appelle-t-elle ?

L’étape appelle https://api.pocketalert.app/v1/messages avec un en-tête Token et un corps JSON contenant title et message. Ajoutez application_id pour envoyer la notification push vers une application précise.

### Un build en échec peut-il être plus bruyant qu’un build réussi ?

Ajoutez "level":"high" au corps de l’étape en cas d’échec : la notification push passe en mode Concentration sur iPhone et sonne de façon marquée sur Android. "level":"critical" va plus loin et contourne totalement le mode Ne pas déranger. Les notifications de déploiement réussi peuvent partir avec "level":"silent" : elles arrivent dans votre historique sans vibration.
