ChannelServiceHandlerBase.OnCreateConversationAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
API CreateConversation().
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)Paramètres
- claimsIdentity
- ClaimsIdentity
claimsIdentity pour le bot doit avoir AudienceClaim, AppIdClaim et ServiceUrlClaim.
- parameters
- ConversationParameters
Paramètres à partir duquel créer la conversation.
- cancellationToken
- CancellationToken
Jeton d'annulation.
Retours
tâche pour une réponse de ressource de conversation.
Remarques
Remplacez cette méthode pour créer une conversation.
POST vers cette méthode avec un * Bot étant le bot qui crée la conversation * IsGroup défini sur true s’il ne s’agit pas d’un message direct (la valeur par défaut est false) * Tableau contenant les membres à inclure dans la conversation
La valeur de retour est un ResourceResponse qui contient un ID de conversation qui peut être utilisé dans la charge utile de message et les URI de l’API REST.
La plupart des canaux prennent uniquement en charge la sémantique des bots qui lancent une conversation par message direct. Voici un exemple de procédure à suivre :
var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount(« user1 ») } ); await connect. Conversations.OnSendToConversationAsync(resource. Id, new Activity() ... ) ;
Fin.