Webhook を使用して外部アプリを統合する - Teams

重要

Microsoft 365 コネクタ (以前は Office 365 コネクタ) は非推奨に近づいています。新しい Microsoft 365 コネクタの作成は間もなくブロックされます。スケジュールの詳細と、ワークフローアプリがより柔軟で安全なエクスペリエンスを提供する方法については、 Microsoft Teams内の Microsoft 365 コネクタの廃止に関するページを参照してください。

Teams で Webhook を作成するにはどうすればよいですか?

Webhook 要求の受信時にチャットまたはチャネルに自動的に投稿するには、定義済みのワークフローテンプレートを使用するか、[ Teams Webhook 要求が受信されたとき ] トリガーを使用してワークフローを最初から作成します。詳細については、「 webhook 要求がMicrosoft Teamsで受信されたときにワークフローを投稿する」を参照してください。
Teams Webhook 要求が受信されたときのトリガーの詳細については、「Microsoft Teams - Webhook」を参照してください。

Office 365 コネクタを既に構築している場合:

Power Automate コネクタを作成する: Power Automate は、Teams で広く使用されているワークフローアプリを強化します。これは、Teams との間でプログラムによってデータを送信するためのスケーラブルで安全なアプローチです。この方法を採用する場合は、製品から Teams チャネルにアラートを投稿するためのワークフローテンプレートを作成できます。この方法により、新しい方法のユーザーの導入が簡略化されます。詳細については、エンタープライズ開発者、ISV、パートナー向けの Power Automate に関するページを参照してください。
Teams アプリを更新する: 現在の Teams アプリを強化できます。たとえば、ユーザーがシステム内のトリガーイベントに基づいてプロアクティブメッセージを設定できるようにします。詳細については、ボットがプロアクティブメッセージを通じてチャネルに投稿する方法に関するページを参照してください。

既知の問題

ワークフローアプリは、プライベートチャネルでフローボットとして投稿できません。ただし、ユーザーに代わって投稿することはできます。
ワークフローでは、アダプティブカードのみがサポートされます。コネクタで使用される古いメッセージカード形式Office 365サポートされていません。ワークフローでは、メッセージカード形式の使用はサポートされていません。詳細については、コネクタメッセージカード形式をアダプティブカードに変換する方法に関するページを参照してください。
ワークフローには、DataDog や Jenkins などのサードパーティ製コネクタは用意されていません。
ワークフローは、既定の環境でのみ作成できます。

限界事項

ワークフローは、特定のユーザー (ワークフローの所有者と呼ばれます) にのみリンクされ、Teams チームまたはチャネルにはリンクされません。共同所有者が割り当てられていない場合、ワークフローは所有者が存在しない場合に孤立フローになる可能性があります。フローによって自動化されたビジネスプロセスの継続性を維持するために、管理者は 1 人以上の共同所有者を追加し、ワークフローを完全に制御できます。また、接続の認証 (存在する場合) を追加し、フローが無効になっている場合はフローを有効にすることもできます。詳細については、「孤立フローの管理」を参照してください。

Webhook は、外部アプリとの統合をMicrosoft Teamsするのに役立ちます。 Teams では、送信 Webhook はボットとして機能し、@メンションを使用してチャネル内のメッセージを検索します。送信 Webhook を使用すると、ユーザーは、Microsoft Bot Frameworkを介してボットを作成するプロセス全体を実行することなく、Web サービスにメッセージを送信できます。送信 Webhook は、Teams から JSON ペイロードを受け入れることのできる任意のサービスにデータを投稿します。

送信 Webhook の主な機能

任意の外部 Web サービスに通知を送信します。
カードや画像を含むリッチテキストメッセージで応答します。
個人用またはプライベートスコープ内ではなく、パブリックチャネルでメッセージを受信します。
HTTP POST を Web サービスに送信し、応答を取得します。

注:

送信 Webhook は、チーム内のチャネルの名簿やリストを取得するなど、他の API にはアクセスできません。

このステップバイステップガイドは、Teams で送信 Webhook を作成するのに役立ちます。次の出力が表示されます。

Teams チャネルの送信 Webhook を示すスクリーンショット。

前提条件

残り 10 分

次のツールをインストールし、開発環境を設定していることを確認します。

	インストール	使用するには...
	Microsoft Teams	Microsoft Teams、チャット、会議、通話を 1 か所で行うためにアプリを通じて作業するすべてのユーザーと共同作業を行うことができます。
	Visual Studio 2022	Visual Studio 2022 でエンタープライズバージョンをインストールし、ASP.NET および Web 開発ワークロードをインストールできます。最新バージョンを使用します。
	開発トンネル	Teams アプリの機能 (会話型ボット、メッセージ拡張機能、受信 Webhook) には、受信接続が必要です。トンネルは、開発システムを Teams に接続します。開発トンネルは、localhost をインターネットに安全に開き、アクセス権を持つユーザーを制御するための強力なツールです。開発トンネルは、Visual Studio 2022 バージョン 17.7.0 以降で使用できます。または ngrok をトンネルとして使用して、開発システムを Teams に接続することもできます。タブのみを含むアプリには必要ありません。このパッケージはプロジェクトディレクトリ内にインストールされます (npm `devDependencies` を使用)。

注:

ngrok をダウンロードしたら、サインアップして authtoken をインストールします。

ローカル環境を設定する

残り 9 分

Microsoft-Teams-Samples を開きます。
[ コード] を選択します。
ドロップダウンメニューから、[ GitHub Desktop で開く] を選択します。
[ 複製] を選択します。

送信 Webhook を作成する

残り 8 分

トンネルを作成する

dev tunnel
ngrok

Visual Studio を開きます。
[ 新しいプロジェクトの作成] を選択します。
検索ボックスに「ASP.NET」と入力します。検索結果から [ASP.NET Core Web アプリ] を選択します。
[次へ] を選択します。
「プロジェクト名」と入力し、[次へ] を選択します。
[作成] を選択します。

概要ウィンドウが表示されます。
デバッグドロップダウンリストで、[Dev Tunnel (アクティブトンネルなし)]>[トンネルの作成]を選択します。...

ポップアップウィンドウが表示されます。
ポップアップウィンドウで次の詳細を更新します。
1. アカウント: Microsoft または GitHub アカウントを入力します。
2. [名前]: トンネルの名前を入力します。
3. トンネルの種類: ドロップダウンリストから [ 一時] を選択します。
4. アクセス: ドロップダウンリストから [パブリック] を選択 します。
[OK] を選択します。

開発トンネルが正常に作成されたことを示すポップアップウィンドウが表示されます。
[OK] を選択します。

作成したトンネルは、次のようにデバッグドロップダウンリストにあります。
F5 キーを押して、デバッグモードでアプリケーションを実行します。
[セキュリティ警告] ダイアログが表示されたら、[はい] を選択します。

ポップアップウィンドウが表示されます。
[続行] を選択します。

開発トンネルのホームページが新しいブラウザーウィンドウで開き、開発トンネルがアクティブになりました。
Visual Studio に移動し、[ 表示] > [出力] を選択します。
[出力コンソール] ドロップダウンメニューで、[Dev Tunnels]\(開発トンネル\) を選択します。

出力コンソールには、開発トンネル URL が表示されます。

ngrok またはコマンドプロンプトを使用して、ローカルで実行されている Web サーバーのパブリックに利用可能な HTTPS エンドポイントへのトンネルを作成します。 ngrok で次のコマンドを実行します。

ngrok http --host-header=localhost 3978

ヒント

ERR_NGROK_4018が発生した場合は、コマンドプロンプトに記載されている手順に従ってサインアップし、ngrok を認証します。 ngrok http --host-header=localhost 3978 コマンドを実行します。

ウィンドウに HTTPS URL が表示されます。

ngrok HTTPS URL を示すスクリーンショット。

[Teams] に移動し、左側のウィンドウから [Teams] を選択します。
目的のチームに移動し、[その他のオプション (••)]、[ チームの管理] の順に選択します。
ナビゲーションバーから [ アプリ ] タブを選択します。
ウィンドウの右下隅にある [ 送信 Webhook の作成 ] を選択します。
次の詳細を入力します:
- 名前: [ @mention ] タブの webhook タイトル。
- コールバック URL: JSON ペイロードを受け取り、Teams から POST 要求を受け取る ngrok から生成された URL。 api/Sampleまたはapi/authenticatedSampleを使用するには、次の操作を行います。
  - api サンプルの場合は、 dev tunnel または ngrok URL をコピーして貼り付け、 /api/sampleに追加します。
  - api authenticatedSample の場合は、 dev tunnel または ngrok URL をコピーして貼り付け、 /authenticatedSample?id=contosoに追加します。
- 説明: プロファイルカードとチームレベルのアプリダッシュボードに表示される詳細な文字列。
- プロファイル画像 (省略可能): Webhook のアプリアイコン。
[作成] を選択します。送信 Webhook は、現在のチームのチャネルに追加されます。
Hash-based Message Authentication Code (HMAC) ダイアログが表示されます。 AuthProvider.cs ファイル内のセキュリティトークンを使用して、Teams と指定された外部サービス間の呼び出しを認証できます。

注:

送信 Webhook は、URL が有効で、サーバーとクライアントの認証トークンが等しい場合にのみ、チームのユーザーが使用できます。たとえば、HMAC ハンドシェイクなどです。

サービスをビルドして実行する

残り 3 分

Visual Studio を開きます。
[ファイル>Open>Project/Solution...] に移動します。
csharp フォルダーから、ファイルWebhookSampleBot.sln選択します。
[AuthProvider.cs ファイル] に移動します。 contosoをM365x70471008に更新し、HMAC を追加します。
F5 キーを押してプロジェクトを実行します。
以下のダイアログが表示されたら、[はい] を選択します:

Web ページにローカルホスト情報が表示されます。

Teams でアプリを操作する

残り 2 分

[Teams] に移動し、左側のウィンドウから [Teams] を選択します。
[ 全般>新しい会話] に移動します。
チャネルで送信 Webhook を呼び出すには、@メンション送信 Webhook 名を選択し、[送信] アイコンを選択します。

注:

アダプティブカード、ヒーローカード、テキストメッセージは、送信 Webhook で添付ファイルとして送信できます。
会議チャットに新しいメッセージが表示されます。

課題の完了

残り 1 分

このようなものを思いついたのですか?

デスクトップとモバイルに新しいメッセージを表示する会議チャットを示すスクリーンショット。

おめでとうございます。

100% 完了しました

送信 Webhook アプリの使用を開始するためのチュートリアルを完了しました。

次の方法で共有

送信 Webhook を構築する