Webhook とコネクタを作成する

[アーティクル]
09/24/2024

重要

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

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

Webhook 要求の受信時にチャットまたはチャネルに自動的に投稿するには、定義済みのワークフローテンプレートを使用するか、[ Teams Webhook 要求が受信されたとき ] トリガーを使用してワークフローを最初から作成します。詳細については、「 Microsoft Teams で Webhook 要求が受信されたときにワークフローを投稿する」を参照してください。
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 のチャネルとチームに 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 を @mention し、Web サービスにメッセージを送信できます。サービスは、テキストまたはカードでメッセージに 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 でホストされている Express HTTP トリガー。 • 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 に投稿することでメッセージを送信できます。詳細については、「メッセージの作成と送信」を参照してください。

次の方法で共有