Freigeben über


ChannelServiceHandlerBase.OnCreateConversationAsync Methode

Definition

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 AudienceClaim, AppIdClaim und ServiceUrlClaim aufweisen.

parameters
ConversationParameters

Parameter, aus der die Konversation erstellt werden soll.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Aufgabe für eine Konversationsressourcenantwort.

Hinweise

Überschreiben Sie diese Methode, um eine neue Konversation zu erstellen.

POST zu dieser Methode, wobei ein * Bot der Bot ist, der die Unterhaltung erstellt * IsGroup auf TRUE festgelegt, wenn dies keine direkte Nachricht ist (Standardwert ist false) * Array, das die Mitglieder enthält, die in die Unterhaltung eingeschlossen werden sollen

Der Rückgabewert ist ein ResourceResponse, der eine Konversations-ID enthält, die für die Verwendung in den Nachrichtennutzlasten und REST-API-URIs geeignet ist.

Die meisten Kanäle unterstützen nur die Semantik von Bots, die eine direkte Nachrichtenunterhaltung initiieren. Ein Beispiel dafür wäre:

var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); await connect. Conversations.OnSendToConversationAsync(resource. ID, new Activity() ... ) ;

Ende.

Gilt für: