Erstellen von Webhooks und Connectors

  • Artikel

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

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.

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.

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.

Benachrichtigungsbot oder eingehender Webhook

Bevor Sie mit dem Erstellen eingehender Webhooks beginnen, sollten Sie auch wissen, dass Sie einen Benachrichtigungsbot mithilfe des Teams Toolkits erstellen können. Benachrichtigungs-Bots können eine besser anpassbare Benutzeroberfläche für verschiedene Geschäftsszenarien ermöglichen.

Erfahren Sie mehr über die Unterschiede zwischen einem Benachrichtigungsbot und eingehendem Webhook, damit Sie die richtigen Lösungen für Ihre Szenarien auswählen können:

  Benachrichtigungsbot Eingehender Webhook
Was ist das? Eine Teams-App Ein Teams-Feature
Installation erforderlich Ja Nein
Geeignete Szenarien • 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 • Teams-Kanal
• Gruppenchat
• Persönlicher Chat		 Teams channel
Nachrichtenprozess 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 Der Benachrichtigungsbot kann Teams-Kontext abrufen, z. B. Kanal- oder Benutzerinformationen, Nachrichten usw. Nein
Adaptive Karte senden Ja Ja
Senden einer Begrüßungsnachricht Ja Nein
Trigger 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 • Ü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 Azure Bot Framework Es sind keine Ressourcen erforderlich.
Lernprogramm 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.

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.

Nächster Schritt

Erstellen ausgehender Webhooks

Siehe auch