BotAdapter.CreateConversationAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine Unterhaltung im angegebenen Kanal.
public virtual System.Threading.Tasks.Task CreateConversationAsync (string botAppId, string channelId, string serviceUrl, string audience, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, System.Threading.CancellationToken cancellationToken);
abstract member CreateConversationAsync : string * string * string * string * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateConversationAsync : string * string * string * string * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function CreateConversationAsync (botAppId As String, channelId As String, serviceUrl As String, audience As String, conversationParameters As ConversationParameters, callback As BotCallbackHandler, cancellationToken As CancellationToken) As Task
Parameter
- botAppId
- String
Die Anwendungs-ID des Bots.
- channelId
- String
Die ID für den Kanal.
- serviceUrl
- String
Der Dienstendpunkt des Kanals.
- audience
- String
Die Zielgruppe für den Connector.
- conversationParameters
- ConversationParameters
Die Unterhaltungsinformationen, die zum Erstellen der Unterhaltung verwendet werden sollen.
- callback
- BotCallbackHandler
Die Methode, die für den resultierenden Bot turn aufgerufen werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.
Gibt zurück
Eine Aufgabe, die die auszuführende Arbeit in der Warteschlange darstellt.
Hinweise
Um eine Unterhaltung zu starten, muss Ihr Bot seine Kontoinformationen und die Kontoinformationen des Benutzers in diesem Kanal kennen. Die meisten _channels nur das Initiieren einer Direkten Nachrichtenunterhaltung (nicht in Gruppen) unterstützen.
Der Adapter versucht, eine neue Unterhaltung im Kanal zu erstellen, und sendet dann eine conversationUpdate
Aktivität über seine Middlewarepipeline an die callback
-Methode.
Wenn die Unterhaltung mit den angegebenen Benutzern eingerichtet wird, enthält die ID der Aktivität Conversation die ID der neuen Unterhaltung.