Aller au contenu principal

Notifications

docStatic utilise GitHub Actions pour envoyer des notifications de workflow. Des exemples de notifications de révision et de traduction sont inclus dans le dossier .github/workflows/. Une configuration spécifique sur GitHub est nécessaire pour les activer. Vous pouvez également vous en servir comme point de départ pour développer vos propres notifications personnalisées.

E-mail​

Les actions email-review.yml et email-translate.yml sont déclenchées lorsque les balises « review » ou « translate » sont ajoutées à un fichier Markdown situé dans la branche principale. Pour les utiliser, ajoutez ces secrets à votre dépôt :

  • SMTP_SERVER
  • SMTP_PORT
  • SMTP_USERNAME
  • SMTP_PASSWORD
  • NOTIFY_EMAIL_TO
  • NOTIFY_EMAIL_FROM

Vous pouvez obtenir ces informations auprès de votre fournisseur de messagerie. Par exemple :

Slack​

Les actions slack-review.yml et slack-translate.yml utilisent les mêmes déclencheurs que les versions par e-mail. Pour les utiliser, ajoutez l’URL de votre webhook Slack en tant que secret nommé SLACK_WEBHOOK_URL. Pour plus d’informations, consultez la section Envoi de messages à l’aide de webhooks entrants dans la documentation Slack.

Teams​

Les actions teams-review.yml et teams-translate.yml fonctionnent comme les versions Slack. Microsoft va déprécier l’application Incoming Webhooks pour Teams à partir de décembre 2025, mais il n’existe actuellement aucune méthode GitHub accessible au public permettant d’envoyer des Adaptive Cards vers des workflows. La solution consiste à utiliser curl :

- name: Send Teams test notification
  run: |
    curl --ssl-no-revoke -X POST \
    --location ${{ secrets.MS_TEAMS_HTTP_POST_URL }} \
    --header 'Content-Type: application/json' \
    --data '{ \
      "type": "message", \
      "attachments": [{ \
        "contentType": "application/vnd.microsoft.card.adaptive", \
        "content": { \
          "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", \
          "type": "AdaptiveCard", \
          "version": "1.3", \
          "body": [ { \
            "type": "TextBlock", \
            "text": "This is a test notification from GitHub Actions (Teams).", \
            "wrap": true }]}}]}'
  1. Dans Teams, accédez au canal vers lequel vous souhaitez envoyer des messages, cliquez sur les points de suspension (…) et sélectionnez Workflows.
  2. Cliquez sur Gérer.
  3. Cliquez sur Nouveau flux.
  4. Recherchez des modèles pour les webhooks, puis cliquez sur Envoyer des alertes de webhook vers un canal.
  5. (Facultatif) Modifiez le Nom du flux.
  6. Connectez-vous, puis cliquez sur Suivant.
  7. Sélectionnez une Équipe et un Canal dans les listes, puis cliquez sur Créer un flux.
  8. Copiez la valeur MS_TEAMS_HTTP_POST_URL, enregistrez-la comme secret sur GitHub, puis cliquez sur Terminé.
Tip

You can use the Test notifications GitHub action to test your connections.