チャネルリファレンス

[アーティクル]
12/26/2023

この記事の対象: SDK v4

この記事では、さまざまな Bot Framework 機能のチャンネルサポートについて説明します。

各チャンネルが送受信できるアクティビティの種類。
アダプティブカードを含め、各チャンネルで表示できるカードの種類。
各チャンネルでのカードアクションと推奨されるアクションのサポート。
さまざまなアクティビティの種類の一般的な分類。

プロトコルレベルでのアクティビティとカードの構造の詳細については、Bot Framework アクティビティとカードスキーマに関する記事を参照してください。

アダプティブカードは別のテクノロジです。詳細については、「adaptivecards.io」を参照してください。

チャンネル別のアクションのサポート

次の表は、特定のチャンネルが特定のアクティビティの種類をボットに送信できるかどうかを示しています。テーブル内では、次の用語は次の意味を持ちます。

用語	意味
はい	ボットはチャンネルからこのアクティビティを受信できます。
いいえ	ボットはチャンネルからこのアクティビティを受信できません。
[Undetermined](不明)	現在は未確定です。

チャネル	連絡先関係の更新	会話の更新	会話の終了	Event	インストールの更新	Invoke	メッセージ	メッセージの反応	メッセージの更新	メッセージの削除	Typing (入力)
Alexa	いいえ	番号	有効	有効	No	番号	有効	No	No	No	いいえ
Azure Communication Services チャット	いいえ	有効	無効	有効	No	番号	有効	無効	有効	Yes	はい
Direct Line	いいえ	有効	Yes	Yes	有効	無効	有効	No	No	番号	はい
Direct Line Speech							はい
Email	いいえ	No	いいえ	[Undetermined](不明)	いいえ	番号	有効	No	No	No	いいえ
Facebook	いいえ	有効	無効	有効	No	番号	有効	有効	No	No	いいえ
GroupMe	いいえ	有効	いいえ	[Undetermined](不明)	いいえ	番号	有効	No	No	No	いいえ
LINE	いいえ	有効	無効	有効	No	番号	有効	No	No	No	いいえ
Microsoft Teams	いいえ	有効	いいえ	[Undetermined](不明)	いいえ	有効	Yes	Yes	Yes	有効	いいえ
オムニチャネル							はい
Outlook (プレビュー)							はい
検索 (プレビュー)							はい
Slack	いいえ	有効	いいえ	[Undetermined](不明)	いいえ	番号	有効	無効	有効	有効	いいえ
Telegram	いいえ	有効	いいえ	[Undetermined](不明)	いいえ	番号	有効	無効	はい	[Undetermined](不明)	いいえ
Twilio (SMS)	いいえ	No	いいえ	[Undetermined](不明)	いいえ	番号	有効	No	No	No	いいえ
Web チャット	いいえ	有効	Yes	Yes	有効	無効	有効	No	No	番号	はい

event と invoke アクティビティのサポートは、アクティビティの名前によって異なり、チャンネルによって異なります。

チャネルによるカードのサポート

次の表は、特定のチャンネルが特定のカード型をレンダリングできるかどうかを示しています。チャンネルがカード型をレンダリングできる場合でも、チャンネルはカードのすべての機能をサポートしていない可能性があります。ボットをリリースする前に、ボットが送信できる各カードの動作をテストします。

テーブル内では、次の用語は次の意味を持ちます。

用語	意味
はい	カードはこのチャンネルでサポートされていますが、特定のチャンネルでサポートされるのは、カードアクションのサブセットのみであるか、各カードで許可されるアクションの数が制限される場合があります。
いいえ	このチャンネルでは、カードはサポートされていません。
Partial	部分的なサポート。カードに入力またはボタンが含まれている場合、このチャンネルではカードが表示されないことがあります。サポートのレベルはチャネルによって異なります。
Image	カードは画像に変換されます
テキスト	カードは、書式設定されていないテキストに変換されます。リンクのクリック、画像の表示、およびメディアの再生が実行できない場合があります。サポートのレベルはチャネルによって異なります。

チャネル	アダプティブカード	アニメーションカード	オーディオカード	ヒーローカード	領収書カード	サインインカード	サムネイルカード	ビデオカード
Alexa	いいえ	No	番号	有効	無効	有効	No	いいえ
Azure Communication Services チャット	あり*	はい	Yes	Yes	Yes	Yes	Yes	はい
Email	Image	テキスト	Text	はい	Yes	Yes	はい	テキスト
Facebook	画像、部分	はい	Yes	Yes	Yes	Yes	Yes	はい
GroupMe	Image	テキスト	テキスト	テキスト	テキスト	テキスト	テキスト	テキスト
LINE	画像、部分	はい	Text	はい	Yes	Yes	はい	テキスト
Microsoft Teams	はい	No	番号	有効	Yes	Yes	有効	いいえ
オムニチャネル
Outlook (プレビュー)
検索 (プレビュー)
Slack	イメージ	はい	テキスト	Text	はい	はい	テキスト	テキスト
Telegram	画像、部分	はい	Text	はい	Yes	Yes	Yes	はい
Twilio (SMS)	Image	テキスト	いいえ	テキスト	テキスト	テキスト	テキスト	いいえ
Web チャット	有効	Yes	Yes	Yes	Yes	Yes	Yes	はい

Note

Direct Line チャネルは技術的にすべてのカードをサポートしていますが、それらを実装するかどうかの判断はクライアントに任されます
*Azure Communication Services Chat に関して、アダプティブカードは、Azure Communication Services のユースケース内でのみサポートされ、Teams のユースケースではサポートされません。

チャンネル別のカードアクションのサポート

次のテーブルは、所定のチャンネルでサポートされるカードアクションと推奨されるアクションの最大数を示しています。値 "None" は、アクションの種類がチャネルでサポートされていないことを示します。

チャネル	推奨されるアクション	カードアクション
Alexa	なし	なし
Azure Communication Services チャット
Direct Line	100	100
Direct Line Speech	100	100
メール	なし	なし
Facebook	11	3
GroupMe	なし	なし
LINE	13	99
Microsoft Teams	なし	3
オムニチャネル
Outlook (プレビュー)
検索 (プレビュー)
Slack	なし	100
Telegram	100	100
Twilio (SMS)	なし	なし
Web チャット	100	100

カードアクションの詳細については、「メッセージにメディアを追加する」の「リッチカード内のイベントを処理する」を参照してください。
推奨されるアクションの詳細については、「入力にボタンを使用する方法」を参照してください。

アクティビティカテゴリ

アクティビティは、別々のカテゴリに分けることができます。アクティビティの種類ごとの詳細な説明と、アクティビティの各種類に含まれる情報については、「Bot Framework アクティビティスキーマ」を参照してください。

ようこそ

このカテゴリには、conversationUpdate アクティビティと contactRelationUpdate アクティビティが含まれます。

多くのチャンネルでは、会話更新アクティビティが送信されます。
- 多くの場合、ボットの [ウェルカム] 動作は、会話の更新アクティビティによってトリガーされます。ただし、信頼できるウェルカム動作を生成するには、会話またはユーザーの状態を使用する必要があります。
一部のチャンネルでは、連絡先関係の更新アクティビティが送信されます。
- ボットでこれらのチャンネルを使用する場合は、ボットのウェルカム動作にこのアクティビティのロジックを含める必要がある場合があります。

会話性

このカテゴリには、message、messageReaction、および endOfConversation アクティビティが含まれます。

すべてのチャンネルは、メッセージアクティビティを送受信できます。
- ダイアログを使用するボットの場合、通常はメッセージアクティビティをダイアログに渡す必要があります。
一部のチャネルでは、メッセージの反応アクティビティを送受信できます。
- ボットの設計によっては、メッセージの反応アクティビティをダイアログに渡すことができます。
- メッセージリアクションアクティビティは、ID によって以前のメッセージを参照します。
会話の終了アクティビティは、送信者の観点から会話の終了を通知します。
- 会話の終了アクティビティは、ボット間の通信でスキルのために使用されます。

ヒント

「メッセージの反応」は、前のコメントに対する「サムズアップ (グッド、賛成など)」のようなものを含みます。これらは順不同で発生する可能性があるため、ボタンと同じように考えることができます。このタイプのアクティビティは Teams チャンネルによって送信されます。

メッセージの更新と削除

このカテゴリには、messageUpdate アクティビティと messageDelete アクティビティが含まれます。

Teams では、メッセージの更新と削除のアクティビティがサポートされています。

アプリケーションの拡張性

このカテゴリには、event アクティビティと invoke アクティビティが含まれます。呼び出しアクティビティの意味は、その name フィールドにより定義されており、チャンネルのスコープ内で意味があります。

クライアントとサーバーの両方を所有するアプリケーションは、イベントアクティビティを使用して、クライアントとサーバーの間でプログラム情報を通信できます。
- ほとんどのアクティビティの種類と同様に、イベントアクティビティは非同期です。
- Direct Line および Web チャットは機能拡張メカニズムとしてイベントアクティビティを使用します。
呼び出しアクティビティはアプリケーションに固有のものであり、クライアントが定義するものではありません。
- 他のアクティビティの種類とは異なり、アクティビティの呼び出しは同期的です。 (現在、ボット上で要求/応答動作をトリガーするアクティビティは Invoke だけです。)
- Microsoft Teams は呼び出しアクティビティを使用し、Teams 固有の呼び出しアクティビティをいくつか定義します。

認証

OAuth プロンプトがダイアログを操作するには、TeamsVerification 呼び出しアクティビティをダイアログに転送する必要があります。

未分類

installationUpdate、typing、および handoff アクティビティは、他のカテゴリに意味を持って適合しません。

インストール更新アクティビティは、チャンネルの組織単位内のボットのインストールまたはアンインストールを表します。
入力アクティビティは、ユーザーまたはボットからの継続的な入力を表します。
ハンドオフアクティビティは、ボット内の要素間のフォーカスの変化を要求または通知します。 ハンドオフ アクティビティは、「ハンドオフ」という名前のイベント アクティビティとは異なります。

使用されていないアクティビティ (支払い固有の呼び出しを含む)

これらのアクティビティの種類は使用されなくなりました。

deleteUserData
handoff
ping
Address 呼び出し
PaymentRequest 呼び出し

追加情報

すべてのチャンネルで message アクティビティを送受信できます。

ヒント

ボットにチャンネルのサポートを追加する場合は、チャネルの開発者ドキュメントを理解してください。各チャンネルには、会話のさまざまな側面に関して異なる制限があります。違いは次のとおりです。

ボットが各 HTTP 要求を処理する必要がある時間。
ボットが特定のユーザーアクティビティに応答しないアクティビティを送信できるかどうか。
特定の期間内にボットが送信できるメッセージの数。
カードのレンダリング方法と、サポートされているカード。

チャネル リファレンス