BotAdapter.CreateConversationAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una conversazione nel canale specificato.
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
Parametri
- botAppId
- String
ID applicazione del bot.
- channelId
- String
ID del canale.
- serviceUrl
- String
Endpoint dell'URL del servizio del canale.
- audience
- String
Destinatari del connettore.
- conversationParameters
- ConversationParameters
Informazioni sulla conversazione da usare per creare la conversazione.
- callback
- BotCallbackHandler
Metodo da chiamare per il turno del bot risultante.
- cancellationToken
- CancellationToken
Token di annullamento utilizzabile da altri oggetti o thread per ricevere l'avviso dell'annullamento.
Restituisce
Attività che rappresenta il lavoro in coda da eseguire.
Commenti
Per avviare una conversazione, il bot deve conoscere le informazioni sull'account e le informazioni sull'account dell'utente su tale canale. La maggior parte dei _channels supporta solo l'avvio di una conversazione diretta di messaggi (non di gruppo).
L'adapter tenta di creare una nuova conversazione nel canale e quindi invia un'attività conversationUpdate
tramite la pipeline middleware al callback
metodo .
Se la conversazione viene stabilita con gli utenti specificati, l'ID dell'attività conterrà l'ID Conversation della nuova conversazione.