Funktionsweise von Microsoft Teams-Bots

GILT FÜR: SDK v4

Dieser Artikel baut auf den Erkenntnissen auf, die Sie in der Funktionsweise von Bots und ereignisgesteuerten Unterhaltungen gelernt haben. Sie sollten mit diesen Artikeln vertraut sein, bevor Sie fortfahren.

Der Hauptunterschied bei Bots, die für Microsoft Teams entwickelt wurden, besteht in der Verarbeitung von Aktivitäten. Der Teams-Aktivitätshandler wird vom Aktivitätshandler abgeleitet und verarbeitet teamsspezifische Aktivitätstypen, bevor allgemeinere Aktivitätstypen verarbeitet werden.

Hinweis

Die JavaScript-, C#- und Python-SDKs für Bot Framework werden weiterhin unterstützt, das Java-SDK wird jedoch eingestellt und der langfristige Support endet im November 2023.

Bestehende Bots, die mit dem Java SDK erstellt wurden, werden weiterhin funktionieren.

Wenn Sie einen neuen Bot erstellen möchten, sollten Sie den Einsatz von Power Virtual Agents in Betracht ziehen und sich über die Auswahl der richtigen Chatbot-Lösung informieren.

Weitere Informationen finden Sie unter Die Zukunft des Bot-Buildings.

Teams-Aktivitätshandler

Um einen Bot für Teams zu erstellen, leiten Sie Ihren Bot von der Teams-Aktivitätshandler-Klasse ab. Wenn ein solcher Bot eine Aktivität empfängt, leitet er die Aktivität über verschiedene Aktivitätshandler weiter. Der anfängliche Basishandler ist der Turnhandler und leitet die Aktivität basierend auf dem Aktivitätstyp an einen Handler weiter. Der Turnhandler ruft den Handler auf, der für die spezifische Art der empfangenen Aktivität vorgesehen ist. Die Teams-Aktivitätshandler-Klasse wird von der Aktivitätshandler-Klasse abgeleitet. Zusätzlich zu den Aktivitätstypen, die der Aktivitätshandler verarbeiten kann, enthält die Teams-Aktivitätshandlerklasse zusätzliche Handler für Teams-spezifische Aktivitäten.

Ein Bot, der vom Teams-Aktivitätshandler abgeleitet wird, ähnelt einem Bot, der direkt von der Aktivitätshandlerklasse abgeleitet wird. Teams enthält jedoch zusätzliche Informationen in conversationUpdate-Aktivitäten und sendet Teams-spezifische invoke- und event-Aktivitäten.

C#

Wenn Ihr Teams-Aktivitätshandler-Bot eine Nachrichtenaktivität empfängt, leitet der Turnhandler die eingehende Nachrichtenaktivität an seinen OnMessageActivityAsync-Handler weiter, ähnlich wie ein aktivitätshandlerbasierter Bot. Wenn Ihr Teams-Bot jedoch eine Unterhaltungsaktualisierungsaktivität empfängt, verarbeitet die Teams-Version des OnConversationUpdateActivityAsync-Handlers die Aktivität.

Es gibt keine Basisimplementierung für die meisten der Teams-spezifischen Aktivitätshandler. Sie müssen diese Handler überschreiben und entsprechende Logik für Ihren Bot bereitstellen.

JavaScript

Wenn Ihr Teams-Aktivitätshandler-Bot eine Nachrichtenaktivität empfängt, leitet der Turnhandler die eingehende Nachrichtenaktivität an seinen onMessage-Handler weiter, ähnlich wie ein aktivitätshandlerbasierter Bot. Wenn Ihr Teams-Bot jedoch eine Unterhaltungsaktualisierungsaktivität empfängt, verarbeitet die Teams-Version des dispatchConversationUpdateActivity-Handlers die Aktivität.

Es gibt keine Basisimplementierung für die meisten der Teams-spezifischen Aktivitätshandler. Sie müssen diese Handler überschreiben und entsprechende Logik für Ihren Bot bereitstellen.

Definieren Sie Ihre Bot-Logik, wenn Sie diese teamspezifischen Aktivitätshandler überschreiben und rufen Sie am Ende next() auf. Durch Aufrufen von next() wird sichergestellt, dass der nächste Handler ausgeführt wird.

Java

Wenn Ihr Teams-Aktivitätshandler-Bot eine Nachrichtenaktivität empfängt, leitet der Turnhandler die eingehende Nachrichtenaktivität an seinen onMessageActivity-Handler weiter, ähnlich wie ein aktivitätshandlerbasierter Bot. Wenn Ihr Teams-Bot jedoch eine Unterhaltungsaktualisierungsaktivität empfängt, verarbeitet die Teams-Version des onConversationUpdateActivity-Handlers die Aktivität.

Es gibt keine Basisimplementierung für die meisten der Teams-spezifischen Aktivitätshandler. Sie müssen diese Handler überschreiben und entsprechende Logik für Ihren Bot bereitstellen.

Python

Wenn Ihr Teams-Aktivitätshandler-Bot eine Nachrichtenaktivität empfängt, leitet der Turnhandler die eingehende Nachrichtenaktivität an seinen on_message_activity-Handler weiter, ähnlich wie ein aktivitätshandlerbasierter Bot. Wenn Ihr Teams-Bot jedoch eine Unterhaltungsaktualisierungsaktivität empfängt, verarbeitet die Teams-Version des on_conversation_update_activity-Handlers die Aktivität.

Es gibt keine Basisimplementierung für die meisten der Teams-spezifischen Aktivitätshandler. Sie müssen diese Handler überschreiben und entsprechende Logik für Ihren Bot bereitstellen.

Alle Aktivitätshandler, die im Abschnitt zur Aktivitätsbehandlung des Artikels Ereignisgesteuerte Unterhaltungen mit einem Aktivitätshandler beschrieben sind, funktionieren weiterhin wie für einen nicht für Teams bestimmten Bot – mit Ausnahme der Aktivitäten zum Hinzufügen und Entfernen von Mitgliedern, die sich im Kontext eines Teams unterscheiden, da das neue Mitglied dem Team hinzugefügt wird und nicht in einem Nachrichten-Thread. Weitere Informationen finden Sie unter Aktualisierungsaktivitäten für Teams-Unterhaltungen.

Um Ihre Logik für diese teamspezifischen Aktivitätshandler zu implementieren, werden Sie Methoden in Ihrem Bot außer Kraft setzen.

Teams-Botlogik

Die Botlogik verarbeitet eingehende Aktivitäten aus einem oder mehreren Ihrer Botkanäle und generiert als Reaktion ausgehende Aktivitäten. Dies gilt weiterhin für Bots, die von der Teams-Aktivitätshandlerklasse abgeleitet werden. Zuerst wird eine Überprüfung auf Teams-Aktivitäten durchgeführt, und anschließend werden alle anderen Aktivitäten an den Aktivitätshandler von Bot Framework übergeben.

Aktualisierungsaktivitäten von Teams bei der Installation

Fügen Sie einen Handler für das Installationsupdate-Ereignis hinzu, damit Ihr Bot:

• eine einleitende Nachricht senden kann, wenn er in einem Konversations-Thread installiert wird.
• die Benutzer- und Thread-Daten bereinigt, wenn er von einem Thread deinstalliert wird.

Weitere Informationen finden Sie im Installationsupdate-Ereignis in den Teams-Dokumenten.

Teams-Aktivitäten für die Konversationsaktualisierung

In den folgenden Tabellenlisten sind die Teams-Ereignisse aufgeführt, die eine Unterhaltungsaktualisierungs-Aktivität in einem Bot generieren. Im Artikel zu den Ereignissen der Konversationsaktualisierung von Microsoft Teams wird beschrieben, wie Sie diese einzelnen Ereignisse verwenden.

C#

Unten ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den OnConversationUpdateActivityAsync-Methoden der Teams-Aktivitätshandler aufgerufen werden.

EventType	Handler	Bedingung	Teams-Dokumentation
channelCreated	OnTeamsChannelCreatedAsync	Wird gesendet, wenn ein neuer Kanal in einem Team erstellt wird, in dem Ihr Bot installiert ist.	Kanal erstellt.
channelDeleted	OnTeamsChannelDeletedAsync	Wird gesendet, wenn ein Kanal in einem Team gelöscht wird, in dem Ihr Bot installiert ist.	Kanal gelöscht.
channelRenamed	OnTeamsChannelRenamedAsync	Wird gesendet, wenn ein Kanal in einem Team umbenannt wird, in dem Ihr Bot installiert ist.	Kanal umbenannt.
channelRestored	OnTeamsChannelRestoredAsync	Wird gesendet, wenn ein Kanal, der zuvor gelöscht wurde, in einem Team wiederhergestellt wird, in dem Ihr Bot bereits installiert ist.	Kanal wiederhergestellt.
membersAdded	OnTeamsMembersAddedAsync	Ruft standardmäßig die ActivityHandler.OnMembersAddedAsync-Methode auf. Wird gesendet, wenn Ihr Bot zum ersten Mal zu einer Unterhaltung hinzugefügt wird und jedes Mal, wenn ein neuer Benutzer zu einem Team- oder Gruppen-Chat hinzugefügt wird, in dem Ihr Bot installiert ist.	Hinzugefügte Teammitglieder.
membersRemoved	OnTeamsMembersRemovedAsync	Ruft standardmäßig die ActivityHandler.OnMembersRemovedAsync-Methode auf. Wird gesendet, wenn Ihr Bot aus einem Team entfernt wird und jedes Mal, wenn ein Benutzer aus einem Team entfernt wird, in dem Ihr Bot Mitglied ist.	Teammitglieder wurden entfernt.
teamArchived	OnTeamsTeamArchivedAsync	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, archiviert wird.	Team archiviert.
teamDeleted	OnTeamsTeamDeletedAsync	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, gelöscht wurde.	Team wurde gelöscht.
teamRenamed	OnTeamsTeamRenamedAsync	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, umbenannt wurde.	Team umbenannt.
teamRestored	OnTeamsTeamRestoredAsync	Wird gesendet, wenn ein zuvor gelöschtes Team, in dem sich Ihr Bot befindet, wiederhergestellt wird.	Team wurde wiederhergestellt.
teamUnarchived	OnTeamsTeamUnarchivedAsync	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, nicht archiviert wird.	Team nicht archiviert.

JavaScript

Entwickler können Unterhaltungsaktualisierungsaktivitäten behandeln, die über zwei Methoden von Microsoft Teams gesendet werden:

1. Um einen Rückruf zu übergeben, verwenden Sie Methoden, die mit on beginnen und mit Event enden (z. B. die onTeamsMembersAddedEvent-Methode).
2. Wenn Sie eine abgeleitete Klasse erstellen, überschreiben Sie Methoden, die mit on beginnen und nicht mit Event enden (z. B. die onTeamsMembersAdded-Methode).

Entwickler sollten nur eine der folgenden Optionen verwenden: entweder 1 oder 2, und nicht beides für dieselbe Aktivität. Das heißt, Entwickler sollten entweder einen Rückruf an die onTeamsMembersAddedEvent-Methode übergeben oder die onTeamsMembersAdded-Methode in einer abgeleiteten Klasse überschreiben und nicht beides tun.

Methoden zum Registrieren eines Rückrufs

Unten ist eine Liste mit allen Teams-Aktivitätsemitters angegeben, die über den dispatchConversationUpdateActivity-Methoden der Teams-Aktivitätshandler aufgerufen werden.

EventType	Registrierungsmethode	Bedingung	Teams-Dokumentation
channelCreated	onTeamsChannelCreatedEvent	Wird gesendet, wenn ein neuer Kanal in einem Team erstellt wird, in dem Ihr Bot installiert ist.	Kanal erstellt.
channelDeleted	onTeamsChannelDeletedEvent	Wird gesendet, wenn ein Kanal in einem Team gelöscht wird, in dem Ihr Bot installiert ist.	Kanal gelöscht.
channelRenamed	onTeamsChannelRenamedEvent	Wird gesendet, wenn ein Kanal in einem Team umbenannt wird, in dem Ihr Bot installiert ist.	Kanal umbenannt.
channelRestored	onTeamsChannelRestoredEvent	Wird gesendet, wenn ein Kanal, der zuvor gelöscht wurde, in einem Team wiederhergestellt wird, in dem Ihr Bot bereits installiert ist.	Kanal wiederhergestellt.
membersAdded	onTeamsMembersAddedEvent	Wird gesendet, wenn Ihr Bot zum ersten Mal zu einer Unterhaltung hinzugefügt wird und jedes Mal, wenn ein neuer Benutzer zu einem Team- oder Gruppen-Chat hinzugefügt wird, in dem Ihr Bot installiert ist.	Hinzugefügte Teammitglieder.
membersRemoved	onTeamsMembersRemovedEvent	Wird gesendet, wenn Ihr Bot aus einem Team entfernt wird und jedes Mal, wenn ein Benutzer aus einem Team entfernt wird, in dem Ihr Bot Mitglied ist.	Teammitglieder wurden entfernt.
teamArchived	onTeamsTeamArchivedEvent	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, archiviert wird.	Team archiviert.
teamDeleted	onTeamsTeamDeletedEvent	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, gelöscht wurde.	Team wurde gelöscht.
teamRenamed	onTeamsTeamRenamedEvent	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, umbenannt wurde.	Team umbenannt.
teamRestored	onTeamsTeamrestoredEvent	Wird gesendet, wenn ein zuvor gelöschtes Team, in dem sich Ihr Bot befindet, wiederhergestellt wird.	Team wurde wiederhergestellt.
teamUnarchived	onTeamsTeamUnarchivedEvent	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, nicht archiviert wird.	Team nicht archiviert.

Methoden zum Überschreiben in einer abgeleiteten Klasse

Nachfolgend finden Sie eine Liste aller Teams-Aktivitätshandler, die überschrieben werden können, um Unterhaltungsaktualisierungsaktivitäten von Teams zu verarbeiten.

EventType	Handler	Bedingung	Teams-Dokumentation
channelCreated	onTeamsChannelCreated	Wird gesendet, wenn ein neuer Kanal in einem Team erstellt wird, in dem Ihr Bot installiert ist.	Kanal erstellt.
channelDeleted	onTeamsChannelDeleted	Wird gesendet, wenn ein Kanal in einem Team gelöscht wird, in dem Ihr Bot installiert ist.	Kanal gelöscht.
channelRenamed	onTeamsChannelRenamed	Wird gesendet, wenn ein Kanal in einem Team umbenannt wird, in dem Ihr Bot installiert ist.	Kanal umbenannt.
channelRestored	onTeamsChannelRestored	Wird gesendet, wenn ein Kanal, der zuvor gelöscht wurde, in einem Team wiederhergestellt wird, in dem Ihr Bot bereits installiert ist.	Kanal wiederhergestellt.
membersAdded	onTeamsMembersAdded	Ruft standardmäßig die ActivityHandler.onMembersAdded-Methode auf. Wird gesendet, wenn Ihr Bot zum ersten Mal zu einer Unterhaltung hinzugefügt wird und jedes Mal, wenn ein neuer Benutzer zu einem Team- oder Gruppen-Chat hinzugefügt wird, in dem Ihr Bot installiert ist.	Hinzugefügte Teammitglieder.
membersRemoved	onTeamsMembersRemoved	Ruft standardmäßig die ActivityHandler.onMembersRemoved-Methode auf. Wird gesendet, wenn Ihr Bot aus einem Team entfernt wird und jedes Mal, wenn ein Benutzer aus einem Team entfernt wird, in dem Ihr Bot Mitglied ist.	Teammitglieder wurden entfernt.
teamArchived	onTeamsTeamArchived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, archiviert wird.	Team archiviert.
teamDeleted	onTeamsTeamDeleted	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, gelöscht wurde.	Team wurde gelöscht.
teamRenamed	onTeamsTeamRenamed	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, umbenannt wurde.	Team umbenannt.
teamRestored	onTeamsTeamRestored	Wird gesendet, wenn ein zuvor gelöschtes Team, in dem sich Ihr Bot befindet, wiederhergestellt wird.	Team wurde wiederhergestellt.
teamUnarchived	onTeamsTeamUnarchived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, nicht archiviert wird.	Team nicht archiviert.

Java

Unten ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den onConversationUpdateActivity-Methoden der Teams-Aktivitätshandler aufgerufen werden.

EventType	Handler	Bedingung	Teams-Dokumentation
channelCreated	onTeamsChannelCreated	Wird gesendet, wenn ein neuer Kanal in einem Team erstellt wird, in dem Ihr Bot installiert ist.	Kanal erstellt.
channelDeleted	onTeamsChannelDeleted	Wird gesendet, wenn ein Kanal in einem Team gelöscht wird, in dem Ihr Bot installiert ist.	Kanal gelöscht.
channelRenamed	onTeamsChannelRenamed	Wird gesendet, wenn ein Kanal in einem Team umbenannt wird, in dem Ihr Bot installiert ist.	Kanal umbenannt.
channelRestored	onTeamsChannelRestored	Wird gesendet, wenn ein Kanal, der zuvor gelöscht wurde, in einem Team wiederhergestellt wird, in dem Ihr Bot bereits installiert ist.	Kanal wiederhergestellt.
membersAdded	onTeamsMembersAdded	Ruft standardmäßig die ActivityHandler.onMembersAdded-Methode auf. Wird gesendet, wenn Ihr Bot zum ersten Mal zu einer Unterhaltung hinzugefügt wird und jedes Mal, wenn ein neuer Benutzer zu einem Team- oder Gruppen-Chat hinzugefügt wird, in dem Ihr Bot installiert ist.	Hinzugefügte Teammitglieder.
membersRemoved	onTeamsMembersRemoved	Ruft standardmäßig die ActivityHandler.onMembersRemoved-Methode auf. Wird gesendet, wenn Ihr Bot aus einem Team entfernt wird und jedes Mal, wenn ein Benutzer aus einem Team entfernt wird, in dem Ihr Bot Mitglied ist.	Teammitglieder wurden entfernt.
teamArchived	onTeamsTeamArchived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, archiviert wird.	Team archiviert.
teamDeleted	onTeamsTeamDeleted	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, gelöscht wurde.	Team wurde gelöscht.
teamRenamed	onTeamsTeamRenamed	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, umbenannt wurde.	Team umbenannt.
teamRestored	onTeamsTeamRestored	Wird gesendet, wenn ein zuvor gelöschtes Team, in dem sich Ihr Bot befindet, wiederhergestellt wird.	Team wurde wiederhergestellt.
teamUnarchived	onTeamsTeamUnarchived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, nicht archiviert wird.	Team nicht archiviert.

Python

Unten ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den on_conversation_update_activity-Methoden der Teams-Aktivitätshandler aufgerufen werden.

EventType	Handler	Bedingung	Teams-Dokumentation
channelCreated	on_teams_channel_created	Wird gesendet, wenn ein neuer Kanal in einem Team erstellt wird, in dem Ihr Bot installiert ist.	Kanal erstellt.
channelDeleted	on_teams_channel_deleted	Wird gesendet, wenn ein Kanal in einem Team gelöscht wird, in dem Ihr Bot installiert ist.	Kanal gelöscht.
channelRenamed	on_teams_channel_renamed	Wird gesendet, wenn ein Kanal in einem Team umbenannt wird, in dem Ihr Bot installiert ist.	Kanal umbenannt.
channelRestored	on_teams_channel_restored	Wird gesendet, wenn ein Kanal, der zuvor gelöscht wurde, in einem Team wiederhergestellt wird, in dem Ihr Bot bereits installiert ist.	Kanal wiederhergestellt.
membersAdded	on_teams_members_added	Ruft standardmäßig die on_members_added_activity-Methode der Basisklasse auf. Wird gesendet, wenn Ihr Bot zum ersten Mal zu einer Unterhaltung hinzugefügt wird und jedes Mal, wenn ein neuer Benutzer zu einem Team- oder Gruppen-Chat hinzugefügt wird, in dem Ihr Bot installiert ist.	Hinzugefügte Teammitglieder.
membersRemoved	on_teams_members_removed	Ruft standardmäßig die on_members_removed_activity-Methode der Basisklasse auf. Wird gesendet, wenn Ihr Bot aus einem Team entfernt wird und jedes Mal, wenn ein Benutzer aus einem Team entfernt wird, in dem Ihr Bot Mitglied ist.	Teammitglieder wurden entfernt.
teamArchived	on_teams_team_archived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, archiviert wird.	Team archiviert.
teamDeleted	on_teams_team_deleted	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, gelöscht wurde.	Team wurde gelöscht.
teamRenamed	on_teams_team_renamed	Wird gesendet, wenn das Team, in dem sich Ihr Bot befindet, umbenannt wurde.	Team umbenannt.
teamRestored	on_teams_team_restored	Wird gesendet, wenn ein zuvor gelöschtes Team, in dem sich Ihr Bot befindet, wiederhergestellt wird.	Team wurde wiederhergestellt.
teamUnarchived	on_teams_team_unarchived	Wird gesendet, wenn das Team, in dem Ihr Bot installiert ist, nicht archiviert wird.	Team nicht archiviert.

Teams-Ereignisaktivitäten

In der folgenden Tabelle sind die Teams-spezifischen Ereignisaktivitäten aufgeführt, die Teams an einen Bot sendet. Die oben aufgeführten Ereignisaktivitäten sind für Konversationsbots in Teams bestimmt.

C#

Dies sind die teamsspezifischen Ereignisaktivitätshandler, die vom OnEventActivityAsyncTeams-Aktivitätshandler aufgerufen werden.

Ereignistypen	Handler	Beschreibung
application/vnd.microsoft.meetingEnd	OnTeamsMeetingEndAsync	Der Bot ist einer soeben beendeten Besprechung zugeordnet.
application/vnd.microsoft.meetingStart	OnTeamsMeetingStartAsync	Der Bot ist einer soeben gestarteten Besprechung zugeordnet.

JavaScript

Dies sind die teamsspezifischen Ereignisaktivitätshandler, die vom onEventActivityTeams-Aktivitätshandler aufgerufen werden.

Ereignistypen	Handler	Beschreibung
application/vnd.microsoft.meetingEnd	onTeamsMeetingEnd	Der Bot ist einer soeben beendeten Besprechung zugeordnet.
application/vnd.microsoft.meetingStart	onTeamsMeetingStart	Der Bot ist einer soeben gestarteten Besprechung zugeordnet.

Java

Dies sind die teamsspezifischen Ereignisaktivitätshandler, die vom onEventActivityTeams-Aktivitätshandler aufgerufen werden.

Ereignistypen	Handler	Beschreibung
application/vnd.microsoft.meetingEnd	onTeamsMeetingEnd	Der Bot ist einer soeben beendeten Besprechung zugeordnet.
application/vnd.microsoft.meetingStart	onTeamsMeetingStart	Der Bot ist einer soeben gestarteten Besprechung zugeordnet.

Python

Dies sind die teamsspezifischen Ereignisaktivitätshandler, die vom on_event_activityTeams-Aktivitätshandler aufgerufen werden.

Ereignistypen	Handler	Beschreibung
application/vnd.microsoft.meetingEnd	on_teams_meeting_end_event	Der Bot ist einer soeben beendeten Besprechung zugeordnet.
application/vnd.microsoft.meetingStart	on_teams_meeting_start_event	Der Bot ist einer soeben gestarteten Besprechung zugeordnet.

Teams-Aufrufaktivitäten

In der folgenden Tabelle sind die Teams-spezifischen Aufrufaktivitäten aufgeführt, die Teams an einen Bot sendet. Die aufgeführten Aufrufaktivitäten sind für Konversationsbots in Teams bestimmt. Das Bot Framework SDK unterstützt auch spezifische Aufrufe für Messaging-Erweiterungen. Weitere Informationen finden Sie im Artikel Was sind Messaging-Erweiterungen? von Teams.

Hinweis

Die Dokumentation zur Microsoft-Teams-Plattform und die Teams-JavaScript-Clientbibliothek (TeamsJS) beziehen sich auf Aufgabenmodule als modale Dialoge. Weitere Informationen finden Sie unter Dialoge.

C#

Hier ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den OnInvokeActivityAsyncTeams-Aktivitätshandler aufgerufen werden:

Aufruftypen	Handler	Beschreibung
actionableMessage/executeAction	OnTeamsO365ConnectorCardActionAsync	Teams-Kartenaktion für O365-Connector
CardAction.Invoke	OnTeamsCardActionInvokeAsync	Teams-Kartenaktionsaufruf
fileConsent/invoke	OnTeamsFileConsentAcceptAsync	Akzeptierung der Zustimmung zur Teams-Datei
fileConsent/invoke	OnTeamsFileConsentAsync	Zustimmung zur Teams-Datei
fileConsent/invoke	OnTeamsFileConsentDeclineAsync	Zustimmung zur Teams-Datei
signin/verifyState	OnTeamsSigninVerifyStateAsync	Überprüfung des Zustands der Teams-Anmeldung
task/fetch	OnTeamsTaskModuleFetchAsync	Abruf des Teams-Aufgabenmoduls
task/submit	OnTeamsTaskModuleSubmitAsync	Übermittlung des Teams-Aufgabenmoduls

JavaScript

Hier ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den onInvokeActivityTeams-Aktivitätshandler aufgerufen werden:

Aufruftypen	Handler	Beschreibung
actionableMessage/executeAction	handleTeamsO365ConnectorCardAction	Teams-Kartenaktion für O365-Connector
CardAction.Invoke	handleTeamsCardActionInvoke	Teams-Kartenaktionsaufruf
fileConsent/invoke	handleTeamsFileConsentAccept	Akzeptierung der Zustimmung zur Teams-Datei
fileConsent/invoke	handleTeamsFileConsent	Zustimmung zur Teams-Datei
fileConsent/invoke	handleTeamsFileConsentDecline	Zustimmung zur Teams-Datei
signin/verifyState	handleTeamsSigninVerifyState	Überprüfung des Zustands der Teams-Anmeldung
task/fetch	handleTeamsTaskModuleFetch	Teams-Aufgabenmodul (modaler Dialog) Fetchen.
task/submit	handleTeamsTaskModuleSubmit	Teams-Aufgabenmodul (modaler Dialog) Übermitteln.

Java

Hier ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den onInvokeActivityTeams-Aktivitätshandler aufgerufen werden:

Aufruftypen	Handler	Beschreibung
fileConsent/invoke	onTeamsFileConsent	Zustimmung zur Teams-Datei
actionableMessage/executeAction	onTeamsO365ConnectorCardAction	Teams-Kartenaktion für O365-Connector
task/fetch	onTeamsTaskModuleFetch	Abruf des Teams-Aufgabenmoduls
task/submit	onTeamsTaskModuleSubmit	Übermittlung des Teams-Aufgabenmoduls
tab/fetchen	onTeamsTabFetch	Teams Tab Fetchen.
tab/übermitteln	onTeamsTabSubmit	Teams-Tab Übermitteln.
CardAction.Invoke	onTeamsCardActionInvoke	Teams-Kartenaktionsaufruf
fileConsent/invoke	onTeamsFileConsentAccept	Akzeptierung der Zustimmung zur Teams-Datei
fileConsent/invoke	onTeamsFileConsentDecline	Zustimmung zur Teams-Datei
signin/verifyState	onTeamsSigninVerifyState	Überprüfung des Zustands der Teams-Anmeldung

Python

Hier ist eine Liste mit allen Teams-Aktivitätshandlern angegeben, die über den on_invoke_activityTeams-Aktivitätshandler aufgerufen werden:

Aufruftypen	Handler	Beschreibung
actionableMessage/executeAction	on_teams_o365_connector_card_action	Teams-Kartenaktion für O365-Connector
CardAction.Invoke	on_teams_card_action_invoke	Teams-Kartenaktionsaufruf
fileConsent/invoke	on_teams_file_consent_accept	Akzeptierung der Zustimmung zur Teams-Datei
fileConsent/invoke	on_teams_file_consent	Zustimmung zur Teams-Datei
fileConsent/invoke	on_teams_file_consent_decline	Ablehnung der Zustimmung zur Teams-Datei
signin/verifyState	on_teams_signin_verify_state	Überprüfung des Zustands der Teams-Anmeldung
task/fetch	on_teams_task_module_fetch	Abruf des Teams-Aufgabenmoduls
task/submit	on_teams_task_module_submit	Übermittlung des Teams-Aufgabenmoduls

Nächste Schritte

Informationen zum Entwickeln von Teams-Bots finden Sie in der Dokumentation für Microsoft Teams-Entwickler.