ChannelServiceHandlerBase.OnCreateConversationAsync 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.
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.