Schnellstartleitfaden für die Botkonfiguration

Hinweis

Die Benutzeroberfläche für die Botkonfiguration wird nur in Kanal- oder Gruppenchatbereichen unterstützt.

Starten Sie die Entwicklung von Microsoft Teams-Apps mit Ihrer ersten Teams-App. Sie können eine Bot-App mit Teams mithilfe von Javascript erstellen.

Dieser Schnellstartleitfaden hilft Ihnen beim Erstellen eines konfigurierbaren Bots mit dem Teams-Toolkit. Die folgende Ausgabe wird angezeigt, nachdem Sie diese Anleitung abgeschlossen haben:

Screenshot: Konfigurationsoption für den Bot in einem Teams-Gruppenchat

Voraussetzungen

6 Minuten verbleibend

Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihrer Apps installieren.

	Installieren	Zum Benutzen...
	Teams Toolkit	Eine Microsoft Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Version.
	Microsoft Teams	Microsoft Teams für die Zusammenarbeit mit allen, mit denen Sie arbeiten, über Apps für Chats, Besprechungen und Anrufe an einem Ort.
	Node.js und NPM	Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter Node.js Versionskompatibilitätstabelle für den Projekttyp.
	Microsoft Edge (empfohlen) oder Google Chrome	Ein Browser mit Entwicklertools.
	Visual Studio Code	Build-Umgebungen für JavaScript, TypeScript oder SharePoint Framework (SPFx). Verwenden Sie die neueste Version.
	Entwicklungstunnel	Teams-App-Features (Konversationsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Dev Tunnel ist ein leistungsstarkes Tool, um Ihren Localhost sicher für das Internet zu öffnen und zu steuern, wer Zugriff hat. Dev Tunnel ist in Visual Studio 2022 Version 17.7.0 oder höher verfügbar. Oder Sie können ngrok auch als Tunnel verwenden, um Ihr Entwicklungssystem mit Teams zu verbinden. Dies ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mithilfe von npm devDependencies).

Hinweis

Nachdem Sie ngrok heruntergeladen haben, registrieren Sie sich, und installieren Sie authtoken.

Einrichten einer lokalen Umgebung

5 Minuten verbleibend

Öffnen Sie Microsoft Teams-Beispiele.
Wählen Sie Code aus. Wählen Sie im Dropdownmenü Mit GitHub Desktop öffnen aus.
Wählen Sie Klonen aus.

Einrichten des Tunnels für den lokalen Webserver

4 Minuten verbleibend

Verwenden Sie ngrok oder die Eingabeaufforderung, um einen Tunnel zu den öffentlich verfügbaren HTTPS-Endpunkten Ihres lokal ausgeführten Webservers zu erstellen. Führen Sie den folgenden Befehl in ngrok aus:

ngrok http --host-header=localhost 3978

Tipp

Wenn sie auf ERR_NGROK_4018 stoßen, führen Sie die Schritte in der Eingabeaufforderung aus, um sich zu registrieren und ngrok zu authentifizieren. Führen Sie anschließend den Befehl ngrok http --host-header=localhost 3978 aus.

Im Fenster wird die HTTPS-URL angezeigt.

Screenshot: ngrok-HTTPS-URL

Erstellen und Ausführen Ihrer App

3 Minuten verbleibend

Wechseln Sie zu Visual Studio Code.
Wählen Sie Ordner öffnen aus, wechseln Sie zu Microsoft-Teams-Samples>samples>bot-configuration-app , und wählen Sie dann Ordner auswählen aus.
Wählen Sie im linken Bereich Teams Toolkit aus.
Melden Sie sich unter KONTEN bei Folgendem an:
- Microsoft 365 Konto
- Azure-Konto
Geben Sie F5 ein, um Ihre App zu debuggen.

Eine Browserregisterkarte öffnet einen Teams-Webclient, der das Hinzufügen des Bots zu Ihrem Mandanten anfordert.
Wählen Sie in der Dropdownliste neben Hinzufügen die Option Zu einem Team hinzufügen oder Zu einem Chat hinzufügen aus.
Geben Sie den Namen eines Chats in das Suchfeld ein.
Wählen Sie Bot einrichten aus.

Der Bot wird im Chat installiert.

Neukonfigurieren des Bots

2 Minuten verbleibend

Wechseln Sie zum Chat, und @Erwähnung Sie den Bot im Nachrichtenerstellungsbereich, und wählen Sie Senden aus.
Wenn Sie in der Unterhaltung auf den Bot zeigen, wird eine adaptive Karte angezeigt. Wählen Sie auf der adaptiven Karte das Symbol Einstellungen aus.

Eine adaptive Karte für die Botkonfiguration wird angezeigt.
Konfigurieren Sie die Boteinstellungen neu, und wählen Sie Senden aus.
Der Bot sendet eine Antwortnachricht.