Erstellen ausgehender Webhooks
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
Create eines Tunnels
Öffnen Sie Visual Studio.
Wählen Sie Create ein neues Projekt 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)>Create tunnel... 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 Create einen ausgehenden Webhook 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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für