Microsoft Teams にプロアクティブ メッセージを送信できるボットを構築する
Teams Toolkit for Visual Studio Code 拡張機能には、ボットを構築するためのシナリオ ベースのアプリ テンプレートがいくつか用意されています。 チャット通知ボットのシナリオベースのアプリ テンプレートは、Microsoft Teams にプロアクティブな通知を送信するためにトリガーできるボットを作成します。 プロアクティブ メッセージは、外部イベントまたはトリガーに応答して送信されるメッセージです。 このテンプレートを使用して、次のユニットでボットを作成します。
注:
このモジュールの演習では、Teams Toolkit v5.0.0 を使用します。
ボットを構築するためのコンポーネント
Teams 用のボットを開発するには、次のものが必要です。
- ボット コードをホストして実行する Web サーバー 。
- ボットを Teams で使用できるようにする Azure Bot Service ボット 。
- ボットを Microsoft Cloud に登録するための Microsoft Entra アプリ 。
- ボット サービスからメッセージを受信するために使用されるローカル エンドポイントのパブリックにアクセス可能な URL を提供する HTTP トンネル サービス。
- ボットを Teams にデプロイするための Microsoft Teams アプリ パッケージ 。 このパッケージには、ボットの機能とボットをインストールできる場所 (チャット、チャネル、会議、個人用アプリ) が記述されたアプリ マニフェスト ファイルがあります。
セットアップの簡略化
Teams Toolkit for Visual Studio Code は、ボットの開発に必要なリソースの作成と構成の複雑さを処理します。 ボットを初めて実行すると、次の手順が実行されます。
- 前提条件を確認してインストールします。
- VisualStudio Dev Tunnel サービスを使用して HTTP トンネルを開始します。
- Microsoft Entra アプリの登録を作成します。
- Azure Bot Service 登録を作成します。
- ボット コードをコンパイルし、ローカル Web サーバーを起動します。
- Teams アプリ パッケージを生成します。
- アプリ パッケージを Teams にデプロイします。
- デバッグ セッションを開始します。
- ブラウザー ウィンドウを開き、Teams Web クライアントに移動し、アプリのインストール ダイアログを表示します。
プロアクティブ メッセージ
Teams に送信されるプロアクティブ メッセージをトリガーするには、ローカル Web サーバーでホストされている通知エンドポイントに HTTP POST
要求を送信します。 任意の HTTP クライアントを使用して要求を送信できます。 たとえば、cURL や PowerShell などのコマンド ライン ツール、Postman などのデスクトップ アプリケーション、Azure Functions などのクラウド サービスを使用できます。
アダプティブ カード
ボットは、 アダプティブ カード と呼ばれる対話型カードを、プロアクティブ メッセージとして Teams に送信できます。 アダプティブ カードは、幅広いプラットフォームやデバイスで使用できる、リッチで一貫性のある対話型エクスペリエンスを作成するための強力で柔軟な方法を提供します。
次の演習では、通知ボットのシナリオベースのアプリ テンプレートを使用して Teams 用 のボット を作成する方法について説明します。 また、ボットをトリガーして、コマンド ラインからアダプティブ カードを Teams に送信する方法についても説明します。