Teilen über


Erstellen ausgehender Webhooks

Der ausgehende Webhook fungiert als Bot und sucht mithilfe von @mention in Kanälen nach Nachrichten. Er sendet Benachrichtigungen an einen externen Webdienst und antwortet mit umfangreichen Nachrichten, die Karten und Bilder enthalten. Es hilft, den Erstellungsprozess von Bots über die Microsoft Bot Framework zu überspringen.

Im folgenden Video erfahren Sie, wie Sie ausgehende Webhooks erstellen:


Wichtige Features von ausgehenden Webhooks

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

Features Beschreibung
Konfigurationsbereich Webhooks werden auf Teamebene definiert. Der obligatorische Setupprozess für jeden fügt einen ausgehenden Webhook hinzu.
Reaktives Messaging Benutzer müssen @mention verwenden, damit der Webhook Nachrichten empfangen kann. Die Benutzer können einen ausgehenden Webhook nur in öffentlichen Kanälen und nicht innerhalb des persönlichen oder privaten Bereichs senden.
Standard-HTTP-Nachrichtenaustausch Antworten werden in derselben Kette wie die ursprüngliche Anforderungsnachricht angezeigt und können beliebige Bot Framework-Nachrichteninhalte enthalten. Beispielsweise Rich-Text, Bilder, Karten und Emojis. Ausgehende Webhooks können zwar Karten, jedoch keine Kartenaktionen (mit Ausnahme von openURL) verwenden.
Unterstützung der Teams-API-Methode Ausgehende Webhooks senden einen HTTP POST an einen Webdienst und erhalten eine Antwort. Sie können nicht auf andere APIs zugreifen, um z. B. die Liste oder die Liste der Kanäle in einem Team abzurufen.

Erstellen ausgehender Webhooks

Erstellen Sie ausgehende Webhooks, und fügen Sie Benutzerdefinierte Bots zu Teams hinzu. Folgen Sie diesen Schritten, um einen ausgehenden Webhook zu erstellen:

  1. Wählen Sie im linken Bereich Teams aus.

    Screenshot des linken Bereichs mit dem Teams-Symbol.

  2. Wählen Sie auf der Seite Teams das erforderliche Team aus, um einen ausgehenden Webhook zu erstellen, und wählen Sie ••• aus.

  3. Wählen Sie im Dropdownmenü Team verwalten aus.

    Screenshot: Option

  4. Wählen Sie auf der Kanalseite Apps aus.

    Screenshot: Registerkarte

  5. Wählen Sie Ausgehenden Webhook erstellen aus.

    Screenshot: Option

  6. Geben Sie auf der Seite Ausgehenden Webhook erstellen die folgenden Details ein:

    • Name: Der Webhooktitel und @mention Registerkarte.
    • Rückruf-URL: Der HTTPS-Endpunkt, der JSON-Nutzlasten akzeptiert und POST-Anforderungen von Teams empfängt.
    • Beschreibung: Eine detaillierte Zeichenfolge, die auf der Profilkarte und im App-Dashboard auf Teamebene angezeigt wird.
    • Profilbild: Ein App-Symbol für Ihren Webhook, das optional ist.
  7. Wählen Sie Erstellen aus. Der ausgehende Webhook wird dem Kanal des Teams hinzugefügt.

    Screenshot: Schaltfläche

Ein Dialogfeld hashbasierter Nachrichtenauthentifizierungscode (HMAC) wird angezeigt. Es handelt sich um ein Sicherheitstoken, das zum Authentifizieren von Aufrufen zwischen Teams und dem angegebenen externen Dienst verwendet wird. Das HMAC-Sicherheitstoken läuft nicht ab und ist für jede Konfiguration eindeutig.

Hinweis

Der ausgehende Webhook steht den Benutzern des Teams nur zur Verfügung, wenn die URL gültig ist und die Server- und Clientauthentifizierungstoken gleich sind. Beispielsweise ein HMAC-Handshake.

Das folgende Szenario enthält die Details zum Hinzufügen eines ausgehenden Webhooks:

  • Szenario: Pushen von Änderungsstatusbenachrichtigungen auf einem Teams-Kanaldatenbankserver an Ihre App.
  • Beispiel: Sie verfügen über eine benutzerdefinierte App, die für Ihre Organisation (LOB-App) erstellt wurde, die alle CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren und Löschen) nachverfolgt. Diese Vorgänge werden von Teams-Kanal-HR-Benutzern in einem Microsoft 365-Mandanten an die Mitarbeiterdatensätze vorgenommen.

erstellen Sie eine URL auf dem Server Ihrer App, um eine POST-Anforderung mit einer JSON-Nutzlast zu akzeptieren und zu verarbeiten

Ihr Dienst empfängt Nachrichten in einem standardmäßigen Azure Bot Service-Messagingschema. Der Bot Framework-Connector ist ein RESTful-Dienst, der es ermöglicht, den Austausch von Nachrichten im JSON-Format über HTTPS-Protokolle zu verarbeiten, wie in der Azure Bot Service-API dokumentiert. Alternativ können Sie dem Microsoft Bot Framework SDK folgen, um Nachrichten zu verarbeiten und zu analysieren. Weitere Informationen finden Sie unter Übersicht über Azure Bot Service.

Ausgehende Webhooks sind auf die team-Ebene beschränkt und für alle Teammitglieder sichtbar. Benutzer müssen den Namen des ausgehenden Webhooks @mention , um ihn im Kanal aufzurufen.

Verwenden von adaptiven Karten mit ausgehenden Webhooks

Sie können mit einem ausgehendem Webhook adaptive Karten, Herokarten und SMS als Anlage senden. Karten unterstützen die Formatierung. Weitere Informationen finden Sie unter Formatieren von Karten mit Markdown. Adaptive Karte in ausgehenden Webhooks unterstützt nur openURL Kartenaktionen.

Die folgenden Codes sind Beispiele für eine adaptive Kartenantwort:

Beispielcodereferenz


// This method is to read the request body content
string content;
using (var reader = new StreamReader(Request.Body))
    {
        content = await reader.ReadToEndAsync();
    }

var Card = new AdaptiveCard(new AdaptiveSchemaVersion("1.4"))
{
    Body = new List<AdaptiveElement>()
    {
        new AdaptiveTextBlock(){Text= $"Request sent by: {incomingActivity.From.Name}"},
        new AdaptiveImage(){Url=new Uri("https://c.s-microsoft.com/en-us/CMSImages/DesktopContent-04_UPDATED.png?version=43c80870-99dd-7fb1-48c0-59aced085ab6")},
        new AdaptiveTextBlock(){Text="Sample image for Adaptive Card.."}
    }
};

var attachment = new Attachment()
{
    ContentType = AdaptiveCard.ContentType,
    Content = Card
};

var sampleResponseActivity = new Activity
{
    Attachments = new [] { attachment }
};

return sampleResponseActivity;

Codebeispiel

Beispielname Beschreibung .NET Node.js
Ausgehende Webhooks In diesem Beispiel wird gezeigt, wie ausgehender Webhook implementiert und verwendet wird. View View

Schrittweise Anleitung

Befolgen Sie die Schritt-für-Schritt-Anleitung, um ausgehende Webhooks in Teams zu erstellen.

Siehe auch