Übung: Erstellen eines Bots, der proaktive Nachrichten an Microsoft Teams senden kann

  • 5 Minuten

In dieser Übung erfahren Sie, wie Sie Ihren Bot erstellen, ausführen und debuggen. Außerdem erfahren Sie, wie Sie den Bot zum Senden einer adaptiven Karte an Microsoft Teams über die Befehlszeile auslösen.

Erstellen Ihres Bots

  1. Öffnen Sie Visual Studio Code.

  2. Wählen Sie auf der Randleiste das Microsoft Teams-Symbol aus, um den Bereich TEAMS TOOLKIT zu öffnen.

  3. Wählen Sie im Bereich TEAMS TOOLKIT die Schaltfläche Neue App erstellen aus.

  4. Wählen Sie im Menü Neues Projektdie Option Bot aus.

    Screenshot von Visual Studio Code mit auswahl zum Erstellen eines neuen Bots mithilfe des Teams Toolkits

  5. Wählen Sie im Menü App-Features mithilfe eines Bots das Feature Chatbenachrichtigung aus.

    Screenshot von Visual Studio Code mit dem Menü

  6. Wählen Sie im Menü Trigger auswählen die Option HTTP-Trigger (Azure Functions) aus.

  7. Wählen Sie im Menü Programmiersprache die Option JavaScript aus.

  8. Wählen Sie im Menü Arbeitsbereichsordnerdie Option Standardordner aus.

  9. Geben Sie im Feld Anwendungsnamesupport ticket alerts (Supportticketwarnungen) ein, und drücken Sie dann die EINGABETASTE.

Teams Toolkit erstellt die Projekt- und Quellcodedateien für Sie.

Hinweis

Möglicherweise erhalten Sie eine Meldung von Visual Studio Code, in der Sie gefragt werden, ob Sie den Autoren der Dateien in diesem Ordner vertrauen. Wählen Sie die Schaltfläche Ja, ich vertraue den Autoren aus, um den Vorgang fortzusetzen.

Screenshot von Visual Studio Code mit der Infodatei für die Benachrichtigungsbotvorlage und codedateien im Explorer-Bereich.

Ausführen und Debuggen

Jetzt ist es an der Zeit, Ihren Bot zum ersten Mal auszuführen.

  1. Wählen Sie auf der Randleiste das Symbol Debuggen aus, um den Bereich AUSFÜHREN UND DEBUGGEN zu öffnen.

  2. Wählen Sie im Bereich AUSFÜHREN UND DEBUGGEN entweder Chrome oder Edge im Dropdownlistenfeld als Browser aus, den Sie zum Debuggen Ihres Bots verwenden möchten. Wählen Sie dann die Schaltfläche Wiedergeben aus (oder drücken Sie die Taste F5), um die Debugsitzung zu starten.

    Screenshot von Visual Studio Code mit dem Benachrichtigungsbotcode, dem Debugbereich und den Terminalaufgaben.

    Hinweis

    Wenn Sie sich nicht bei Ihrem Microsoft 365-Mandanten angemeldet haben, werden Sie dazu aufgefordert. Wählen Sie Anmelden aus, und führen Sie die Anmeldeschritte aus, um Teams Toolkit bei Ihrem Microsoft 365-Mandanten zu authentifizieren.

    Teams Toolkit stellt dann alle erforderlichen Komponenten bereit, konfiguriert und startet sie. Außerdem wird ein Browserfenster geöffnet, das zu Microsoft Teams wechselt.

  3. Wählen Sie im Installationsdialogfeld die Schaltfläche Hinzufügen aus, um die App als persönliche App zu installieren.

Das war's auch schon. Ihr Bot ist installiert, wird in Teams ausgeführt und kann getestet werden.

Screenshot des Teams-Webclients mit einem leeren Bot-Chatfenster für Supportticketwarnungen

Auslösen einer proaktiven Nachricht

Senden Sie mithilfe eines Befehlszeilentools eine HTTP-Anforderung POST an den Benachrichtigungsendpunkt, der auf dem lokalen Webserver gehostet wird, um den Bot zum Senden einer Nachricht an Teams auszulösen.

curl -X POST http://localhost:3978/api/notification

Der Bot sendet eine adaptive Karte an den Teams-Chat.

Screenshot des Teams-Webclients mit einer adaptiven Karte, die im Botchat für Supportticketwarnungen bereitgestellt wurde.

Schließen Sie das Browserfenster, um die Debugsitzung zu beenden.