Sprache

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 zum Erstellen der Unterhaltung aus.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Vorgang für eine Ressourcenantwort für Unterhaltungen.

Hinweise

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

POST zu dieser Methode mit einem * Bot als Bot, der die Konversation erstellt * IsGroup auf true gesetzt, falls dies keine Direktnachricht ist (standardmäßig falsch) * Array, das die Mitglieder enthält, die in die Konversation aufgenommen werden sollen

Der Rückgabewert ist eine ResourceResponse, die eine Konversations-ID enthält, die für die Verwendung im Nachrichtenpayload und in 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(Ressource. id, neue Aktivität ... ) ;

Ende.

Gilt für: