Erstellen eines ausgehenden Webhooks

Der ausgehende Webhook fungiert als Bot und sucht **mithilfe von @mention** nach Nachrichten in Kanälen. Es sendet Benachrichtigungen an externe Webdienste und antwortet mit umfangreichen Nachrichten, die Karten und Bilder enthalten. Es hilft, den Prozess der Erstellung von Bots über die Microsoft Bot Frameworkzu überspringen.

Wichtige Features des ausgehenden Webhooks

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

Features Beschreibung
Bereichskonfiguration Webhooks sind auf Teamebene beschränkt. Der obligatorische Einrichtungsprozess für jedes Add-In fügt einen ausgehenden Webhook hinzu.
Reaktives Messaging Benutzer müssen @mention verwenden, damit der Webhook Nachrichten empfängt. Derzeit können Benutzer nur einen ausgehenden Webhook in öffentlichen Kanälen und nicht innerhalb des persönlichen oder privaten Bereichs senden.
Standardmäßiger HTTP-Nachrichtenaustausch Antworten werden in derselben Kette wie die ursprüngliche Anforderungsnachricht angezeigt und können beliebige Bot Framework-Nachrichteninhalte enthalten, z. B. Rich-Text, Bilder, Karten und Emojis. Ausgehende Webhooks können zwar Karten verwenden, jedoch keine Kartenaktionen mit Ausnahme openURL von .
Teams API-Methodenunterstützung Ausgehende Webhooks senden einen HTTP POST an einen Webdienst und erhalten eine Antwort. Sie können nicht auf andere APIs zugreifen, z. B. auf die Liste oder die Liste der Kanäle in einem Team.

Erstellen ausgehender Webhooks

Erstellen Sie ausgehende Webhooks, und fügen Sie Teams benutzerdefinierte Bots hinzu.

So erstellen Sie einen ausgehenden Webhook

  1. Wählen Sie im linken Bereich Teams aus. Die Teams Seite wird angezeigt:

    Teams channel

  2. Wählen Sie auf der Seite Teams das erforderliche Team aus, um einen ausgehenden Webhook zu erstellen, und wählen Sie die ••• aus. Wählen Sie im Dropdownmenü "Team verwalten" aus:

    Erstellen eines ausgehenden Webhooks

  3. Wählen Sie die Registerkarte "Apps" auf der Kanalseite aus:

    Erstellen eines ausgehenden Webhooks

  4. Wählen Sie "Ausgehenden Webhook erstellen" aus:

    Erstellen ausgehender Webhooks

  5. Geben Sie die folgenden Details auf der Seite "Erstellen eines ausgehenden Webhooks" ein:

    • Name: Der Webhook-Titel 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.
  6. Wählen Sie Erstellen aus. Der ausgehende Webhook wird dem Kanal des aktuellen Teams hinzugefügt:

    Erstellen von ausgehenden Webhooks

Ein Hashbasiertes Dialogfeld mit dem Nachrichtenauthentifizierungscode (Message Authentication Code, HMAC) wird angezeigt. Es handelt sich um ein Sicherheitstoken, das zum Authentifizieren von Aufrufen zwischen Teams und dem angegebenen externen Dienst verwendet wird.

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: Push-Änderungsstatusbenachrichtigungen auf einem Teams Kanaldatenbankserver an Ihre App.
  • Beispiel: Sie verfügen über eine Branchen-App, die alle CRUD-Vorgänge verfolgt, z. B. erstellen, lesen, aktualisieren und löschen. Diese Vorgänge werden den Mitarbeiterdatensätzen von Teams Kanal-HR-Benutzern über einen Office 365 Mandanten 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 Nachrichtenschema des Azure-Botdiensts. Der Bot Framework-Connector ist ein REST-Dienst, der es ermöglicht, den Austausch von JSON-formatierten Nachrichten über HTTPS-Protokolle zu verarbeiten, wie in der Azure Bot Service-APIdokumentiert. Alternativ können Sie dem Microsoft Bot Framework SDK folgen, um Nachrichten zu verarbeiten und zu analysieren. Weitere Informationen finden Sie in der Übersicht über Azure Bot Service.

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

Hinweis

  • Sie können adaptive Karte, Hero-Karte und Textnachrichten als Anlage mit ausgehenden Webhook senden.
  • Karten unterstützen die Formatierung. Weitere Informationen finden Sie unter Formatieren von Karten mit Markdown.

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

string content = await this.Request.Content.ReadAsStringAsync();
Activity incomingActivity = JsonConvert.DeserializeObject<Activity>(content);

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 Beispiele zum Erstellen von benutzerdefinierten Bots, die in Microsoft Teams verwendet werden. View Anzeigen

Siehe auch