ChannelServiceHandlerBase.OnCreateConversationAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
CreateConversation() API.
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 el bot, debe tener AudienceClaim, AppIdClaim y ServiceUrlClaim.
- parameters
- ConversationParameters
Parámetros a partir de los que se va a crear la conversación.
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
tarea para una respuesta de recursos de conversación.
Comentarios
Invalide este método para crear una nueva conversación.
POST para este método con un * Bot que crea la conversación * IsGroup establecido en true si no es un mensaje directo (el valor predeterminado es false) * Matriz que contiene los miembros que se van a incluir en la conversación
El valor devuelto es un ResourceResponse que contiene un identificador de conversación que es adecuado para su uso en la carga del mensaje y los URI de la API REST.
La mayoría de los canales solo admiten la semántica de los bots que inician una conversación de mensaje directo. Un ejemplo de cómo hacerlo sería:
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.