Erstellen eines eingehenden Webhooks

Mit eingehendem Webhook können externe Apps Inhalte in Teams Kanälen freigeben. Diese Webhooks werden als Tracking- und Benachrichtigungstools verwendet. Sie stellen eine eindeutige URL bereit, an die Sie eine JSON-Nutzlast mit einer Nachricht im Kartenformat senden. Karten sind Benutzeroberflächencontainer, die Inhalte und Aktionen im Zusammenhang mit einem einzelnen Thema enthalten. Teams Karten in den folgenden Funktionen verwenden:

  • Bots
  • Messaging-Erweiterungen
  • Connectors

Wichtige Features des eingehenden Webhooks

Die folgende Tabelle enthält die Features und die Beschreibung des eingehenden Webhooks:

Features Beschreibung
Adaptive Karten mit einem eingehenden Webhook Adaptive Karten können über eingehende Webhooks gesendet werden. Weitere Informationen finden Sie unter Senden adaptiver Karten mit eingehenden Webhooks.
Unterstützung für Aktion erfordernde Nachrichten Aktion erfordernde Nachrichtenkarten werden in allen Office 365-Gruppen einschließlich Microsoft Teams unterstützt. Wenn Sie Nachrichten über Karten senden, müssen Sie das Kartenformat für Aktionen erfordernde Nachrichten verwenden. Weitere Informationen finden Sie unter Legacy-Referenz für Nachrichtenkarten mit Aktionen und Nachrichtenkarten-Playground.
Unabhängige HTTPS-Messaging-Unterstützung Karten stellen Informationen klar und konsistent bereit. Jedes Tool oder Framework, das HTTPS POST-Anforderungen senden kann, kann Nachrichten über einen eingehenden Webhook an Teams senden.
Markdown-Unterstützung Alle Textfelder in Aktion erfordernden Nachrichtenkarten unterstützen grundlegendes Markdown. Verwenden Sie kein HTML-Markup in Ihren Karten. HTML wird ignoriert und als reiner Text behandelt.
Bereichskonfiguration Eingehender Webhook ist auf Kanalebene beschränkt und konfiguriert.
Sichere Ressourcendefinitionen Nachrichten werden als JSON-Nutzlast formatiert. Diese deklarative Messagingstruktur verhindert das Einfügen von schädlichem Code.

Hinweis

  • Teams Bots, Messaging-Erweiterungen, eingehender Webhook und bot Framework unterstützen adaptive Karten. Adaptive Karten sind ein offenes kartenübergreifendes Plattformframework, das auf allen Plattformen wie Windows, Android, iOS usw. verwendet werden kann. Derzeit unterstützen Teams Connectors keine adaptiven Karten. Es ist jedoch möglich, einen Fluss zu erstellen, der adaptive Karten an einen Teams-Kanal sendet.
  • Weitere Informationen zu Karten und Webhooks finden Sie unter Adaptive Karten und eingehende Webhooks.

Erstellen eines eingehenden Webhooks

So fügen Sie einem Teams Kanal einen eingehenden Webhook hinzu

  1. Wechseln Sie zu dem Kanal, in dem Sie den Webhook hinzufügen möchten, und wählen Sie ••• Weitere Optionen in der oberen Navigationsleiste aus.

  2. Wählen Sie connectors aus dem Dropdownmenü aus:

    Connector auswählen

  3. Suchen Sie nach eingehendem Webhook, und wählen Sie "Hinzufügen" aus.

  4. Wählen Sie "Konfigurieren", geben Sie einen Namen an, und laden Sie bei Bedarf ein Bild für Ihren Webhook hoch:

    Schaltfläche "Konfigurieren"

  5. Im Dialogfeld wird eine eindeutige URL angezeigt, die dem Kanal zugeordnet ist. Kopieren und speichern Sie die Webhook-URL, um Informationen an Microsoft Teams zu senden und "Fertig" auszuwählen:

    Eindeutige URL

Der Webhook ist im Teams Kanal verfügbar.

Hinweis

Wählen Sie in Teams Einstellungen > Mitgliedsberechtigungen aus, damit Mitglieder Connectors > erstellen, aktualisieren und entfernen können, damit jedes Teammitglied einen Connector hinzufügen, ändern oder löschen kann.

Entfernen des eingehenden Webhooks

So entfernen Sie einen eingehenden Webhook aus einem Teams Kanal

  1. Wechseln Sie zum Kanal.

  2. Wählen Sie in der oberen Navigationsleiste ••• Weitere Optionen aus.

  3. Wählen Sie im Dropdownmenü Connectors aus.

  4. Wählen Sie auf der linken Seite unter Verwalten die Option "Konfiguriert" aus.

  5. Wählen Sie die < 1> Konfiguriert aus, um eine Liste Ihrer aktuellen Connectors anzuzeigen:

    Konfigurierter Webhook

  6. Wählen Sie neben dem Connector, den Sie entfernen möchten, die Option "Verwalten" aus:

    Verwalten von Webhook

  7. Wählen Sie "Entfernen" aus:

    Entfernen von Webhook

    Das Dialogfeld Konfiguration entfernen wird angezeigt:

    Entfernen der Konfiguration

  8. Füllen Sie die Felder und Kontrollkästchen des Dialogfelds aus, und wählen Sie "Entfernen" aus:

    Endgültiges Entfernen

    Der Webhook wird aus dem Teams-Kanal entfernt.

Weitere Informationen