Erstellen von Webhooks und Connectors
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. Die Unterstützung für die Verwendung des Nachrichtenformats Karte in Workflows wird ab Mitte Oktober verfügbar. 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 und Connectors helfen beim Verbinden der Webdienste mit Kanälen und Teams in Microsoft Teams. Webhooks sind benutzerdefinierte HTTP-Rückrufe, mit denen Benutzer über aktionen benachrichtigt werden, die im Teams-Kanal ausgeführt wurden. Dies ist eine Möglichkeit für eine App, Echtzeitdaten abzurufen. Connectors ermöglichen Benutzern, Benachrichtigungen und Nachrichten von Ihren Webdiensten zu abonnieren. Sie stellen einen HTTPS-Endpunkt für Ihren Dienst bereit, um Nachrichten in Form von Karten zu posten.
Wichtig
Webhooks und Connectors sind nur in GCC-Umgebungen (Government Community Cloud) verfügbar, aber nicht in GCC-High- und DOD-Umgebungen (Department of Defense).
Nur der Connectortyp eingehender Webhook ist in GCC-High Umgebung verfügbar, und die Mandantenadministratoren müssen manuell hochladen, um die App auf der Seite Connectors anzuzeigen.
Sie können die Teams-App des Benachrichtigungsbots als eingehende Webhooks erstellen. Sie funktionieren ähnlich, aber der Benachrichtigungsbot verfügt über mehr Funktionen. Weitere Informationen finden Sie unter Erstellen eines Benachrichtigungsbots mit JavaScript oder Beispiel für eingehende Webhookbenachrichtigungen. Laden Sie zunächst das Teams-Toolkit herunter, und erkunden Sie es. Weitere Informationen finden Sie unter Teams Toolkit-Dokumente.
Ausgehende Webhooks
Webhooks hilft Teams bei der Integration in externe Apps. Mit ausgehenden Webhooks können Sie Textnachrichten von einem Kanal an einen Webdienst senden. Nach dem Konfigurieren der ausgehenden Webhooks können @mention Benutzer ausgehenden Webhook senden und eine Nachricht an einen Webdienst senden. Der Dienst antwortet innerhalb von 10 Sekunden mit einem TEXT oder einem Karte auf die Nachricht. Weitere Informationen finden Sie unter Erstellen ausgehender Webhooks.
Hinweis
Ausgehende Webhooks werden pro Team konfiguriert und können nicht als Teil einer normalen Teams-App eingeschlossen werden.
Connectors
Connectors ermöglichen Benutzern das Abonnieren von Benachrichtigungen und Nachrichten von den Webdiensten. Sie machen den HTTPS-Endpunkt für den Dienst verfügbar, um Nachrichten in Teams Kanälen zu posten, in der Regel in Form von Karten.
Hinweis
Connectors können keine Nachrichten aktualisieren oder Nachrichten als Antworten auf vorhandene Nachrichten senden.
Eingehende Webhooks
Eingehende Webhooks helfen beim Veröffentlichen von Nachrichten aus Apps in Teams. Wenn eingehende Webhooks für ein Team in einem beliebigen Kanal aktiviert sind, wird der HTTPS-Endpunkt verfügbar gemacht, der ordnungsgemäß formatierten JSON-Code akzeptiert und die Nachrichten in diesen Kanal einfügt. Sie können z. B. einen eingehenden Webhook in Ihrem DevOps-Kanal erstellen, Ihren Build konfigurieren und gleichzeitig Dienste bereitstellen und überwachen, um Warnungen zu senden. Weitere Informationen finden Sie unter Erstellen eingehender Webhooks.
Benachrichtigungsbot oder eingehender Webhook
Bevor Sie mit dem Erstellen eingehender Webhooks beginnen, sollten Sie auch wissen, dass Sie mithilfe des Teams Toolkits einen Benachrichtigungsbot erstellen oder Aktivitätsfeedbenachrichtigungen mithilfe von Microsoft Graph-API senden können. Benachrichtigungsbots und Aktivitätsfeedbenachrichtigungen können eine besser anpassbare Umgebung für verschiedene Geschäftsszenarien ermöglichen. Weitere Informationen finden Sie unter Planen des Sendens von App-Benachrichtigungen.
| Benachrichtigungs-API | Benachrichtigungsbot | Eingehender Webhook | |
|---|---|---|---|
| Was ist das? | Eine RESTful-Web-API | Eine Teams-App | Ein Teams-Feature |
| Installation erforderlich | Ja | Ja | Nein |
| Geeignete Szenarien | • Benachrichtigen Sie Benutzer über dringende oder kritische Informationen. • Zeigen Sie umfangreiche Inhalte an, die eine Benutzeraktion im bereich Standard von Teams erfordern. • Erhalten Sie eine Benachrichtigung des Betriebssystems mit Sound. • Lokalisierter Vorschautext in Aktivität. |
• Regelmäßiges Empfangen von Benachrichtigungen und Nachrichten in regelmäßigen Abständen, z. B. tägliche Benachrichtigungen über Teamaufgaben. • Empfangen von Benachrichtigungen und Nachrichten basierend auf realen Ereignissen. Wenn Teamkollegen beispielsweise Dateien hochladen, erhalten Sie Benachrichtigungen. |
Kommunizieren Sie mit externen Apps und empfangen Sie Benachrichtigungen und Nachrichten von anderen Apps. |
| Bereichskonfiguration | • Ein einzelner Benutzer • Eine Liste der Benutzer • Benutzer in einem Chat • Benutzer in einem Team |
• Teams-Kanal • Gruppenchat • Persönlicher Chat |
Teams channel |
| Nachrichtenprozess | Eine Teams-App führt einen REST-API-Aufruf aus, um eine Benachrichtigung in Aktivität in Teams auszulösen. Der API-Aufruf übergibt den Deep-Link, um Inhalt in den bereich Standard zu laden. | Ein Benachrichtigungsbot funktioniert als Teams-Anwendung. Sie können Ihre Geschäftslogik definieren, um Daten zu verarbeiten und Daten in einem angepassten Format anzuzeigen. | Webhook ist ein Teams-Feature und keine Teams-Anwendung, sodass er nur Daten ohne Verarbeitung empfängt und anzeigt. |
| Abrufen des Teams-Kontexts | Die App kann Graph-APIs verwenden, um mit Microsoft 365-Daten zu arbeiten. | Der Benachrichtigungsbot kann Teams-Kontext abrufen, z. B. Kanal- oder Benutzerinformationen und -nachrichten. | Nein |
| Adaptive Karte senden | Nein | Ja | Ja |
| Senden einer Begrüßungsnachricht | Ja | Ja | Nein |
| Trigger unterstützt | Alle Trigger werden unterstützt. | Alle Trigger werden unterstützt. Wenn Sie das Teams-Toolkit verwenden, können Sie schnell ein Vorlagenprojekt mit den folgenden Triggern abrufen: • Zeittrigger, der in Azure-Funktionen gehostet wird. • Restify HTTP-Trigger, der in Azure App Service gehostet wird. • HTTP-Trigger, der auf Azure Functions gehostet wird. |
Alle Trigger werden unterstützt. |
| Erstellen von Tools | Schnellstart : Microsoft Graph | • Übersicht über das Teams-Toolkit für Visual Studio Code • Übersicht über das Teams-Toolkit für Visual Studio • Teams Toolkit CLI • TeamsFx SDK |
Es sind keine Tools erforderlich. |
| Cloudressource erforderlich | Microsoft Entra-App | Azure Bot Framework | Es sind keine Ressourcen erforderlich. |
| Lernprogramm | • Senden von Aktivitätsfeedbenachrichtigungen an Benutzer in Microsoft Teams • Aktivitätsfeedbenachrichtigung senden |
Erstellen eines Benachrichtigungsbots mit JavaScript | Beispiel für eingehende Webhookbenachrichtigungen |
Connectors für Microsoft 365-Gruppen
Connectors für Microsoft 365-Gruppen ermöglichen es Ihnen, eine benutzerdefinierte Konfigurationsseite für Ihren eingehenden Webhook zu erstellen und als Teil einer Teams-App zu verpacken. Sie senden Nachrichten in erster Linie mithilfe von Connectorkarten für Microsoft 365-Gruppen und können ihnen einen begrenzten Satz von Karte Aktionen hinzufügen. Ein Beispiel hierfür ist ein Wetterconnector, mit dem Benutzer einen Standort auswählen und zu jeder Tageszeit Updates über das Wetter von morgen erhalten können. Sie werden auf Kanalebene konfiguriert, aber auf Teamebene installiert. Weitere Informationen finden Sie unter Erstellen von Connectors für Microsoft 365-Gruppen.
Hinweis
Sie können den Connector für Microsoft 365-Gruppen Teams-App an unseren AppStore verteilen.
Nachrichten erstellen und senden
Nachrichten mit Aktionen ermöglichen es Benutzern, Maßnahmen zu ergreifen, ohne ihren E-Mail-Client zu verlassen, was die Benutzereinbindung erhöht. Mit Microsoft 365 und eingehenden Webhooks können Sie Nachrichten senden, indem Sie eine JSON-Nutzlast an die Webhook-URL senden. Weitere Informationen finden Sie unter Erstellen und Senden von Nachrichten.