BotAdapter.CreateConversationAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma conversação 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
O ID da aplicação do bot.
- channelId
- String
O ID do canal.
- serviceUrl
- String
O ponto final do URL de serviço do canal.
- audience
- String
A audiência do conector.
- conversationParameters
- ConversationParameters
As informações de conversação a utilizar para criar a conversação.
- callback
- BotCallbackHandler
O método a chamar para a viragem do bot resultante.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser utilizado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
Uma tarefa que representa o trabalho em fila para executar.
Observações
Para iniciar uma conversação, o bot tem de saber as informações da conta e as informações da conta do utilizador nesse canal. A maioria dos _channels suporta apenas iniciar uma conversação de mensagem direta (não grupo).
O adaptador tenta criar uma nova conversação no canal e, em seguida, envia uma conversationUpdate
atividade através do pipeline de middleware para o callback
método .
Se a conversação for estabelecida com os utilizadores especificados, o ID da atividade Conversation conterá o ID da nova conversação.