Webhook とコネクタを作成する
重要
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サポートされていません。 ワークフロー内のメッセージカード形式の使用のサポートは、10 月中旬から利用可能になります。 詳細については、コネクタ メッセージカード形式をアダプティブ カードに変換する方法に関するページを参照してください。
- ワークフローには、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 でホストされている 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 に投稿することでメッセージを送信できます。 詳細については、「メッセージの 作成と送信」を参照してください。
関連項目
Platform Docs