チャネル リファレンス
この記事の対象: SDK v4
この記事では、さまざまな Bot Framework 機能のチャンネル サポートについて説明します。
- 各チャンネルが送受信できるアクティビティの種類。
- アダプティブ カードを含め、各チャンネルで表示できるカードの種類。
- 各チャンネルでのカード アクションと推奨されるアクションのサポート。
- さまざまなアクティビティの種類の一般的な分類。
プロトコル レベルでのアクティビティとカードの構造の詳細については、Bot Framework アクティビティとカード スキーマに関する記事を参照してください。
アダプティブ カードは別のテクノロジです。 詳細については、「adaptivecards.io」を参照してください。
チャンネル別のアクションのサポート
次の表は、特定のチャンネルが特定のアクティビティの種類をボットに送信できるかどうかを示しています。 テーブル内では、次の用語は次の意味を持ちます。
| 用語 | 意味 |
|---|---|
| はい | ボットはチャンネルからこのアクティビティを受信できます。 |
| いいえ | ボットはチャンネルからこのアクティビティを受信できません。 |
| [Undetermined](不明) | 現在は未確定です。 |
| Channel | 連絡先関係の更新 | 会話の更新 | 会話の終了 | Event | インストールの更新 | Invoke | メッセージ | メッセージの反応 | メッセージの更新 | メッセージの削除 | Typing (入力) |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Alexa | いいえ | 番号 | イエス | はい | いいえ | 番号 | 有効 | いいえ | いいえ | いいえ | いいえ |
| Azure Communication Services | いいえ | 有効 | いいえ | 有効 | いいえ | 番号 | 有効 | いいえ | イエス | イエス | はい |
| Direct Line | いいえ | イエス | イエス | イエス | はい | いいえ | 有効 | いいえ | いいえ | 番号 | はい |
| Direct Line Speech | はい | ||||||||||
| いいえ | いいえ | いいえ | [Undetermined](不明) | いいえ | 番号 | 有効 | いいえ | いいえ | いいえ | いいえ | |
| いいえ | 有効 | いいえ | 有効 | いいえ | 番号 | イエス | はい | いいえ | いいえ | いいえ | |
| GroupMe | いいえ | 有効 | いいえ | [Undetermined](不明) | いいえ | 番号 | 有効 | いいえ | いいえ | いいえ | いいえ |
| LINE | いいえ | 有効 | いいえ | 有効 | いいえ | 番号 | 有効 | いいえ | いいえ | いいえ | いいえ |
| Microsoft Teams | いいえ | 有効 | いいえ | [Undetermined](不明) | いいえ | イエス | イエス | イエス | イエス | はい | いいえ |
| オムニチャネル | はい | ||||||||||
| Outlook (プレビュー) | はい | ||||||||||
| 検索 (プレビュー) | はい | ||||||||||
| Slack | いいえ | 有効 | いいえ | [Undetermined](不明) | いいえ | 番号 | 有効 | いいえ | イエス | はい | いいえ |
| Telegram | いいえ | 有効 | いいえ | [Undetermined](不明) | いいえ | 番号 | 有効 | いいえ | はい | [Undetermined](不明) | いいえ |
| Twilio (SMS) | いいえ | いいえ | いいえ | [Undetermined](不明) | いいえ | 番号 | 有効 | いいえ | いいえ | いいえ | いいえ |
| Web チャット | いいえ | イエス | イエス | イエス | はい | いいえ | 有効 | いいえ | いいえ | 番号 | はい |
event と invoke アクティビティのサポートは、アクティビティの名前によって異なり、チャンネルによって異なります。
チャネルによるカードのサポート
次の表は、特定のチャンネルが特定のカード型をレンダリングできるかどうかを示しています。 チャンネルがカード型をレンダリングできる場合でも、チャンネルはカードのすべての機能をサポートしていない可能性があります。 ボットをリリースする前に、ボットが送信できる各カードの動作をテストします。
テーブル内では、次の用語は次の意味を持ちます。
| 用語 | 意味 |
|---|---|
| はい | カードはこのチャンネルでサポートされていますが、特定のチャンネルでサポートされるのは、カードアクションのサブセットのみであるか、各カードで許可されるアクションの数が制限される場合があります。 |
| いいえ | このチャンネルでは、カードはサポートされていません。 |
| 部分的 | 部分的なサポート。 カードに入力またはボタンが含まれている場合、このチャンネルではカードが表示されないことがあります。 サポートのレベルはチャネルによって異なります。 |
| Image | カードは画像に変換されます |
| Text | カードは、書式設定されていないテキストに変換されます。 リンクのクリック、画像の表示、およびメディアの再生が実行できない場合があります。 サポートのレベルはチャネルによって異なります。 |
| Channel | アダプティブ カード | アニメーション カード | オーディオ カード | ヒーロー カード | 領収書カード | サインイン カード | サムネイル カード | ビデオ カード |
|---|---|---|---|---|---|---|---|---|
| Alexa | いいえ | いいえ | 番号 | 有効 | いいえ | 有効 | いいえ | いいえ |
| Azure Communication Services | あり* | はい | イエス | イエス | イエス | イエス | イエス | はい |
| Image | テキスト | Text | はい | イエス | イエス | はい | Text | |
| 画像、部分 | はい | イエス | イエス | イエス | イエス | イエス | はい | |
| GroupMe | Image | テキスト | テキスト | テキスト | テキスト | テキスト | テキスト | テキスト |
| LINE | 画像、部分 | はい | Text | はい | イエス | イエス | はい | Text |
| Microsoft Teams | はい | いいえ | 番号 | イエス | イエス | イエス | はい | いいえ |
| オムニチャネル | ||||||||
| Outlook (プレビュー) | ||||||||
| 検索 (プレビュー) | ||||||||
| Slack | イメージ | はい | テキスト | Text | はい | はい | テキスト | テキスト |
| Telegram | 画像、部分 | はい | Text | はい | イエス | イエス | イエス | はい |
| Twilio (SMS) | Image | テキスト | いいえ | テキスト | テキスト | テキスト | テキスト | いいえ |
| Web チャット | 有効 | イエス | イエス | イエス | イエス | イエス | イエス | はい |
Note
- Direct Line チャネルは技術的にすべてのカードをサポートしていますが、それらを実装するかどうかの判断はクライアントに任されます
- *Azure Communication Services Chat に関して、アダプティブ カードは、Azure Communication Services のユース ケース内でのみサポートされ、Teams のユース ケースではサポートされません。
チャンネル別のカード アクションのサポート
次のテーブルは、所定のチャンネルでサポートされるカード アクションと推奨されるアクションの最大数を示しています。 値 "None" は、アクションの種類がチャネルでサポートされていないことを示します。
| Channel | 推奨されるアクション | カード アクション |
|---|---|---|
| Alexa | なし | なし |
| Azure Communication Services | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| メール | なし | なし |
| 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 アクティビティは、他のカテゴリに意味を持って適合しません。
- インストール更新アクティビティは、チャンネルの組織単位内のボットのインストールまたはアンインストールを表します。
- 入力アクティビティは、ユーザーまたはボットからの継続的な入力を表します。
- ハンドオフ アクティビティは、ボット内の要素間のフォーカスの変化を要求または通知します。 ハンドオフ アクティビティは、「ハンドオフ」 という名前のイベント アクティビティとは異なります。
使用されていないアクティビティ (支払い固有の呼び出しを含む)
これらのアクティビティの種類は使用されなくなりました。
deleteUserDatahandoffpingAddress呼び出しPaymentRequest呼び出し
追加情報
すべてのチャンネルで message アクティビティを送受信できます。
ヒント
ボットにチャンネルのサポートを追加する場合は、チャネルの開発者ドキュメントを理解してください。各チャンネルには、会話のさまざまな側面に関して異なる制限があります。 違いは次のとおりです。
- ボットが各 HTTP 要求を処理する必要がある時間。
- ボットが特定のユーザー アクティビティに応答しないアクティビティを送信できるかどうか。
- 特定の期間内にボットが送信できるメッセージの数。
- カードのレンダリング方法と、サポートされているカード。