Skip to main content

Anpassen der Benachrichtigungen für GitHub in Microsoft Teams

Passen Sie GitHub Benachrichtigungen an, um Ihre Arbeit in Teams zu verwalten.

Sie können Ihre Benachrichtigungen anpassen, indem Sie Aktivitäten abonnieren, die für Ihren Microsoft Teams Kanal relevant sind, und das Abmelden von Aktivitäten, die für Ihr Projekt weniger hilfreich sind.

Standardmäßig aktivierte Benachrichtigungen

Die folgenden Benachrichtigungen sind standardmäßig aktiviert, sie können jedoch mit dem Befehl @GitHub Notifications unsubscribe OWNER/REPO [FEATURE] deaktiviert werden.

MerkmalBeschreibung
issuesGeöffnete, geschlossene oder wiedereröffnete Vorgänge.
pullsNeue, zusammengeführte, geschlossene oder erneut geöffnete Pullanforderungen.
commitsNeue Commits für die Standardverzweigung (in der Regel main).
commentsNeue Kommentare bei Issues und Pull Requests.
deploymentsAktualisierungen am Bereitstellungsstatus
releasesNeue Veröffentlichungen und veröffentlichte Vorabversionen.

Hinweis

Repositorybenachrichtigungen sind ebenfalls standardmäßig aktiviert. Sie werden benachrichtigt, wenn Ihr Repository öffentlich gemacht oder gelöscht wird. Diese Benachrichtigung kann nicht deaktiviert werden, da Repositoryupdates destruktive Aktivitäten sind.

Standardmäßig deaktivierte Benachrichtigungen

Die folgenden Benachrichtigungen sind standardmäßig deaktiviert, sie können jedoch mit dem Befehl @GitHub Notifications subscribe owner/repo [FEATURE] aktiviert werden.

MerkmalBeschreibung
reviewsÜberprüfungen von Pull-Anfragen.
workflows
GitHub Actions Workflow-Ausführungen und Genehmigungsbenachrichtigungen.
branchesVerzweigungserstellung und -löschung.
discussionsErstellte oder beantwortete Diskussionen.
+label:"YOUR-LABEL"Filtern Sie Probleme, Pullanforderungen und Kommentare basierend auf ihren Bezeichnungen.

Sie können mehrere Einstellungen gleichzeitig abonnieren oder kündigen. Beispiel:

  • Verwenden Sie @GitHub Notifications subscribe OWNER/REPO reviews comments, um die Aktivität für Pullanforderungsüberprüfungen und Kommentare zu aktivieren.
  • Verwenden Sie @GitHub Notifications unsubscribe OWNER/REPO issues pulls, um die Aktivität für Probleme und Pullanforderungen zu deaktivieren.

Filtern von Benachrichtigungen

Sie können Ihre Benachrichtigungen mit Branch- und Bezeichnungsfiltern weiter anpassen. Mithilfe von Verzweigungsfiltern können Sie Commit-Benachrichtigungen basierend auf Verzweigungsnamen filtern, während Labelfilter es Ihnen ermöglichen, Problem- und Pull-Request-Benachrichtigungen basierend auf Labels zu filtern, die auf sie angewendet werden.

Verzweigungsfilter für Commit-Benachrichtigungen

Mit Branch-Filtern können Sie Commit-Benachrichtigungen nach Branch-Namen filtern. Wenn Sie das commits-Ereignis abonnieren, erhalten Sie standardmäßig Benachrichtigungen für Ihren Standard-Branch. Sie können jedoch auswählen, ob sie nach einer bestimmten Verzweigung oder einem Muster von Verzweigungen oder allen Verzweigungen gefiltert werden sollen.

BeispielkonfigurationBeschreibung
@GitHub Notifications subscribe OWNER/REPO commitsCommit-Benachrichtigungen für den Standardbranch erhalten.
@GitHub Notifications subscribe OWNER/REPO commits:mainEmpfangen Sie nur Commit-Benachrichtigungen für den main Branch.
@GitHub Notifications subscribe OWNER/REPO commits:feature/*Empfangen Sie Commit-Benachrichtigungen für alle Branches, die mit feature/ beginnen.
@GitHub Notifications subscribe OWNER/REPO commits:*Commit-Benachrichtigungen für alle Branches erhalten.

Sie können sich von dem Commits-Feature mit @GitHub Notifications unsubscribe OWNER/REPO commits abmelden.

Hinweis

Möglicherweise haben Sie früher den commits:all-Filter verwendet, um Commit-Benachrichtigungen für alle Branches zu erhalten. Dieser Filter ist Schließen. Um Commit-Benachrichtigungen für alle Zweige zu erhalten, verwenden Sie stattdessen den commits:*-Filter. Wenn Sie den commits:all Filter zuvor eingerichtet haben, funktioniert er weiterhin, bis Sie Die Konfiguration so aktualisieren, dass der commits:* Filter verwendet wird.

Label-Filter für Issue- und Pull-Request-Benachrichtigungen

Mit Bezeichnungsfiltern können Sie Benachrichtigungen basierend auf Bezeichnungen filtern, die auf Probleme und Pullanforderungen angewendet wurden. Wenn ein Bezeichnungsfilter festgelegt ist, werden nur Benachrichtigungen für Ereignisse einschließlich der angegebenen Bezeichnung gesendet. Weitere Informationen zu Bezeichnungen finden Sie unter Verwalten von Labels und Filtern und Suchen von Problemen und Pull-Anforderungen.

Derzeit ist es nur möglich, einen erforderlichen Bezeichnungsfilter pro Repository zu haben. Die folgende Tabelle zeigt, welche Ereignistypen von Bezeichnungsfiltern betroffen sind.

EreignistypWird nach Bezeichnung gefiltert
Pull Requests
Probleme
Kommentare
Bewertungen
Commits/Pushes
Filialen

Erstellen von Bezeichnungsfiltern

Verwenden Sie zum Erstellen eines Bezeichnungsfilters das folgende Befehlsformat:

Text
@GitHub Notifications subscribe [OWNER/REPO] +label:"YOUR-LABEL"

Dadurch wird ein Filter für erforderliche Bezeichnungen mit dem Wert YOUR-LABELerstellt. Eingehende Ereignisse, die Filter unterstützen, werden verworfen, es sei denn, sie sind mit dieser Bezeichnung versehen.

Aktualisieren von Bezeichnungsfiltern

Sie können einen vorhandenen Bezeichnungsfilter aktualisieren, indem Sie einen NEW-LABEL Wert angeben:

Text
@GitHub Notifications subscribe [OWNER/REPO] +label:"NEW-LABEL"

Dadurch wird der Filter "YOUR-LABEL" durch den Filter "NEW-LABEL" ersetzt.

Entfernen von Labelfiltern

Sie können einen vorhandenen Bezeichnungsfilter entfernen, indem Sie den Befehl "Abonnement kündigen" mit der +label Option verwenden:

Text
@GitHub Notifications unsubscribe [OWNER/REPO] +label:"NEW-LABEL"

Dadurch wird der Filter "NEW-LABEL" entfernt, und der Kanal empfängt alle Benachrichtigungen für die abonnierten Ereignisse ohne Bezeichnungsfilterung.

Filter der aktiven Labels anzeigen

Verwenden Sie den folgenden Befehl, um die derzeit aktiven Bezeichnungsfilter für einen Kanal anzuzeigen:

Text
@GitHub Notifications subscribe list features

Gültige Filter

Die GitHub App in Teams unterstützt die gängigsten Sonderzeichen für Filter für Bezeichnungen, einschließlich aller Emojis, die Teams und GitHub standardmäßig bereitstellen. Selten stößt man auf eine Bezeichnung, die ein Sonderzeichen enthält, das nicht unterstützt wird. Beispielsweise funktionieren multibyte-Zeichen, die nicht mit :foo:dem Zeichen codiert sind, oder Bezeichnungen, die das , Zeichen verwenden, möglicherweise nicht wie erwartet.

GitHub Actions Workflowbenachrichtigungen

Sie können Benachrichtigungen über Workflowausführungen GitHub Actions aus Ihrem Kanal oder Ihrer persönlichen App mit der Funktion „Workflows“ im Format @GitHub Notifications subscribe OWNER/REPO workflows abonnieren.

Wenn Sie "Workflows" abonniert haben, ist die folgende Funktionalität verfügbar:

  • Sie werden benachrichtigt, wenn eine neue Workflowausführung ausgelöst wird.
  • Sie können die Genehmigungsbenachrichtigungen als Antwort im Thread nachverfolgen und die Benachrichtigungen direkt über den Kanal oder die persönliche App genehmigen.
  • Nachdem der Workflow abgeschlossen ist, erhalten Sie eine Aktualisierung als Antwort im Thread, damit Sie den vollständigen Kontext und den Verlauf der Workflowausführung sehen können.
  • Wenn ein Fehler auftritt, können Sie den Workflow erneut ausführen und bei Bedarf auch Debugprotokolle aktivieren.

Hinweis

Nach dem 10. März 2025 und ab GitHub Enterprise Server Version 3.17 werden Sie nicht mehr über den Fortschritt einzelner Workflowaufträge informiert. Weitere Details finden Sie im GitHub Änderungsprotokoll .

Workflow-Benachrichtigungs-Filter

Sie können Workflowbenachrichtigungen mithilfe der folgenden Optionen filtern:

FilterBeschreibung
nameFiltern Sie nach dem Namen des Workflows.
actorFiltern Sie nach dem Benutzer, der den Workflow ausgelöst hat.
branchFiltern nach der Verzweigung, auf der der Workflow ausgeführt wird. In Fällen, in denen das pull_request-Ereignis enthalten ist, ist der Branch der Zielbranch, für den der Pull Request erstellt wird.
eventFiltern Sie nach dem Ereignis, das den Workflow ausgelöst hat (z. B. Push, pull_request).

Sie können Workflowbenachrichtigungsfilter mit dem folgenden Format konfigurieren:

Text
@GitHub Notifications subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME" event:"WORKFLOW-EVENT" branch:"BRANCH-NAME" actor:"USERNAME"}

Sie können auch mehrere Werte für jeden Filter übergeben, getrennt durch Kommas. Beispiel:

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"}

Standardmäßig werden von Dir ohne Filter konfigurierte Workflowbenachrichtigungen für durch Pull Requests ausgelöste Workflows konfiguriert, die auf Deinen Standardbranch abzielen. Sie können einen oder mehrere Einträge übergeben.

Sie können das Abonnement von Workflowbenachrichtigungen mit dem Befehl "@GitHub Notifications unsubscribe OWNER/REPO workflows" kündigen.

Hinweis

Um GitHub Actions Benachrichtigungen in Teams zu erhalten, benötigt die GitHub App zusätzliche Berechtigungen. Wenn Sie versuchen, Workflows zum ersten Mal zu abonnieren, werden Sie aufgefordert, diese Berechtigungen zu erteilen.

Bereitstellungsbenachrichtigungen

Sie können auch separate Bereitstellungsbenachrichtigungen konfigurieren. Diese Bereitstellungen können mithilfe der Bereitstellungs-API von GitHub Actions oder aus externen Quellen erfolgen. Weitere Informationen findest du unter REST-API-Endpunkte für Bereitstellungen.

Sie können Bereitstellungsbenachrichtigungen mit den folgenden Befehlen abonnieren oder kündigen:

Text
@GitHub Notifications subscribe OWNER/REPO deployments
@GitHub Notifications unsubscribe OWNER/REPO deployments

Hinweis

Wenn Sie GitHub Actions verwenden und Ihre Bereitstellungen in Umgebungen nachverfolgen möchten, wird die Funktion workflows empfohlen, da sie einen umfassenderen Überblick bietet und es Ihnen ermöglicht, Ihre Bereitstellungen direkt in Teams zu genehmigen.