ChannelServiceHandler.OnCreateConversationAsync(ClaimsIdentity, ConversationParameters, CancellationToken) Methode

Definition

Die API "kreateconverations ()".CreateConversation() API.

protected virtual System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse> OnCreateConversationAsync (System.Security.Claims.ClaimsIdentity claimsIdentity, Microsoft.Bot.Schema.ConversationParameters parameters, System.Threading.CancellationToken cancellationToken = default);
abstract member OnCreateConversationAsync : System.Security.Claims.ClaimsIdentity * Microsoft.Bot.Schema.ConversationParameters * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse>
override this.OnCreateConversationAsync : System.Security.Claims.ClaimsIdentity * Microsoft.Bot.Schema.ConversationParameters * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse>
Protected Overridable Function OnCreateConversationAsync (claimsIdentity As ClaimsIdentity, parameters As ConversationParameters, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ConversationResourceResponse)

Parameter

claimsIdentity
ClaimsIdentity

ClaimsIdentity für den bot sollte über audienceclaim, appidclaim und serviceurlclaim verfügen.claimsIdentity for the bot, should have AudienceClaim, AppIdClaim and ServiceUrlClaim.

parameters
ConversationParameters

Parameter zum Erstellen der Konversation aus.Parameters to create the conversation from.

cancellationToken
CancellationToken

Das Abbruchtoken.The cancellation token.

Gibt zurück

Task<ConversationResourceResponse>

Aufgabe für eine Konversations Ressourcen Antwort.task for a conversation resource response.

Hinweise

Überschreiben Sie diese Methode, um eine neue Konversation zu erstellen.Override this method to create a new Conversation.

Posten Sie diese Methode mit einem * bot, der den bot erstellt, der die Konversation * isGroup auf true festgelegt hat, wenn dies keine direkte Nachricht (Standard ist false) * Array mit den in die Konversation einzuschließenden Membern ist.POST to this method with a * Bot being the bot creating the conversation * IsGroup set to true if this is not a direct message (default is false) * Array containing the members to include in the conversation Der Rückgabewert ist eine resourceresponse, die eine Konversations-ID enthält, die sich für die Verwendung in den URIs der Nachrichten Nutzlast und der Rest-API eignet.The return value is a ResourceResponse which contains a conversation ID which is suitable for use in the message payload and REST API URIs.

Die meisten Kanäle unterstützen nur die Semantik von Bots, die eine direkte Nachrichten Konversation initiieren.Most channels only support the semantics of bots initiating a direct message conversation. Ein Beispiel hierfür wäre:An example of how to do that would be: var Resource = warten auf Connector. Konversationen. kreateconveration (New conversationparameters () {bot = bot, Members = New channelaccount [] {New channelaccount ("user1")}); warten auf "verbinden". Konversationen. onsendonconversation ationasync (Ressource. ID, neue Aktivität ()...) ;var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); await connect.Conversations.OnSendToConversationAsync(resource.Id, new Activity() ... ) ; Schließlich.end.

Gilt für: