Sprache

BotAdapter.CreateConversationAsync Methode

Definition

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 Dienst-URL-Endpunkt 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 die resultierende Bot-Turn aufgerufen werden soll.

cancellationToken
CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.

Gibt zurück

Eine Aufgabe, die die auszuführende Arbeitswarteschlange darstellt.

Hinweise

Um eine Unterhaltung zu starten, muss Ihr Bot seine Kontoinformationen und die Kontoinformationen des Benutzers in diesem Kanal kennen. Die meisten _channels unterstützen nur das Initiieren einer direkten Unterhaltung (nicht gruppieren).

Der Adapter versucht, eine neue Unterhaltung im Kanal zu erstellen, und sendet dann eine conversationUpdate Aktivität über die Middleware-Pipeline an die callback-Methode.

Wenn die Unterhaltung mit den angegebenen Benutzern hergestellt wird, enthält die ID der Conversation der Aktivität die ID der neuen Unterhaltung.

Gilt für: