GitHub Actions

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

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.

Notification push en <1sClé en secretUne seule étape curlMis à jour le
Fonctionnalités

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.

Pour commencer

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.

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 présente tous les champs acceptés par l’API des messages.

FAQ

Vos questions, nos réponses

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.

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.

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.

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.

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.

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.

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.

Sachez que le déploiement est réussi sans suivre l’exécution.

Créez une application, copiez votre clé API et ajoutez l’étape Pocket Alert à votre workflow.