Webhook とコネクタを作成する

  • [アーティクル]

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 はチームごとに構成され、通常の Teams アプリの一部として含めることはできません。

コネクタ

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

受信 Webhook

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

通知ボットまたは受信 Webhook

受信 Webhook を構築する方法を学習する前に、Teams Toolkit を使用して通知ボットを構築できることを知ることもできます。 通知ボットを使用すると、さまざまなビジネス シナリオを満たすために、よりカスタマイズ可能なエクスペリエンスを実現できます。

通知ボットと受信 Webhook の違いについて詳しくは、シナリオに適したソリューションを選択してください。

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

Microsoft 365 グループ用コネクタ

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

注:

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

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

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

次の手順

送信 Webhook を作成する

関連項目