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 d’une réponse de ressource de conversation.
Remarques
Remplacez cette méthode pour créer une conversation.
POST à cette méthode avec un * Bot étant le bot créant la conversation * IsGroup défini sur true si ce n’est pas un message direct (par défaut est faux) * Tableau contenant les membres à inclure dans la conversation
La valeur de retour est une ResourceResponse qui contient un identifiant de conversation adapté à l’utilisation dans la charge utile du 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 de 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(ressource. Id, nouvelle activité() ... ) ;
fin.