Conversations.CreateConversationWithHttpMessagesAsync Método

Definição

Namespace:

Microsoft.Bot.Connector

Assembly:

Microsoft.Bot.Connector.dll

Pacote:

Microsoft.Bot.Connector v4.22.7

Sobrecargas

CreateConversationWithHttpMessagesAsync(ConversationParameters, Dictionary<String,List<String>>, CancellationToken)

CreateConversation.

CreateConversationWithHttpMessagesAsync(ConversationParameters, Dictionary<String,List<String>>, CancellationToken)

CreateConversation.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Bot.Schema.ConversationResourceResponse>> CreateConversationWithHttpMessagesAsync (Microsoft.Bot.Schema.ConversationParameters parameters, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateConversationWithHttpMessagesAsync : Microsoft.Bot.Schema.ConversationParameters * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Bot.Schema.ConversationResourceResponse>>
override this.CreateConversationWithHttpMessagesAsync : Microsoft.Bot.Schema.ConversationParameters * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Bot.Schema.ConversationResourceResponse>>

Public Function CreateConversationWithHttpMessagesAsync (parameters As ConversationParameters, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of ConversationResourceResponse))

Parâmetros

parameters

ConversationParameters

Parâmetros para criar a conversa.

customHeaders

Dictionary<String,List<String>>

Cabeçalhos que serão adicionados à solicitação.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<Microsoft.Rest.HttpOperationResponse<ConversationResourceResponse>>

Um objeto de resposta que contém o corpo da resposta e os cabeçalhos de resposta.

Implementações

CreateConversationWithHttpMessagesAsync(ConversationParameters, Dictionary<String,List<String>>, CancellationToken)

Exceções

ErrorResponseException

Gerado quando a operação retornou um código de status inválido.

Microsoft.Rest.SerializationException

Gerado quando não é possível desserializar a resposta.

Microsoft.Rest.ValidationException

Gerado quando um valor de entrada não corresponde ao tipo de dados, intervalo ou padrão esperados.

ArgumentNullException

Gerado quando um parâmetro necessário é nulo.

Comentários

Crie uma nova Conversa.

POST para este 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 é falso) * 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 uris da API REST.

A maioria dos canais só dá suporte à semântica de bots que iniciam uma conversa de mensagem direta. 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.SendToConversationAsync(resource.Id, new
Activity() ... ) ;

.