Webhook とコネクタを作成する

[アーティクル]
04/30/2024

Webhook とコネクタは、Microsoft Teams のチャネルとチームに Web サービスを接続するのに役立ちます。 Webhook は、Teams チャネルで行われたアクションについてユーザーに通知するユーザー定義の HTTP コールバックです。これは、アプリがリアルタイムデータを取得する方法です。コネクタを使用すると、ユーザーは Web サービスから通知とメッセージをサブスクライブして受け取ることができます。サービスの HTTPS エンドポイントを公開して、カード形式でメッセージを投稿します。

重要

Webhook とコネクタは Government Community Cloud (GCC) 環境でのみ使用できますが、GCC-High および国防総省 (DOD) 環境では使用できません。
GCC-High 環境では受信 Webhook コネクタの種類のみが使用でき、テナント管理者は手動でアップロードしてコネクタページにアプリを表示する必要があります。
受信 Webhook 以外の通知ボット Teams アプリを構築することもできます。同様に実行されますが、通知ボットの機能は高くなります。詳細については、JavaScript または受信 Webhook 通知サンプルを使用したビルド通知ボットに関するページを参照してください。開始するには、 Teams Toolkit をダウンロードして探索します。詳細については、「 Teams Toolkit ドキュメント」を参照してください。

Webhookの送信

Webhook は、Teams を外部アプリと統合するのに役立ちます。送信 Webhook では、チャネルから Web サービスにテキストメッセージを送信できます。送信 Webhook を構成した後、ユーザーは送信 Webhook を使用して Web サービスにメッセージを送信できます @mention 。サービスは、テキストまたはカードでメッセージに 10 秒以内に応答します。詳細については、「送信 Webhook の作成」を参照してください。

注:

送信 Webhook はチームごとに構成され、通常の Teams アプリの一部として含めることはできません。

コネクタ

コネクタを使用すると、ユーザーは Web サービスから通知とメッセージを受信するようにサブスクライブできます。これにより、サービスの HTTPS エンドポイントが公開されるようになり、通常はカード形式でメッセージを投稿します。

注:

コネクタは、メッセージを更新したり、既存のメッセージへの応答としてメッセージを送信したりすることはできません。

受信 Webhook

受信 Webhook は、アプリから Teams へのメッセージの投稿に役立ちます。任意のチャネルのチームに対して受信 Webhook が有効になっている場合は、正しい形式の JSON を受け入れ、そのチャネルにメッセージを挿入する HTTPS エンドポイントが公開されます。たとえば、DevOps チャネルで受信 Webhook を作成し、ビルドを構成し、サービスを同時にデプロイおよび監視してアラートを送信することができます。詳細については、「受信 Webhook の作成」を参照してください。

通知ボットまたは受信 Webhook

受信 Webhook を構築する方法を学習する前に、Teams Toolkit を使用して通知ボットを構築したり、Microsoft Graph APIを使用してアクティビティフィード通知を送信したりすることもできます。通知ボットとアクティビティフィード通知を使用すると、さまざまなビジネスシナリオを満たすために、よりカスタマイズ可能なエクスペリエンスを実現できます。詳細については、「アプリ通知を送信する計画」を参照してください。

	Notification API	通知ボット	着信 Webhook
暗号化オプションの説明	A RESTful web API	Teams アプリ	Teams 機能
インストールが必要	はい	はい	いいえ
適切なシナリオ	•緊急または重要な情報についてユーザーに通知します。 • Teams の [メイン] ウィンドウで、ユーザーの操作を必要とするリッチコンテンツを表示します。 •サウンドでオペレーティングシステムの通知を受け取ります。 • アクティビティのローカライズされたプレビューテキスト。	•定期的な通知やメッセージを定期的に受信します。たとえば、チームタスクの毎日の通知を受け取ります。 •実際のイベントに基づいて通知やメッセージを受信します。たとえば、チームメイトがファイルをアップロードすると、通知を受け取ります。	外部アプリと通信し、他のアプリから通知やメッセージを受信します。
スコープの構成	• 1 人のユーザー • ユーザーの一覧 • チャットのユーザー • チーム内のユーザー	• Teams チャネル • グループチャット • 個人用チャット	Teams チャネル
メッセージプロセス	Teams アプリは REST API 呼び出しを行って、Teams のアクティビティで通知をトリガーします。 API 呼び出しはディープリンクを渡して、メインウィンドウにコンテンツを読み込みます。	通知ボットは Teams アプリケーションとして機能します。ビジネスロジックを定義して、データを処理し、カスタマイズされた形式でデータを表示できます。	Webhook は Teams アプリケーションではなく Teams 機能であるため、処理せずにデータのみを受信して表示します。
Teams コンテキストを取得する	アプリでは、Graph API を使用して Microsoft 365 データを操作できます。	通知ボットは、チャネルやユーザー情報、メッセージなどの Teams コンテキストを取得できます。	いいえ
アダプティブカードの送信	いいえ	はい	はい
ウェルカムメッセージを送信する	はい	はい	いいえ
サポートされているトリガー	すべてのトリガーがサポートされています。	すべてのトリガーがサポートされています。 Teams Toolkit を使用する場合は、次のトリガーを使用してテンプレートプロジェクトをすばやく取得できます。 • Azure 関数でホストされるタイムトリガー。 • Azure App Service でホストされている HTTP トリガーを Restify します。 • Azure Functionsでホストされる HTTP トリガー。	すべてのトリガーがサポートされています。
ビルドツール	クイックスタート - Microsoft Graph	• Visual Studio Code 用 Teams ツールキットの概要 • Visual Studio 用 Teams ツールキットの概要 • Teams Toolkit CLI • TeamsFx SDK	ツールは必要ありません。
クラウドリソースが必要	Microsoft Entra アプリ	Azure Bot Framework	リソースは必要ありません。
チュートリアル	• Microsoft Teams のユーザーにアクティビティフィード通知を送信する • アクティビティフィード通知を送信する	JavaScript を使用した通知ボットのビルド	受信 Webhook 通知のサンプル

Microsoft 365 グループ用コネクタ

Microsoft 365 グループコネクタを使用すると、受信 Webhook のカスタム構成ページを作成し、Teams アプリの一部としてパッケージ化できます。メッセージは主にMicrosoft 365 グループのコネクタカードを使用して送信し、制限された一連のカードアクションをそれらに追加できます。たとえば、ユーザーが場所と 1 日の任意の時刻を選択して、明日の天気に関する更新プログラムを受信できるようにする天気コネクタです。これらはチャネルレベルで構成されていますが、チームレベルでインストールされます。詳細については、「Microsoft 365 グループ用コネクタの作成」を参照してください。

注:

Microsoft 365 グループ Teams アプリのコネクタを AppStore に配布できます。

メッセージを作成して送信する

アクション可能なメッセージを使用すると、ユーザーは電子メールクライアントから離れることなくアクションを実行できるため、ユーザーエンゲージメントが向上します。 Microsoft 365 と受信 Webhook では、JSON ペイロードを Webhook URL に投稿することでメッセージを送信できます。詳細については、「メッセージの作成と送信」を参照してください。

次の方法で共有