ChannelServiceHandlerBase.OnCreateConversationAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
API CreateConversation().
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)
Parâmetros
- claimsIdentity
- ClaimsIdentity
claimsIdentity para o bot deve ter AudienceClaim, AppIdClaim e ServiceUrlClaim.
- parameters
- ConversationParameters
Parâmetros para criar a conversa.
- cancellationToken
- CancellationToken
O token de cancelamento.
Retornos
tarefa para uma resposta de recurso de conversa.
Comentários
Substitua esse método para criar uma nova Conversa.
POST para esse método com um * Bot sendo o bot criando a conversa * IsGroup definido como true se esta não for uma mensagem direta (o padrão é false) * Matriz que contém os membros a serem incluídos na conversa
O valor retornado é um ResourceResponse que contém uma ID de conversa adequada para uso no conteúdo da mensagem e nos URIs da API REST.
A maioria dos canais dá suporte apenas à semântica de bots que iniciam uma conversa direta com mensagens. Um exemplo de como fazer isso seria:
var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); await connect. Conversations.OnSendToConversationAsync(resource. Id, new Activity() ... ) ;
Final.