BotAdapter.CreateConversationAsync 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.
Cria uma conversa no canal especificado.
public virtual System.Threading.Tasks.Task CreateConversationAsync (string botAppId, string channelId, string serviceUrl, string audience, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, System.Threading.CancellationToken cancellationToken);
abstract member CreateConversationAsync : string * string * string * string * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateConversationAsync : string * string * string * string * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function CreateConversationAsync (botAppId As String, channelId As String, serviceUrl As String, audience As String, conversationParameters As ConversationParameters, callback As BotCallbackHandler, cancellationToken As CancellationToken) As Task
Parâmetros
- botAppId
- String
A ID do aplicativo do bot.
- channelId
- String
A ID do canal.
- serviceUrl
- String
O ponto de extremidade da URL de serviço do canal.
- audience
- String
O público-alvo do conector.
- conversationParameters
- ConversationParameters
As informações de conversa a serem usadas para criar a conversa.
- callback
- BotCallbackHandler
O método a ser chamado para a volta do bot resultante.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber um aviso de cancelamento.
Retornos
Uma tarefa que representa o trabalho enfileirado a ser executado.
Comentários
Para iniciar uma conversa, seu bot deve saber suas informações de conta e as informações da conta do usuário nesse canal. A maioria dos _channels dá suporte apenas ao início de uma conversa de mensagem direta (não grupo).
O adaptador tenta criar uma nova conversa no canal e, em seguida, envia uma conversationUpdate
atividade por meio de seu pipeline de middleware para o callback
método .
Se a conversa for estabelecida com os usuários especificados, a ID da atividade Conversation conterá a ID da nova conversa.