Microsoft Teams-Web-Auslöser
- Zuletzt aktualisiert2026/01/13
Microsoft Teams-Web-Auslöser
Die Microsoft Teams-Web-Auslöser ermöglichen es Ihnen, Aufgaben zu automatisieren, basierend auf den Ereignissen, die in Microsoft Teams-Chat oder -Kanälen auftreten. Die Web-Auslöser überwachen bestimmte Ereignisse, die im Microsoft Teams auftreten. Sobald die Ereignisse auftreten, startet der Auslöser die konfigurierten Aktionen.
Übersicht
Die Microsoft Teams-Web-Auslöser ermöglichen es Ihnen, Auslöser basierend auf Ereignissen wie Direktnachrichten, Gruppennachrichten und Änderungen der Kanalmitgliedschaft in Microsoft Teams zu erstellen. Sie können die Auslöser verwenden, um Workflows auszulösen, sobald das Ereignis in Microsoft Teams eintritt. Dadurch verringert sich der manuelle Überwachungsaufwand und die Reaktionszeit bei kritischen Mitteilungen. Die in den Microsoft Teams-Web-Auslösern verfügbaren Optionen ermöglichen es Ihnen, auslöserbasierte Automatisierungen für Anwendungsfälle wie die Ticketzuweisung, das Extrahieren von Informationen aus beliebigen Chat-Nachrichten sowie das Starten eines E-Mail-Threads zur Benachrichtigung der Stakeholder zu erstellen.
Die Latenz zwischen dem Auftreten des Ereignisses in einer Microsoft Teams-Anwendung und dem Auslösen der Automatisierung basierend auf dem Ereignis beträgt weniger als 30 Sekunden. Wenn die Zustellung des Ereignisses an die Sitzung fehlschlägt, versucht der Auslöser automatisch, das Ereignis erneut abzurufen.
Die Microsoft Teams-Web-Auslöser bieten die Möglichkeit, Schlüsselwörter zu verwenden, um Nachrichten zu filtern. Die Option Filter ermöglicht es Ihnen, den Auslöser für Anwendungsfälle zu konfigurieren, bei denen die Automatisierung basierend auf bestimmten Schlüsselwörtern ausgelöst werden muss. Diese Option beschränkt die Ereignisantworten auf die Nachrichten, die die angegebenen Schlüsselwörter enthalten.
Der Auslöser erfasst die Nutzlastinformationen der Ereignisantwort vom Microsoft-Server in einem strukturierten JSON-Format. Diese Nutzlast enthält die Authentifizierungsinformationen, die die Validierung der Daten ermöglichen. Sie können die Antwortnutzlast auf der Seite Auditprotokoll als Schlüssel-Wert-Paare anzeigen. Sie können diese Schlüssel-Wert-Paar-Informationen als Eingaben für nachfolgende Aktionen innerhalb der Sitzung verwenden.
Authentifizierung
Die Microsoft Teams-Web-Auslöser verwenden OAuth, um die Verbindung zum Microsoft 365-Konto zu authentifizieren. Richten Sie die OAuth-Verbindung mit den für Microsoft Entra geltenden Parametern für Microsoft Teams ein. Weitere Informationen zum Einrichten von OAuth-Verbindungen finden Sie unter Herstellung der OAuth-Verbindung.
Microsoft Teams-Web-Auslöser verwenden Microsoft Azure-Zertifikate, um das Microsoft-Konto-Abonnement zu authentifizieren und die eingehenden Daten von den Microsoft-Servern zu entschlüsseln. Melden Sie sich bei Ihrem Microsoft Azure-Portal an und erstellen Sie ein Zertifikat. Weitere Informationen zum Erstellen von Zertifikaten im Microsoft Azure-Portal finden Sie unter Certificate creation methods im Microsoft Learn-Portal. Weitere Informationen zur Verwaltung von Zertifikaten finden Sie unter Managing encryption keys.
Vergewissern Sie sich, dass Sie das erstellte Zertifikat im Credential Vault hinzugefügt haben. Führen Sie folgenden Schritte aus, um die Zertifikatsdaten zum Credential Vault hinzuzufügen:
- Öffnen Sie die Zertifikatsdatei in einem beliebigen Texteditor.
- Kopieren Sie den gesamten Inhalt der Zertifikatsdatei.
- Melden Sie sich im Control Room als Administrator an.
- Wechseln Sie zu und klicken Sie auf Anmeldeinformation erstellen.
- Geben Sie einen passenden Anmeldeinformationsname und eine Beschreibung für die Anmeldeinformation ein.
- Geben Sie einen geeigneten Namen in Attributname im Abschnitt Attribute ein.
- Wählen Sie Standard und fügen Sie den Zertifikatsinhalt in das Feld Wert im Abschnitt Eingabe der Attribute ein.
- Klicken Sie auf Anmeldeinformation erstellen, um die Zertifikatsdaten im Credential Vault zu speichern.
Unterstützte Ereignisse
Die folgenden Ereignisse werden sowohl in der Einzel- als auch in der Team-Chat-Auslöserkonfiguration unterstützt:
| Ereignisse | Beschreibung |
|---|---|
| Wenn eine Chat-Nachricht hinzugefügt wird | Wenn eine neue Nachricht eintrifft. |
| Wenn eine Chat-Nachricht aktualisiert wird | Wenn eine bestehende Chat-Nachricht bearbeitet wird. |
| Wenn eine Chat-Nachricht gelöscht wird | Wenn eine vorhandene Chat-Nachricht gelöscht wird |
Die folgenden Ereignisse werden in der Konfiguration des Teammitgliedschafts-Auslösers unterstützt:
| Ereignisse | Beschreibung |
|---|---|
| Wenn ein neues Teammitglied hinzugefügt wird | Wenn Team-Eigentümer ein neues Mitglied zum ausgewählten Team hinzufügen. |
| Wenn ein Teammitglied aktualisiert wird | Wenn Team-Eigentümer die Details bestehender Teammitglieder bearbeiten. |
| Wenn ein Teammitglied entfernt wird | Wenn Team-Eigentümer ein Teammitglied aus dem ausgewählten Team entfernen. |
Voraussetzungen
Achten Sie darauf, dass die folgenden Voraussetzungen erfüllt sind:
- Eine Bot Creator- oder Citizen Developer-Lizenz.
- EREIGNISAUSLÖSER- und Meine Bots anzeigen-Berechtigungen.
- Einchecken und Auschecken-Berechtigung für die Ordner, in denen sich die Automatisierung befindet.
- Eine aktive OAuth-Verbindung für das Microsoft 365-Konto.
- Ein Microsoft Azure-Zertifikat.
Einstellungen
Die folgenden Einstellungen sind für Microsoft Teams-Web-Auslöser verfügbar:
- Control Room-OAuth-Verbindung
- Verwenden Sie die Auswählen-Option und folgen Sie den Anweisungen im OAuth-Verbindung auswählen-Modal, um die OAuth-Verbindung auszuwählen. OAuth authentifiziert die Verbindung zwischen dem Control Room und dem Microsoft 365-Konto.
- Chat
- Verwenden Sie diese Option, um den Auslöser basierend auf einzelnen Chats zu konfigurieren. Der Chatname funktioniert auf der Grundlage der E-Mail-ID des Chat-Empfängers und nicht des Anzeigenamens des Empfängers.
- Auf Ereignisse achten: Geben Sie den Ereignistyp an, auf den der Auslöser hören muss.
- Chatname: Geben Sie den Chatnamen ein. Sie können auch die Schaltfläche Chatnamen abrufen verwenden, um einen Chat über das Chat Modal auszuwählen.
- Filter: Aktivieren Sie das Kontrollkästchen und geben Sie die Schlüsselwörter ein, um die Nachrichten zu filtern.
- Teams und Kanal
-
Team-Chat: Verwenden Sie die Option Team-Chat, um den Auslöser basierend auf Nachrichten zu konfigurieren, die in einem Teams-Kanal gepostet wurden. Die folgenden Einstellungen sind für diese Option verfügbar:
- Wählen Sie ein oder mehrere Ereignisse aus Geben Sie einen oder mehrere Ereignistypen an, auf die der Auslöser reagieren muss.
- Teamname: Geben Sie den Teamnamen ein. Sie können auch die Schaltfläche Teamnamen auswählen verwenden, um das Team über das Modal Teams auszuwählen.
- Kanalname: Geben Sie den Kanalnamen ein. Sie können auch den Kanalnamen auswählen verwenden, um das Team über das Kanäle-Modal auszuwählen.
- Filter: Aktivieren Sie das Kontrollkästchen und geben Sie die Schlüsselwörter ein, um die Nachrichten zu filtern.
-
Teammitgliedschaft: Verwenden Sie die Option Teammitgliedschaft, um den Auslöser basierend auf Änderungen der Mitgliedschaft innerhalb eines Teams zu konfigurieren. Die folgenden Einstellungen sind für diese Option verfügbar:
- Optionen für Mitglieder: Geben Sie einen oder mehrere Ereignistypen an, auf die der Auslöser reagieren muss.
- Teamname: Geben Sie den Teamnamen ein. Sie können auch die Schaltfläche Teamnamen auswählen verwenden, um das Team über das Modal Teams auszuwählen.
- Zertifikat
- Verwenden Sie die Option Zertifikat, um das Zertifikat für Authentifizierung und Verschlüsselung auszuwählen.
- Anmeldedaten: Verwenden Sie die Auswählen-Option und folgen Sie den Anweisungen im Modal Anmeldeinformation auswählen, um das Microsoft Azure-Zertifikat auszuwählen, das im Credential Vault gespeichert ist.
- Unsichere Zeichenfolge: Verwenden Sie die Option Unsichere Zeichenfolge, um den Inhalt der Zertifikatdatei direkt im Eingabefeld einzugeben.
- reaktion
- Verwenden Sie die Antwort-Option, um die Auslöser-Antwortdaten in einer Datensatz-Variable zu speichern. Sie können entweder eine neue Variable erstellen oder eine vorhandene Variable auswählen, um diese Antwortdaten zu speichern.
Lesen von Auslöser-Antwortdaten in Auditprotokoll
Die Auslösedaten enthalten alle Informationen des Ereignisdatensatzes, in dem eine Änderung aufgetreten ist. Diese Antwortdaten werden im Schlüssel-Wert-Paar-Format gespeichert. Sie können diese Daten extrahieren und als Eingaben für weitere Aktionen innerhalb der Automatisierung verwenden. Sobald der Bot ausgeführt wurde, werden die Auslöserdaten als Ereignistyp Bot run by trigger im Audit-Protokoll protokolliert.