Options de remise de notifications
Vous pouvez recevoir des notifications d'activité sur GitHub à partir des emplacements suivants.
- La boîte de réception des notifications dans l'interface Web GitHub
- La boîte de réception des notifications sur GitHub Mobile, synchronisée avec la boîte de réception de l'interface Web.
- Un client de messagerie qui utilise une adresse e-mail vérifiée, pouvant également être synchronisée avec la boîte de réception des notifications dans l'interface Web et GitHub Mobile
Pour utiliser la boîte de réception des notifications sur GitHub et GitHub Mobile, vous devez activer les notifications par e-mail et sur GitHub dans vos paramètres de notification. Pour plus d’informations, consultez « Choix de vos paramètres de notification ».
Conseil
Si vous recevez des notifications à la fois par e-mail et sur GitHub, vous pouvez synchroniser automatiquement le statut lu ou non lu de la notification afin que les notifications sur GitHub soient automatiquement marquées comme lues une fois que vous avez lu la notification e-mail correspondante. Pour activer cette synchronisation, votre client de messagerie doit pouvoir afficher les images provenant de [email protected]
.
Avantages de la boîte de réception de notifications
La boîte de réception des notifications comprend des options de triage conçues spécifiquement pour votre flux de notifications GitHub, y compris pour les options suivantes :
- Trier plusieurs notifications à la fois.
- Marquer les notifications terminées avec la mention Terminé et les supprimer de votre boîte de réception. Pour visualiser toutes vos notifications marquées Terminé, utilisez la requête
is:done
. - Enregistrer une notification pour l’examiner ultérieurement. Les notifications enregistrées sont indiquées dans votre boîte de réception et sont conservées indéfiniment. Pour visualiser toutes vos notifications enregistrées, utilisez la requête
is:saved
. - Se désinscrire et supprimer une notification de votre boîte de réception.
- Prévisualisez le problème ou la demande de tirage à l’origine de la notification sur GitHub à partir de la boîte de réception des notifications.
- Voir une des raisons les plus récentes pour laquelle vous recevez une notification dans votre boîte de réception avec une étiquette
reasons
. - Créer des filtres personnalisés pour se concentrer sur différentes notifications quand vous le souhaitez.
- Regrouper des notifications dans votre boîte de réception en fonction du dépôt ou de la date pour obtenir une vue d’ensemble rapide avec moins de changements de contexte.
En outre, vous pouvez recevoir et trier des notifications sur votre appareil mobile avec GitHub Mobile. Pour plus d’informations, consultez « Gestion de vos paramètres de notification avec GitHub Mobile » ou « GitHub Mobile ».
Avantages de l’utilisation d’un client de messagerie pour les notifications
L’un des avantages offerts par l’utilisation d’un client de messagerie est que toutes vos notifications peuvent être conservées indéfiniment, en fonction de la capacité de stockage de votre client de messagerie. Vos notifications de boîte de réception ne sont conservées que pendant cinq mois sur GitHub sauf si vous les avez marquées comme Enregistré. Les notifications Enregistré sont conservées indéfiniment. Pour plus d’informations sur la stratégie de rétention de votre boîte de réception, consultez « À propos des notifications ».
L’envoi de notifications à votre client de messagerie vous permet également de personnaliser votre boîte de réception en fonction des paramètres de votre client de messagerie, qui peuvent inclure des étiquettes personnalisées ou codées en couleur.
Les notifications par e-mail offrent également une flexibilité quant aux types de notifications que vous recevez, et vous permettent de choisir différentes adresses e-mail pour les mises à jour. Par exemple, vous pouvez envoyer certaines notifications pour un dépôt à une adresse e-mail personnelle vérifiée. Pour plus d’informations sur les options de personnalisation d’e-mail, consultez « Personnalisation de vos notifications par e-mail ».
À propos des notifications de participation et de surveillance
Lorsque vous surveillez un dépôt, vous vous abonnez aux mises à jour relatives à l’activité dans ce dépôt.
Pour voir les dépôts que vous surveillez, accédez à votre page de surveillance. Pour plus d’informations, consultez « Gestion des abonnements pour l’activité sur GitHub ».
Vous pouvez configurer des notifications pour un dépôt dans la page du dépôt ou dans votre page de surveillance.
Remarque
Vous pouvez suivre jusqu’à 10 000 référentiels.
À propos des notifications personnalisées
Vous pouvez personnaliser les notifications pour un dépôt. Par exemple, vous pouvez choisir d’être averti uniquement lorsque des mises à jour d’un ou plusieurs types d’événements (problèmes, demandes de tirage, mises en production, alertes de sécurité ou discussions) se produisent dans un dépôt, ou ignorer toutes les notifications d’un dépôt. Pour plus d’informations, consultez « Configuration de vos paramètres de surveillance pour un dépôt spécifique » ci-dessous.
Participation à des conversations
Chaque fois que vous commentez une conversation ou que quelqu’un @mentions votre nom d’utilisateur, vous participez à une conversation. Par défaut, vous êtes automatiquement abonné à une conversation lorsque vous y participez. Vous pouvez vous désabonner manuellement d’une conversation à laquelle vous avez participé en cliquant sur Se désabonner dans le problème ou la demande de tirage, ou via l’option Se désabonner dans la boîte de réception des notifications.
Pour les conversations que vous surveillez ou auxquelles vous participez, vous pouvez choisir si vous souhaitez recevoir des notifications sur GitHub ou par e-mail dans vos paramètres de notification. Pour plus d’informations, consultez « Choix des paramètres de notification ».
Par exemple, dans votre page « Paramètres de notification » :
- Si vous ne souhaitez pas que les notifications soient envoyées à votre e-mail, désélectionnez e-mail pour les notifications de participation et de surveillance.
- Si vous souhaitez recevoir des notifications par e-mail lorsque vous avez participé à une conversation, sélectionnez e-mail sous « Participation ».
Si vous n’activez pas « Me notifier : Sur GitHub » pour surveiller ou participer aux notifications, votre boîte de réception de notifications n’aura aucune mise à jour.
Personnalisation de vos notifications par e-mail
Après avoir activé les notifications par e-mail, GitHub vous enverra des notifications par e-mail en mode multipart, contenant à la fois des copies HTML et des copies en texte brut. Le contenu des notifications par e-mail inclut tous les markdowns, @mentions, emojis, hash-links, et autres, qui apparaissent dans le contenu original sur GitHub. Si vous souhaitez uniquement afficher le texte dans l’e-mail, vous pouvez configurer votre client de messagerie de façon à afficher uniquement la copie en texte brut.
Conseil
Si vous recevez des notifications à la fois par e-mail et sur GitHub, vous pouvez synchroniser automatiquement le statut lu ou non lu de la notification afin que les notifications sur GitHub soient automatiquement marquées comme lues une fois que vous avez lu la notification e-mail correspondante. Pour activer cette synchronisation, votre client de messagerie doit pouvoir afficher les images provenant de [email protected]
.
Si vous utilisez Gmail, vous pouvez cliquer sur un bouton en regard de l’e-mail de notification pour accéder au problème ou à la demande de tirage d’origine qui a généré la notification.
Choisissez une adresse e-mail par défaut à laquelle vous souhaitez envoyer des mises à jour pour les conversations que vous surveillez ou auxquelles vous participez. Vous pouvez également spécifier l'activité sur GitHub pour laquelle vous souhaitez recevoir des mises à jour à l'aide de votre adresse e-mail par défaut. Par exemple, choisissez si vous souhaitez recevoir des mises à jour soient envoyées à votre adresse e-mail par défaut pour les éléments suivants :
- Commentaires sur les problèmes et les demandes de tirage
- Revues de demande de tirage
- Poussées de demandes de tirage
- Vos propres mises à jour, par exemple lorsque vous ouvrez, commentez ou fermez un problème ou une demande de tirage
En fonction de l’organisation propriétaire du dépôt, vous pouvez également envoyer des notifications à différentes adresses e-mail. Votre organisation peut exiger que l’adresse e-mail soit vérifiée pour un domaine spécifique. Pour plus d’informations, consultez « Configuration des notifications ».
Vous pouvez également envoyer des notifications pour un dépôt spécifique à une adresse e-mail. Pour plus d’informations, consultez « À propos des notifications par e-mail pour les envois (push) vers votre référentiel ».
Vous recevez uniquement des e-mails de notification si vous avez choisi de recevoir des notifications par e-mail dans vos paramètres de notification.
Si une organisation dont vous êtes membre limite les notifications par e-mail à un domaine de messagerie approuvé, vous devez vérifier une adresse e-mail dans ce domaine pour recevoir des notifications par e-mail sur l’activité de l’organisation. Pour plus d’informations, consultez « Limitation des notifications par e-mail de l’organisation ».
Chaque notification par e-mail envoyée par GitHub contient des informations d’en-tête que vous pouvez utiliser pour filtrer les notifications dans votre client de messagerie. Pour plus d’informations sur les en-têtes inclus, consultez En-têtes de notification par e-mail.
Réponse aux notifications par e-mail
Vous pouvez apporter un commentaire aux notifications par e-mail à partir de GitHub et votre commentaire sera publié sur le problème, la demande de tirage ou la discussion.
L’adresse reply-to
de chaque notification par e-mail identifie la conversation et le compte à partir duquel le commentaire sera publié. Cette adresse e-mail reste valide jusqu’à ce que vous réinitialisiez votre mot de passe.
GitHub n’inclut pas toujours les contenus complets de l’e-mail et tente de supprimer certaines informations personnelles identifiantes des commentaires créés via un commentaire par e-mail :
- les adresses e-mail sous un format standard, comme
[email protected]
, sont transformées en***@***.***
. - Les signatures et les chaînes de commentaire entre guillemets, lorsque le client de l’e-mail a utilisé une adresse
>
pour marquer ces sections, sont supprimées. - Bien que le lien de désabonnement de votre notification par e-mail soit parfois cité, le lien fonctionne uniquement lors de la connexion à votre compte.
- Les pièces jointes par e-mail ne sont pas incluses dans le commentaire résultant.
- La longueur maximale d’un commentaire créé par un commentaire par e-mail est de 65 530 caractères.
Choix de vos paramètres de notification
-
Dans le coin supérieur droit de n’importe quelle page, cliquez sur .
-
Dans la barre latérale à gauche, sous la liste des dépôts, utilisez la liste déroulante « Gérer les notifications » pour cliquer sur Paramètres de notification.
-
Dans la page des paramètres de notifications, choisissez la façon dont vous recevez des notifications quand :
- Des mises à jour sont disponibles dans les référentiels que vous suivez ou dans une conversation à laquelle vous participez. Pour plus d'informations, voir A propos de la participation et de l'observation des notifications.
- Il existe de nouvelles Dependabot alerts dans votre dépôt. Pour plus d’informations, consultez « Gestion des notifications de sécurité ».
- Des mises à jour d’exécutions de flux de travail ont lieu dans des dépôts configurés avec GitHub Actions. Pour plus d’informations, consultez Gérer les notifications GitHub Actions.
- De nouvelles clés de déploiement sont ajoutées à des dépôts appartenant à des organisations dont vous êtes propriétaire. Pour plus d’informations, consultez « Gérer les notifications de l’organisation ».
Configuration de vos paramètres de surveillance pour un dépôt spécifique
Vous pouvez choisir de surveiller ou non un dépôt spécifique. Vous pouvez également choisir d’être notifié uniquement de certains types d’événements tels que problèmes, demandes de tirage, mises en production, alertes de sécurité ou discussions (si c’est activé pour le dépôt) ou d’ignorer complètement un dépôt.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Dans le coin supérieur droit, sélectionnez le menu déroulant « Surveiller » et cliquez sur une option de surveillance.
Si vous souhaitez personnaliser davantage les notifications, cliquez sur Personnalisé, puis sélectionnez des événements spécifiques dont vous souhaitez être averti, tels que des problèmes ou des demandes de tirage, en plus de participer et d’être @mentions.
Par exemple, si vous sélectionnez « Problèmes », vous serez averti et abonné aux mises à jour de chaque problème (y compris ceux qui existaient avant la sélection de cette option) dans le dépôt. Si vous êtes @mentioned dans une demande de tirage dans ce dépôt, vous recevrez également des notifications pour cela, et vous serez abonné aux mises à jour de cette demande de tirage spécifique, en plus d’être averti des problèmes.
Gestion de vos paramètres de notification avec GitHub Mobile
Lorsque vous installez GitHub Mobile, vous êtes automatiquement inscrit pour les notifications web. Dans l’application, vous pouvez activer les notifications Push pour les événements suivants.
- Mentions directes
- Affectations à des problèmes ou demandes de tirage
- Demandes de révision d’une demande de tirage
- Demandes d’approbation d’un déploiement
Vous pouvez également planifier quand GitHub Mobile envoie des notifications Push à votre appareil mobile.
GitHub Enterprise Server utilise la récupération en arrière-plan pour prendre en charge les notifications push, ce qui peut entraîner un retard dans la réception des notifications push.
Gestion de vos paramètres de notification avec GitHub for iOS
- Dans le menu inférieur, appuyez sur Profil.
- Pour afficher vos paramètres, appuyez sur .
- Pour mettre à jour vos paramètres de notification, appuyez sur Notifications, puis utilisez les bascules pour activer ou désactiver vos types préférés de notifications Push.
- Si vous le souhaitez, pour planifier quand GitHub Mobile envoient des notifications Push à votre appareil mobile, appuyez sur Heures de travail, utilisez le bouton bascule Heures de travail personnalisées, puis choisissez quand vous souhaitez recevoir des notifications Push.
Gestion de vos paramètres de notification avec GitHub for Android
- Dans le menu inférieur, appuyez sur Profil.
- Pour afficher vos paramètres, appuyez sur .
- Pour mettre à jour vos paramètres de notification, appuyez sur Configurer les notifications, puis utilisez les bascules pour activer ou désactiver vos types préférés de notifications Push.
- Si vous le souhaitez, pour planifier quand GitHub Mobile envoient des notifications Push à votre appareil mobile, appuyez sur Heures de travail, utilisez le bouton bascule Heures de travail personnalisées, puis choisissez quand vous souhaitez recevoir des notifications Push.
Configuration de vos paramètres de surveillance pour un dépôt spécifique avec GitHub Mobile
Vous pouvez choisir de surveiller ou non un dépôt spécifique. Vous pouvez également choisir d’être notifié uniquement de certains types d’événements tels que les problèmes, les demandes de tirage, les discussions (si c’est activé pour le dépôt) et des nouvelles mises en production, ou d’ignorer complètement un dépôt spécifique.
- Sur GitHub Mobile, accédez à la page principale du dépôt.
- Appuyez sur Watch.
- Pour choisir les activités pour lesquelles vous recevez des notifications, appuyez sur vos paramètres de surveillance préférés. Par exemple, choisissez d’être averti uniquement lorsque vous participez ou êtes @mentioned, ou utilisez l’option « Personnalisé » pour sélectionner des événements spécifiques dont vous souhaitez être averti.