Erstellen ausgehender Webhooks
Wichtig
Microsoft 365-Connectors (früher Office 365 Connectors genannt) werden bald eingestellt, und die Erstellung neuer Microsoft 365-Connectors wird bald blockiert. Weitere Informationen zum Zeitplan und dazu, wie die Workflows-App eine flexiblere und sicherere Erfahrung bietet, finden Sie unter Einstellung von Microsoft 365-Connectors in Microsoft Teams.
Wie können Sie einen Webhook in Teams erstellen?
Um beim Empfang einer Webhookanforderung automatisch in einem Chat oder Kanal zu posten, verwenden Sie die vordefinierten Workflowvorlagen, oder erstellen Sie einen Workflow von Grund auf neu, indem Sie den Trigger Beim Empfang einer Teams-Webhookanforderung verwenden. Weitere Informationen finden Sie unter Posten eines Workflows, wenn eine Webhookanforderung in Microsoft Teams empfangen wird.
Weitere Informationen zum Trigger Beim Empfang einer Teams-Webhookanforderung finden Sie unter Microsoft Teams – Webhook.
Wenn Sie bereits Office 365 Connectors erstellt haben:
Erstellen eines Power Automate-Connectors: Power Automate verbessert die weit verbreiteten Workflows-Apps in Teams. Dies ist der skalierbare und sichere Ansatz zum programmgesteuerten Übertragen von Daten in und aus Teams. Wenn Sie diese Methode verwenden, können Sie Workflowvorlagen zum Veröffentlichen von Warnungen aus Ihrem Produkt in Teams-Kanälen erstellen. Dieser Ansatz vereinfacht die Benutzereinführung der neuen Methode. Weitere Informationen finden Sie unter Power Automate für Unternehmensentwickler, ISVs und Partner.
Aktualisieren Ihrer Teams-App: Sie können Ihre aktuelle Teams-App verbessern. Beispielsweise können Sie Benutzern ermöglichen, proaktive Nachrichten basierend auf Triggerereignissen in Ihrem System einzurichten. Weitere Informationen finden Sie unter Wie Bots über proaktive Nachrichten in Kanälen posten können.
Bekannte Probleme
- Die Workflows-App kann keine Beiträge in privaten Kanälen als Flow-Bot bereitstellen. Es kann jedoch im Namen eines Benutzers posten.
- Workflows unterstützen nur adaptive Karten. Das ältere Nachrichtenformat Karte, das Office 365 Connectors verwenden, wird nicht unterstützt. Workflows unterstützen die Verwendung des Nachrichtenformats Karte nicht. Weitere Informationen finden Sie unter Konvertieren von Connectornachrichten Karte Format in adaptive Karte.
- Workflows bieten keine Connectors von Drittanbietern wie DataDog und Jenkins an.
- Workflows können nur in Ihrer Standardumgebung erstellt werden.
Einschränkungen
Workflows sind nur mit bestimmten Benutzern (als Besitzer des Workflows bezeichnet) und nicht mit einem Teams-Team oder -Kanal verknüpft. Workflows können verwaiste Flows werden, wenn kein Besitzer vorhanden ist, wenn keine Mitbesitzer zugewiesen sind. Um die Kontinuität im durch den Flow automatisierten Geschäftsprozess zu gewährleisten, können Administratoren einen oder mehrere Mitbesitzer hinzufügen und ihnen die vollständige Kontrolle über den Workflow gewähren. Sie können ggf. auch die Authentifizierung für Verbindungen hinzufügen und den Flow aktivieren, wenn er deaktiviert wurde. Weitere Informationen finden Sie unter Verwalten verwaister Flows.
Webhooks helfen Microsoft Teams bei der Integration in externe Apps. In Teams fungieren die ausgehenden Webhooks als Bot und suchen mithilfe von @Erwähnung nach Nachrichten in Kanälen. Mit den ausgehenden Webhooks können Benutzer Nachrichten an Webdienste senden, ohne den gesamten Prozess zum Erstellen von Bots über Microsoft Bot Framework durchzuführen. Die ausgehenden Webhooks stellen Daten aus Teams an einen beliebigen Dienst bereit, der JSON-Nutzlasten akzeptieren kann.
Wichtige Features von ausgehenden Webhooks
- Senden von Benachrichtigungen an einen externen Webdienst.
- Antworten Sie mit Rich-Text-Nachrichten, einschließlich Karten und Bildern.
- Empfangen von Nachrichten in öffentlichen Kanälen und nicht innerhalb des persönlichen oder privaten Bereichs.
- Senden Sie HTTP POST an den Webdienst, und erhalten Sie eine Antwort.
Hinweis
Die ausgehenden Webhooks können nicht auf andere APIs zugreifen, z. B. die Liste oder die Liste der Kanäle in einem Team abrufen.
Diese Schritt-für-Schritt-Anleitung hilft Ihnen beim Erstellen ausgehender Webhooks in Teams. Die folgende Ausgabe wird angezeigt:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools installieren und Ihre Entwicklungsumgebung einrichten:
| Installieren | Zum Benutzen... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams für die Zusammenarbeit mit allen, mit denen Sie arbeiten, über Apps für Chats, Besprechungen und Anrufe an einem Ort. | |
| Visual Studio 2022 | Sie können die Unternehmensversion in Visual Studio 2022 und die Workloads ASP.NET und Webentwicklung installieren. Verwenden Sie die neueste Version. | |
| Entwicklungstunnel | Teams-App-Features (Konversationsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Dev Tunnel ist ein leistungsstarkes Tool, um Ihren Localhost sicher für das Internet zu öffnen und zu steuern, wer Zugriff hat. Dev Tunnel ist in Visual Studio 2022 Version 17.7.0 oder höher verfügbar. Oder Sie können ngrok auch als Tunnel verwenden, um Ihr Entwicklungssystem mit Teams zu verbinden. Dies ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mit npm devDependencies). |
Hinweis
Nachdem Sie ngrok heruntergeladen haben, registrieren Sie sich, und installieren Sie authtoken.
Einrichten einer lokalen Umgebung
Öffnen Sie Microsoft-Teams-Samples.
Wählen Sie Code aus.
Wählen Sie im Dropdownmenü Mit GitHub Desktop öffnen aus.
Wählen Sie Klonen aus.
Erstellen ausgehender Webhooks
Erstellen eines Tunnels
Öffnen Sie Visual Studio.
Wählen Sie Neues Projekt erstellen aus.
Geben Sie im Suchfeld ASP.NET ein. Wählen Sie in den Suchergebnissen ASP.NET Core-Web-App aus.
Wählen Sie Weiter aus.
Geben Sie Projektname ein , und wählen Sie Weiter aus.
Wählen Sie Erstellen aus.
Ein Übersichtsfenster wird angezeigt.
Wählen Sie in der Dropdownliste Debug die Option Dev Tunnels (kein aktiver Tunnel)>Tunnel erstellen... aus.
Ein Popupfenster wird geöffnet.
Aktualisieren Sie die folgenden Details im Popupfenster:
- Konto: Geben Sie ein Microsoft- oder GitHub-Konto ein.
- Name: Geben Sie einen Namen für Ihren Tunnel ein.
- Tunneltyp: Wählen Sie in der Dropdownliste die Option Temporär aus.
- Zugriff: Wählen Sie in der Dropdownliste Öffentlich aus.
Wählen Sie OK aus.
Ein Popupfenster wird angezeigt, in dem angezeigt wird, dass der Entwicklungstunnel erfolgreich erstellt wurde.
Wählen Sie OK aus.
Sie finden den tunnel, den Sie erstellt haben, in der Debug-Dropdownliste wie folgt:
Wählen Sie F5 aus, um die Anwendung im Debugmodus auszuführen.
Wenn ein Dialogfeld Sicherheitswarnung angezeigt wird, wählen Sie Ja aus.
Ein Popupfenster wird geöffnet.
Wählen Sie Weiter.
Die Dev Tunnel-Startseite wird in einem neuen Browserfenster geöffnet, und der Entwicklungstunnel ist jetzt aktiv.
Wechseln Sie zu Visual Studio, und wählen Sie Ausgabe anzeigen >aus.
Wählen Sie im Dropdownmenü Ausgabekonsoledie Option Dev Tunnels aus.
In der Ausgabekonsole wird die Dev Tunnel-URL angezeigt.
Wechseln Sie zu Teams , und wählen Sie im linken Bereich Teams aus.
Wechseln Sie zu einem gewünschten Team, wählen Sie Weitere Optionen (••) und dann Team verwalten aus.
Wählen Sie in der Navigationsleiste die Registerkarte Apps aus.
Wählen Sie in der unteren rechten Ecke des Fensters ausgehenden Webhooks erstellen aus.
Geben Sie die folgenden Details ein:
Name: Der Webhooktitel auf der @mention Registerkarte.
Rückruf-URL: Die von ngrok generierte URL, die JSON-Nutzlasten akzeptiert und POST-Anforderungen von Teams empfängt. Gehen Sie wie folgt vor, um oder
api/Sampleapi/authenticatedSamplezu verwenden:Kopieren Sie für ein API-Beispiel die
dev tunnelURL oderngrokdie URL, fügen Sie sie ein, und fügen Sie sie mit/api/samplean.Kopieren Sie für api authenticatedSample die
dev tunnelURL oderngrokdie URL, fügen Sie sie ein, und fügen Sie sie mit/authenticatedSample?id=contosoan.
Beschreibung: Eine ausführliche Zeichenfolge, die im Profil Karte und der Dashboard auf Teamebene angezeigt wird.
Profilbild (optional): App-Symbol für Ihren Webhook.
Wählen Sie Erstellen aus. Der ausgehende Webhook wird dem Kanal des aktuellen Teams hinzugefügt.
Ein
Hash-based Message Authentication Code (HMAC)Dialogfeld wird angezeigt. Sie können das Sicherheitstoken in AuthProvider.cs Datei verwenden, um Anrufe zwischen Teams und allen bestimmten externen Diensten zu authentifizieren.Hinweis
Der ausgehende Webhook ist nur für die Benutzer des Teams verfügbar, wenn die URL gültig ist und die Server- und Clientauthentifizierungstoken gleich sind. Beispielsweise ein HMAC-Handshake.
Erstellen und Ausführen des Diensts
Öffnen Sie Visual Studio.
Wechseln Sie zu Datei>Projekt>/Projektmappe öffnen....
Wählen Sie im Ordner csharpWebhookSampleBot.sln Datei aus.
Wechseln Sie zu AuthProvider.cs Datei. Aktualisieren
contosoSie auf ,M365x70471008und fügen Sie HMAC hinzu.
Press F5 to run the project.
Wählen Sie Ja aus, wenn das folgende Dialogfenster angezeigt wird:
Auf einer Webseite werden lokale Hostinformationen angezeigt.
Interagieren mit der App in Teams
Wechseln Sie zu Teams , und wählen Sie im linken Bereich Teams aus.
Wechseln Sie zu Allgemein>Neue Unterhaltung.
Um einen ausgehenden Webhook im Kanal aufzurufen, @Erwähnung den Namen des ausgehenden Webhooks, und wählen Sie das Symbol Senden aus.
Hinweis
Sie können adaptive Karten, Herokarten und SMS als Anlage mit ausgehendem Webhook senden.
Der Besprechungschat zeigt eine neue Nachricht an.
Abschließen der Herausforderung
Haben Sie sich so etwas einfallen lassen?
Herzlichen Glückwunsch!
Sie haben das Tutorial für die ersten Schritte mit einer ausgehenden Webhook-App abgeschlossen.
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.