Skip to main content

Personnalisation des notifications pour GitHub dans Teams

Personnalisez GitHub notifications pour gérer votre travail dans Teams.

Vous pouvez personnaliser vos notifications en vous abonnant à l’activité pertinente pour votre canal Microsoft Teams et en désinscrire l’activité qui est moins utile pour votre projet.

Notifications activées par défaut

Les notifications suivantes sont activées par défaut, mais vous pouvez les désactiver à l’aide de la commande @GitHub Notifications unsubscribe owner/repo [feature].

FonctionnalitéDescription
issuesOuverture, fermeture ou réouverture de demandes.
pullsDemandes de tirage nouvellement créées, fusionnées, fermées ou rouvertes.
commitsNouvelles validations sur la branche par défaut (généralement main).
commentsNouveaux commentaires sur les problèmes et les pull requests.
deploymentsMises à jour de l’état du déploiement.
releasesNouvelles versions et préversions publiées.

Remarque

Les notifications de référentiel sont également activées par défaut. Vous serez averti lorsque votre référentiel est rendu public ou supprimé. Cette notification ne peut pas être désactivée, car les mises à jour du référentiel sont des activités destructrices.

Notifications désactivées par défaut

Les notifications suivantes sont désactivées par défaut, mais vous pouvez les activer à l’aide de la commande @GitHub Notifications subscribe owner/repo [feature].

FonctionnalitéDescription
reviewsRévisions des demandes de tirage
workflowsGitHub Actions exécutions de workflow et notifications d’approbation.
branchesCréation et suppression de branche.
discussionsDiscussions créées ou répondues.
+label:"your label"Filtrez les problèmes, les demandes de tirage et les commentaires selon leurs étiquettes.

Vous pouvez vous abonner ou vous désabonner de plusieurs paramètres à la fois. Par exemple:

  • Pour activer l'activité des révisions et commentaires des pull requests, utilisez @GitHub Notifications subscribe owner/repo reviews comments.
  • Pour désactiver l'activité pour les problèmes et les pull requests, utilisez @GitHub Notifications unsubscribe owner/repo issues pulls.

Filtrage des notifications

Vous pouvez personnaliser davantage vos notifications avec des filtres de branche et d’étiquette. Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche, tandis que les filtres d’étiquettes vous permettent de filtrer les notifications de problèmes et de propositions de modification en fonction des étiquettes appliquées.

Filtres de branches pour les notifications de validation

Les filtres de branche vous permettent de filtrer les notifications de validation en fonction des noms de branche. Par défaut, lorsque vous vous abonnez à l’événement commits , vous recevez des notifications pour votre branche par défaut. Toutefois, vous pouvez choisir de filtrer sur une branche spécifique, ou un modèle de branches ou de toutes les branches.

Exemple de configurationDescription
@GitHub Notifications subscribe owner/repo commitsRecevoir des notifications de validation pour la branche par défaut.
@GitHub Notifications subscribe owner/repo commits:mainRecevoir uniquement des notifications de validation pour la main branche.
@GitHub Notifications subscribe owner/repo commits:feature/*Recevoir des notifications de validation pour toutes les branches qui commencent par feature/.
@GitHub Notifications subscribe owner/repo commits:*Recevoir des notifications de validation pour toutes les branches.

Vous pouvez vous désabonner de la fonctionnalité de validations à l’aide de @GitHub Notifications unsubscribe owner/repo commits.

Remarque

Vous avez peut-être déjà utilisé le commits:all filtre pour recevoir des notifications de validation pour toutes les branches. Ce filtre va être en cours de clôture. Pour recevoir des notifications de validation pour toutes les branches, utilisez plutôt le commits:* filtre. Si vous avez déjà configuré le commits:all filtre, il continuera de fonctionner jusqu’à ce que vous mettez à jour votre configuration pour utiliser le commits:* filtre.

Filtres d'étiquettes pour les notifications de problèmes et de demande de tirage

Les filtres d’étiquettes vous permettent de filtrer les notifications en fonction des étiquettes appliquées aux issues et aux pull requests. Lorsqu’un filtre d’étiquette est défini, seules les notifications pour les événements incluant l’étiquette spécifiée sont envoyées. Pour plus d’informations sur les étiquettes, consultez Gestion des étiquettes et Filtrage et recherche de problèmes et de demandes de tirage.

Actuellement, il n’est possible d’avoir qu’un seul filtre d’étiquette requis par référentiel. Le tableau ci-dessous montre quels types d’événements sont affectés par les filtres d’étiquettes.

Type d’événementEst filtré par étiquette
Requêtes de tirage
Problèmes
Commentaires
Révisions
Validations/envois (push)
Branches

Création de filtres d’étiquettes

Pour créer un filtre d’étiquette, utilisez le format de commande suivant :

Text
@GitHub Notifications subscribe [owner/repo] +label:"your label"

Cela crée un filtre d’étiquette obligatoire avec la valeur your label. Les événements entrants qui prennent en charge les filtres sont ignorés, sauf s’ils ont cette étiquette.

Mise à jour des filtres d’étiquettes

Vous pouvez mettre à jour un filtre d’étiquette existant en spécifiant une nouvelle valeur d’étiquette :

Text
@GitHub Notifications subscribe [owner/repo] +label:"new label"

Cela remplace le filtre « votre étiquette » par le filtre « nouvelle étiquette ».

Suppression des filtres d’étiquettes

Vous pouvez supprimer un filtre d’étiquette existant à l’aide de la commande de désabonnement avec l’option +label :

Text
@GitHub Notifications unsubscribe [owner/repo] +label:"new label"

Cela supprime le filtre « nouvelle étiquette », et le canal reçoit toutes les notifications pour les événements abonnés sans filtrage d’étiquette.

Affichage des filtres d’étiquettes actifs

Pour afficher les filtres d’étiquettes actuellement actifs pour un canal, utilisez la commande suivante :

Text
@GitHub Notifications subscribe list features

Filtres valides

L’application GitHub dans Teams prend en charge les caractères spéciaux les plus courants pour les filtres d’étiquettes, y compris tous les emojis que Teams et GitHub fournissent en tant que standard. Rarement, vous pouvez rencontrer une étiquette qui contient un caractère spécial qui n’est pas supporté. Par exemple, tout caractère multioctet non codé en tant que :foo:, ou les étiquettes utilisant le , caractère peuvent ne pas fonctionner comme prévu.

GitHub Actions notifications de flux de travail

Vous pouvez vous abonner aux notifications d'exécution de flux de travail GitHub Actions à partir de votre canal ou de votre application personnelle en utilisant la fonctionnalité « workflows », au format @GitHub Notifications subscribe owner/repo workflows.

Lorsque vous êtes abonné à des « workflows », les fonctionnalités suivantes sont disponibles :

  • Vous serez averti lorsqu’une nouvelle exécution de flux de travail est déclenchée.
  • Vous pouvez suivre les notifications d’approbation en tant que réponse dans le thread et vous pouvez approuver les notifications directement à partir du canal ou de l’application personnelle.
  • Une fois le flux de travail terminé, vous obtenez une mise à jour en tant que réponse dans le thread afin que vous puissiez voir le contexte complet et l’historique de l’exécution du flux de travail.
  • En cas d'échec, vous pouvez choisir de réexécuter le workflow sur place et activer les journaux de débogage si nécessaire.

Remarque

Après le 10 mars 2025 et pour la version 3.17 ainsi que les versions ultérieures de GitHub Enterprise Server, vous ne recevrez plus d’informations sur la progression des tâches individuelles du workflow. Pour plus d’informations, consultez le journal des modifications GitHub .

Filtres de notification de flux de travail

Vous pouvez filtrer les notifications de flux de travail à l’aide des options suivantes :

FilterDescription
nameFiltrez par le nom du flux de travail.
actorFiltrez par l’utilisateur qui a déclenché le flux de travail.
branchFiltrez par branche sur laquelle le flux de travail s’exécute. Dans les cas où l’événement pull_request est inclus, la branche sera celle ciblée par le pull request.
eventFiltrez par l’événement qui a déclenché le flux de travail (par exemple, push, pull_request).

Vous pouvez configurer des filtres de notification de flux de travail au format suivant :

Text
@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

Vous pouvez également passer plusieurs valeurs pour chaque filtre, séparées par des virgules. Par exemple:

Text
@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

Par défaut, lorsque vous configurez des notifications de workflow sans appliquer de filtres, elles sont configurées pour les workflows déclenchés par des pull requests ciblant votre branche par défaut. Vous pouvez passer une ou plusieurs entrées.

Vous pouvez vous désabonner des notifications de flux de travail à l’aide de la commande : @GitHub Notifications unsubscribe owner/repo workflows.

Remarque

Pour recevoir les notifications de GitHub Actions dans Teams, l'application GitHub nécessite des autorisations supplémentaires. Lorsque vous tentez de vous abonner aux flux de travail pour la première fois, vous êtes invité à accorder ces autorisations.

Notifications de déploiement

Vous pouvez également configurer des notifications de déploiement distinctes. Ces déploiements peuvent se produire à partir de GitHub Actions ou à partir de sources externes à l’aide de l’API déploiements. Consultez « Points de terminaison d’API REST pour les déploiements ».

Vous pouvez vous abonner ou vous désabonner aux notifications de déploiement à l’aide des commandes suivantes :

Text
@GitHub Notifications subscribe owner/repo deployments
@GitHub Notifications unsubscribe owner/repo deployments

Remarque

Si vous utilisez GitHub Actions et que vous souhaitez suivre vos déploiements dans des environnements, la workflows fonctionnalité est recommandée, car elle fournit une image plus complète et la possibilité d’approuver vos déploiements directement à partir de Teams.