メッセージの拡張機能のビルド

メッセージ拡張機能を使用すると、ユーザーは Microsoft Teams クライアント内のボタンとフォームを使用して Web サービスに参加できます。ユーザーは、外部システムのメッセージ作成領域、コマンドボックスから、またはメッセージから直接、操作を検索したり、開始したりできます。これらの操作の結果は、書式設定されたカードとして Teams クライアントに返すことができます。

重要

メッセージ拡張機能は、Government Community Cloud (GCC)、GCC High、国防総省 (DoD)、21Vianet 環境で運用されている Teams で使用できます。

この記事では、メッセージ拡張機能、ユースケース、機能、アクションコマンドと検索コマンド、リンク展開の概要について説明します。

次の図は、ユーザーがメッセージ拡張機能を呼び出すことができる場所を示しています:

注:

作成ボックスにメッセージ表示オプションを @mention することはできません。
Teams では、外部ユーザーとのグループチャットのメッセージ拡張機能オプションはサポートされていません。

デスクトップ
モバイル

拡張機能が Teams デスクトップ上の場所を呼び出すというメッセージを示すスクリーンショット。

メッセージ拡張機能が使用されるシナリオ

シナリオ	例
アクションを実行して会話に結果を返すには、外部システムが必要です。	リソースの予約、予約されたタイムスロットをチャネルに知らせます。
外部システムで何かを検索し、その結果を会話と共有する必要があります。	Azure DevOps で作業項目を検索し、アダプティブカードとしてグループと共有します。
外部システムで複数のステップまたは大量の情報を含む複雑なタスクを完了し、その結果を会話で共有したい場合。	Teams メッセージに基づいて追跡システムにバグを作成し、そのバグを割り当て、バグの詳細を記載したカードを会話スレッドに送信します。

メッセージ拡張機能のしくみを理解する

メッセージ拡張機能は、ホストする Web サービスと、Teams クライアント内で Web サービスが呼び出される場所を定義するアプリマニフェストで構成されます。 Web サービスは Bot Framework のメッセージングスキーマとセキュリティで保護された通信プロトコルを使用するため、Bot Framework にボットとして Web サービスを登録する必要があります。

注:

Web サービスを手動で作成することもできますが、プロトコルを操作するには Bot Framework SDK を使用します。

アプリマニフェスト (以前は Teams アプリマニフェストと呼ばれていました) では、最大 10 個の異なるコマンドを含む 1 つのメッセージ拡張機能を定義します。各コマンドは、アクションや検索などの種類と、メッセージ拡張機能が呼び出されるクライアント内の場所を定義します。呼び出しの場所には、メッセージの作成領域、コマンドバー、メッセージが含まれます。メッセージ拡張機能を呼び出すと、Web サービスはすべての関連情報を含む JSON ペイロードを含む HTTPS メッセージを受信します。 JSON ペイロードを使用して応答し、Teams クライアントに有効にする次の操作を通知します。

メッセージ拡張機能コマンドの種類

メッセージ拡張コマンドには、アクションコマンドと検索コマンドの 2 種類があります。メッセージ拡張機能のコマンドの種類は、Web サービスで利用可能な UI 要素と操作フローを定義します。どちらのコマンドタイプでも、認証と構成の相互作用が提供されます。

操作コマンド

アクションコマンドを使用して、情報を収集または表示するためのモーダルポップアップをユーザーに表示します。ユーザーがフォームを送信すると、Web サービスは、スレッドに直接、またはメッセージ作成領域にメッセージを挿入することで応答します。その後、ユーザーはメッセージを送信できます。より複雑なワークフローの場合は、複数のフォームをリンクできます。

メッセージ作成領域、コマンドボックス、またはメッセージからアクションコマンドをトリガーします。メッセージからコマンドを呼び出すと、ボットに送信される最初の JSON ペイロードには、ボットが呼び出されたメッセージ全体が含まれます。次の図は、メッセージ拡張機能アクションコマンドダイアログ (TeamsJS v1.x ではタスクモジュールと呼ばれています) を表示します。

メッセージ拡張機能アクションコマンドダイアログ

検索コマンド

検索コマンドを使用すると、外部システムで情報を検索できます。検索コマンドを使用するには、検索ボックスにクエリを手動で入力するか、メッセージの作成領域に監視対象ドメインへのリンクを挿入してから、検索結果をメッセージに埋め込みます。単純な検索コマンドフローでは、最初の呼び出しメッセージには、ユーザーが送信した検索文字列が含まれます。カードのリストとカードのプレビューで応答します。 Teams クライアントは、ユーザーのカードプレビューのリストをレンダリングします。ユーザーがリストからカードを選択すると、フルサイズのカードがメッセージ作成領域に挿入されます。

カードは、メッセージの作成領域またはコマンドボックスからトリガーしますが、メッセージからはトリガーしません。メッセージからトリガーすることはできません。次の画像は、メッセージ拡張機能の検索コマンドダイアログを示しています。

注:

カードの詳細については、「カードとは」を参照してください。

リンク展開

注:

リンクの展開は、ボットベースのメッセージ拡張機能でのみサポートされています。

メッセージ作成領域に URL を貼り付けると、Teams は Web サービスを呼び出します。この機能は、リンク展開として知られています。特定のドメインを含む URL が作成メッセージ領域に貼り付けられたときに呼び出しメッセージを受信するようにサブスクライブできます。 Web サービスでは、URL を展開して詳細なカードを作成し、標準の Web サイトプレビューカードよりも多くの情報を提供できます。ユーザーが Teams クライアントを離れることなくすぐにアクションを実行できるボタンを追加できます。次の画像は、メッセージ表示オプションにリンクを貼り付けた場合のリンク展開機能を示しています。

リンクを展開する

リンクの展開