Grundlagen zu Unterhaltungen
Wichtig
Die Codebeispiele in diesem Abschnitt basieren auf Version 4.6 und höheren Versionen des Bot Framework SDK. Wenn Sie nach Dokumentation zu früheren Versionen suchen, lesen Sie den Abschnitt bots – v3 SDK im Ordner Legacy SDKs der Dokumentation.
Eine Unterhaltung ist eine Reihe von Nachrichten, die zwischen Ihrem Microsoft Teams-Bot und einem oder mehreren Benutzern gesendet werden. Die folgende Tabelle enthält die drei Arten von Unterhaltungen, die in Teams auch als Bereiche bezeichnet werden:
| Unterhaltungstyp | Beschreibung |
|---|---|
channel |
Dieser Konversationstyp ist für alle Mitglieder des Kanals sichtbar. |
personal |
Dieser Konversationstyp umfasst Unterhaltungen zwischen Bots und einem einzelnen Benutzer. |
groupChat |
Dieser Konversationstyp umfasst den Chat zwischen einem Bot und zwei oder mehr Benutzern. Außerdem wird Ihr Bot in Besprechungschats aktiviert. |
Ein Bot verhält sich je nach Der Konversation, an der er beteiligt ist, unterschiedlich:
Bots in Kanal- und Gruppenchatunterhaltungen erfordern, dass der Benutzer den Bot @mention, um ihn in einem Kanal aufzurufen.
Bots in einer 1:1-Unterhaltung erfordern keine @mention. Alle vom Benutzer gesendeten Nachrichten werden an Ihren Bot weitergeleitet.
Bots können alle Kanal- und Chatnachrichten in einem Team empfangen, @mentioned ohne ressourcenspezifische Zustimmungsberechtigungen (RSC) zu verwenden. RSC für alle Chatnachrichten ist nur in der öffentlichen Entwicklervorschau für Teams verfügbar. Weitere Informationen finden Sie unter Empfangen aller Unterhaltungsnachrichten mit RSC.
Damit der Bot in einer bestimmten Konversation oder einem bestimmten Bereich funktioniert, fügen Sie diesem Bereich im App-Manifest Unterstützung hinzu.
Jede Nachricht in einer Botunterhaltung ist ein Activity Objekt vom Typ messageType: message. Wenn ein Benutzer eine Nachricht sendet, sendet Teams die Nachricht an Ihren Bot, und der Bot verarbeitet die Nachricht. Außerdem können Sie ein Befehlsmenü mit einer Dropdownliste mit Befehlen für Ihren Bot hinzufügen, um kerne Befehle zu definieren, auf die Ihr Bot reagiert. Bots in einer Gruppe oder einem Kanal empfangen nachrichten nur, wenn sie erwähnt @botnamewerden. Microsoft Teams sendet Benachrichtigungen an Ihren Bot für Unterhaltungsereignisse, die in Bereichen stattfinden, in denen Ihr Bot aktiv ist. Sie können diese Ereignisse in Ihrem Code erfassen und entsprechende Maßnahmen ergreifen.
Ein Bot kann auch proaktive Nachrichten an Benutzer senden. Eine proaktive Nachricht ist jede Nachricht, die von einem Bot gesendet wird, die nicht als Antwort auf eine Anforderung eines Benutzers gesendet wurde. Sie können Ihre Botnachrichten so formatieren, dass sie Rich-Karten enthalten, die interaktive Elemente wie Schaltflächen, Text, Bilder, Audio, Video usw. enthalten. Der Bot kann Nachrichten nach dem Senden dynamisch aktualisieren, anstatt Ihre Nachrichten als statische Momentaufnahmen von Daten zu verwenden. Nachrichten können auch mithilfe der Bot Framework-Methode DeleteActivity gelöscht werden. Die ausgehende Anforderung an den Bot zeigt die Konversations-ID und mandanten-ID in den Headern an.
Der Benachrichtigungsbot ist ein Konversationsbot, der Benachrichtigungen als Nur-Text oder adaptive Karten sendet. Die Vorlage für den Benachrichtigungsbot erstellt eine App, die eine Nachricht an Teams mit adaptiven Karten sendet, die von der HTTP-Post-Anforderung ausgelöst werden.
Der Befehlsbot ist ein Konversationsbot, der auf einfache Befehle reagieren kann, die in Chats mit adaptiven Karten gesendet werden. Sie können Befehlsbotvorlagen in Teams erstellen, um auf Chatbefehle zu reagieren, indem Sie die Benutzeroberfläche mithilfe einer adaptiven Karte anzeigen.
Der Workflowbot ist ein Konversationsbot, der mit den Benutzern in der adaptiven Karte interagiert. Sie können anpassen, wie der Bot die adaptive Karte an die Benutzer sendet.
Hinzufügen der SSO-Authentifizierung zu Ihren Konversationsbots
Mit den folgenden Schritten können Sie Ihrem Konversationsbot die Authentifizierung mit einmaligem Anmelden hinzufügen: