Microsoft Teams verbinden: Schritt-für-Schritt-Anleitung
Veröffentlicht die Zusammenfassung des Testlaufs in einem Teams-Kanal und mit NEXUS_TEAMS_NOTIFY=true eine Nachricht pro fehlgeschlagenem Test. Diese Anleitung führt Sie von den ersten Schritten bis zur überprüften Verbindung und beschreibt mögliche Fehler mit ihren Ursachen und Lösungen.
Zuletzt aktualisiert:
Halten Sie Ihre Zugangsdaten geheim. Fügen Sie niemals ein Token, einen Schlüssel, ein Passwort oder eine Webhook-URL in einen Chat ein. Geben Sie diese ausschließlich unter Studio → Einstellungen → Integrationen ein. Dort werden sie in der .env-Datei Ihres Arbeitsbereichs gespeichert und als Punkte angezeigt. Das gilt auch für KI-Assistenten: Sie können Sie durch diese Anleitung führen, benötigen aber niemals Ihr Token.
Was Sie benötigen
- Ein Teams-Kanal, in dem Sie einen Workflow hinzufügen können.
- Eine Workflows-Webhook-URL für diesen Kanal.
Zugangsdaten beschaffen
- Öffnen Sie in Teams das ··· Menü des Kanals → Workflows und fügen Sie "Beim Empfang einer Webhook-Anforderung in einem Kanal posten" hinzu.
- Kopieren Sie die angegebene Webhook-URL. Sie endet auf logic.azure.com (ältere Konnektoren: webhook.office.com). Die URL selbst ist der geheime Zugangsschlüssel.
- Behalten Sie es in der Zwischenablage. Fügen Sie es ausschließlich im Studio ein (nächster Schritt).
Im Studio verbinden
- Öffnen Sie im Studio Einstellungen → Integrationen → Microsoft Teams.
- Fügen Sie die Webhook-URL ein und klicken Sie auf Speichern & Test senden. Eine Testnachricht wird an den Kanal gesendet.
- Aktivieren Sie
TEAMS_ENABLED. Für eine Nachricht pro fehlgeschlagenem Test aktivieren Sie zusätzlichNEXUS_TEAMS_NOTIFY.
Funktion überprüfen
- Testnachricht senden meldet "Gesendet." und die Nachricht erscheint im Kanal.
- Führen Sie einen beliebigen Test aus. Die Zusammenfassung des Testlaufs erscheint im Kanal.
Häufige Fehler
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| "Kein Webhook" | TEAMS_WEBHOOK_URL ist leer. | Fügen Sie die Webhook-URL unter Einstellungen → Integrationen ein und speichern Sie sie. |
"TEAMS_WEBHOOK_URL ist kein Teams-Webhook" | Der Wert ist keine https-URL auf logic.azure.com oder webhook.office.com. | Kopieren Sie die URL erneut aus dem Auslöser "Beim Empfang einer Webhook-Anforderung in einem Kanal posten" des Workflows. |
| Eine HTTP-Antwort mit Status 4xx oder 5xx von Teams | Der Workflow wurde deaktiviert oder gelöscht, oder sein Besitzer hat die Organisation verlassen oder seine Lizenz verloren, sodass er nicht mehr ausgeführt wird. | Öffnen Sie den Workflow in Teams (Workflows → Verwalten), aktivieren Sie ihn oder erstellen Sie einen neuen und speichern Sie die neue URL. |
| "Teams konnte nicht erreicht werden (ENOTFOUND)" oder "hat nicht innerhalb von 20 s geantwortet" | Dieser PC kann Microsoft nicht erreichen: wegen eines VPNs oder Proxys oder einer fehlenden Netzwerkverbindung. | Prüfen Sie die Netzwerkverbindung auf demselben PC und versuchen Sie es erneut. |
| Der Test funktioniert, aber Fehlschläge werden nicht gemeldet | TEAMS_ENABLED ist false, oder nur die Zusammenfassung des Testlaufs ist aktiviert: Nachrichten zu einzelnen Tests erfordern NEXUS_TEAMS_NOTIFY=true. | Aktivieren Sie beide Schalter. |
Konfigurationsschlüssel
| Schlüssel | Funktionsumfang | Gültiger Wert | So prüfen Sie ihn |
|---|---|---|---|
TEAMS_ENABLED | Benachrichtigungen an Microsoft Teams senden | true oder false | Aktivieren Sie diese Option, nachdem die Testnachricht eingetroffen ist. |
TEAMS_WEBHOOK_URL | Teams-Kanal für Benachrichtigungen (geheim, nur auf diesem Computer gespeichert) | Eine URL mit https://…logic.azure.com oder …webhook.office.com | Testnachricht senden veröffentlicht eine Nachricht im Kanal. |
NEXUS_TEAMS_NOTIFY | Teams-Benachrichtigung pro Fehlschlag | true oder false | Für jeden fehlgeschlagenen Test wird eine Nachricht gesendet, nicht nur die Zusammenfassung des Testlaufs. |
Mehr: alle Integrationen, die Einstellungsanleitung, Fehlerbehebung. Weitere Anleitungen: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
Kommen Sie nicht weiter? Schreiben Sie an [email protected] und geben Sie die genaue Fehlerzeile an, die das Studio anzeigt. Senden Sie kein Token mit.