ChannelServiceHandlerBase.OnCreateConversationAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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)パラメーター
- claimsIdentity
- ClaimsIdentity
ボットの claimsIdentity には、AudienceClaim、AppIdClaim、ServiceUrlClaim が必要です。
- parameters
- ConversationParameters
会話の作成元となるパラメーター。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
会話リソース応答のタスク。
注釈
新しい Conversation を作成するには、このメソッドをオーバーライドします。
会話を作成するボットである * ボットを使用してこのメソッドに POST する * 直接メッセージでない場合は IsGroup を true に設定する (既定値は false) * 会話に含めるメンバーを含む配列
戻り値は ResourceResponse で、メッセージ ペイロードと REST API URI での使用に適した会話 ID が含まれています。
ほとんどのチャネルでは、直接メッセージ会話を開始するボットのセマンティクスのみがサポートされます。 その方法の例を次に示します。
var resource = await connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); await connect.Conversations.OnSendToConversationAsync(resource.ID、新しい Activity() ... );
終わり。