Erstellen eingehender 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. 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.

Mit einem eingehenden Webhook können externe Anwendungen Inhalte in Microsoft Teams-Kanälen freigeben. Die Webhooks werden als Tools zum Nachverfolgen und Benachrichtigen verwendet. Die Webhooks stellen eine eindeutige URL zum Senden einer JSON-Nutzlast mit einer Nachricht im Karte Format bereit. Karten sind Container der Benutzeroberfläche, die Inhalte und Aktionen im Zusammenhang mit einem einzelnen Artikel enthalten. Sie können Karten innerhalb der folgenden Funktionen verwenden:

• Bots
• Nachrichtenerweiterungen
• Connectors

Hinweis

• Der Grenzwert für die Nachrichtengröße beträgt 28 KB. Wenn die Größe 28 KB überschreitet, erhalten Sie eine Fehlermeldung. Weitere Informationen finden Sie unter Grenzwerte und Spezifikationen für Microsoft Teams.
• Wenn in einer Sekunde mehr als vier Anforderungen gestellt werden, wird die Clientverbindung gedrosselt, bis das Fenster auf die Dauer der festen Datenübertragungsrate aktualisiert wird. Eine Wiederholungslogik mit exponentiellem Backoff kann die Ratenbegrenzung für Fälle verringern, in denen Anforderungen die Grenzwerte innerhalb einer Sekunde überschreiten. Informationen dazu, wie Sie das Erreichen der Ratenbegrenzungen vermeiden, finden Sie unter HTTP 429-Antworten.

Wichtige Features eingehender Webhooks

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

Features	Beschreibung
Adaptiven Karten, die einen eingehenden Webhook verwenden	Adaptive Karten können über eingehende Webhooks gesendet werden. Weitere Informationen finden Sie unter Senden von adaptiven Karten mit eingehenden Webhooks.
Unterstützung für Aktion erfordernde Nachrichten	Aktionsfähige Nachrichtenkarten werden in allen Microsoft 365-Gruppen einschließlich Teams unterstützt. Wenn Sie Nachrichten über Karten senden, müssen Sie das Format für die eine Aktion erfordernde Nachrichtenkarte verwenden. Weitere Informationen finden Sie unter Legacy message actionable message Karte reference and message Karte playground.for more information, see Legacy actionable message Karte reference and message Karte playground.for more information, see Legacy actionable message Karte reference and message Karte 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 über einen eingehenden Webhook Nachrichten an Teams senden.
Markdown-Unterstützung	Alle Textfelder in Aktion erfordernden Nachrichtenkarten unterstützen grundlegendes Markdown. Verwenden Sie in Ihren Karten kein HTML-Markup. HTML wird ignoriert und als reiner Text behandelt.
Konfigurationsbereich	Ein eingehender Webhook wird auf Kanalebene festgelegt und konfiguriert.
Sichere Ressourcendefinitionen	Nachrichten werden als JSON-Nutzlast formatiert. Diese deklarative Nachrichtenstruktur verhindert das Einfügen von bösartigem Code.

Hinweis

• Teams-Bots, Nachrichtenerweiterungen, der eingehende Webhook und das Bot-Framework unterstützen adaptive Karten. Adaptive Karte ist ein offenes Karte Plattformframework, das auf allen Plattformen wie Windows, Android und iOS verwendet wird. Teams-Connectors unterstützen 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

Führen Sie die folgenden Schritte aus, um einem Teams-Kanal einen eingehenden Webhook hinzuzufügen:

Neues Teams

1. Wählen Sie im Neuen Teams-Client Teams aus, und navigieren Sie zu dem Kanal, in dem Sie einen eingehenden Webhook hinzufügen möchten.

2. Wählen Sie auf der rechten Seite des Kanalnamens Weitere Optionen ••• aus.

3. Wählen Sie Kanal verwalten aus.

   

   Für Mitglieder, die keine Administratoren des Kanals sind, ist die Option Kanal verwalten unter der Option Kanaldetails öffnen in der oberen rechten Ecke eines Kanals verfügbar.

   

4. Wählen Sie Bearbeiten aus.

   

5. Suchen Sie nach Eingehender Webhook und wählen Sie Hinzufügen aus.

   

   Das Dialogfeld Eingehender Webhook wird angezeigt.

6. Klicken Sie auf Hinzufügen.

   

   Hinweis

   Wenn Sie bereits einen eingehenden Webhook hinzugefügt haben, wird die Option Konfigurieren angezeigt. Wählen Sie Konfigurieren aus, um einen eingehenden Webhook zu erstellen.

7. Geben Sie einen Namen für den Webhook an, und laden Sie bei Bedarf ein Bild hoch.

8. Wählen Sie Erstellen aus.

   

9. Kopieren und speichern Sie die eindeutige Webhook-URL, die im Dialogfeld vorhanden ist. Die URL ist dem Kanal zugeordnet, und Sie können sie verwenden, um Informationen an Teams zu senden.

10. Wählen Sie Fertig aus. Der Webhook ist jetzt im Teams-Kanal verfügbar.

    

Die folgende grafische Darstellung enthält die Schritte zum Erstellen eines eingehenden Webhooks:

Klassisches Teams

1. Wählen Sie im klassischen Teams-Client Teams aus, und navigieren Sie zu dem Kanal, dem Sie einen eingehenden Webhook hinzufügen möchten.

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

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

   

4. Suchen Sie nach Eingehender Webhook und wählen Sie Hinzufügen aus.

   

   Das Dialogfeld Eingehender Webhook wird angezeigt.

5. Klicken Sie auf Hinzufügen.

   

   Hinweis

   Wenn Sie bereits einen eingehenden Webhook hinzugefügt haben, wird die Option Konfigurieren angezeigt. Wählen Sie Konfigurieren aus, um einen eingehenden Webhook zu erstellen.

6. Geben Sie einen Namen für den Webhook an, und laden Sie bei Bedarf ein Bild hoch.

7. Wählen Sie Erstellen aus.

   

8. Kopieren und speichern Sie die eindeutige Webhook-URL, die im Dialogfeld vorhanden ist. Die URL ist dem Kanal zugeordnet, und Sie können sie verwenden, um Informationen an Teams zu senden.

9. Wählen Sie Fertig aus.

   

Der Webhook ist jetzt im Teams-Kanal verfügbar.

Wichtig

Sie können eine Teams-App für Benachrichtigungsbots mit einem anderen Teams Toolkit als einem eingehenden Webhook 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.

Sie können Aktionen erfordernde Nachrichten über einen eingehenden Webhook oder Connector für Microsoft 365-Gruppen erstellen und senden. Weitere Informationen finden Sie unter Erstellen und Senden von Nachrichten.

Hinweis

Wählen Sie in Teams Einstellungen>Mitgliederberechtigungen>Mitgliedern das Erstellen, Aktualisieren und Entfernen von Connectors erlauben aus, damit jedes Teammitglied einen Connector hinzufügen, ändern oder löschen kann.

Beispiel

C#

Beispielcodereferenz

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

JavaScript

Beispielcodereferenz

var formatted_Card_Payload = {
        "type": "message",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "contentUrl": null,
                "content": {
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "type": "AdaptiveCard",
                    "version": "1.2",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

Entfernen eingehender Webhooks

Führen Sie die folgenden Schritte aus, um einen eingehenden Webhook aus einem Teams-Kanal zu entfernen:

Neues Teams

1. Wählen Sie im Neuen Teams-Client das Teams-Symbol aus, und navigieren Sie zu dem Kanal, in dem Sie einen eingehenden Webhook entfernen möchten.

2. Wählen Sie auf der rechten Seite des Kanalnamens Weitere Optionen ••• aus.

3. Wählen Sie Kanal verwalten aus.

   

4. Wählen Sie Bearbeiten aus.

   

5. Wählen Sie im linken Bereich Konfiguriert aus.

6. Wählen Sie unter Eingehender Webhook die Option 1 Konfiguriert aus.

   

7. Wählen Sie Verwalten aus.

   

8. Wählen Sie Entfernen aus.

   

   Das Dialogfeld Konfiguration entfernen wird angezeigt.

9. Aktivieren Sie die erforderlichen Kontrollkästchen.

10. Wählen Sie Entfernen aus.

    

Der Webhook wurde jetzt aus dem Teams-Kanal entfernt.

Klassisches Teams

1. Wählen Sie im klassischen Teams-Client das Teams-Symbol aus, und navigieren Sie zu dem Kanal, in dem Sie einen eingehenden Webhook entfernen möchten.

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

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

4. Wählen Sie im linken Bereich Konfiguriert aus.

5. Wählen Sie unter Eingehender Webhook die Option 1 Konfiguriert aus.

   

6. Wählen Sie Verwalten aus.

   

7. Wählen Sie Entfernen aus.

   

   Das Dialogfeld Konfiguration entfernen wird angezeigt.

8. Aktivieren Sie die erforderlichen Kontrollkästchen.

9. Wählen Sie Entfernen aus.

   

Der Webhook wurde jetzt aus dem Teams-Kanal entfernt.

Codebeispiel

Beispielname	Beschreibung	.NET	Node.js
Eingehender Webhook	In diesem Beispiel wird gezeigt, wie Sie einen eingehenden Webhook implementieren und verwenden.	View	Anzeigen

Siehe auch

• Erstellen ausgehender Webhooks
• Erstellen von Bots für Teams
• Nachrichtenerweiterungen
• Integrieren von Web-Apps
• Von Web-Apps für Teams freigeben