受信 Webhook を作成する

受信 Webhook を使用すると、外部アプリケーションからのコンテンツを Teams チャネル内で共有できるようになります。 Webhook は、追跡と通知を行うツールとして使用されます。 Webhook により、カード形式のメッセージを含む JSON ペイロードを送信するための一意の URL が提供されます。 カードは、1 つの記事に関連するコンテンツとアクションを含むユーザー インターフェイス コンテナーです。 カードは、次の機能で使用できます。

• ボット
• メッセージ拡張機能
• コネクタ

重要

受信 Webhook 以外の通知ボット Teams アプリを構築することもできます。 同様に実行されますが、通知ボットの機能は高くなります。 詳細については、「JavaScript または受信 Webhook通知サンプルを使用して通知ボットを構築する」を参照してください。 開始するには、 Teams Toolkit をダウンロードして探索します。 詳細については、「 Teams Toolkit ドキュメント」を参照してください。

注:

• メッセージ サイズの制限は 28 KB です。 サイズが 28 KB を超えると、エラーが発生します。 詳細については、「 Microsoft Teams の制限と仕様」を参照してください。
• 1 秒間に 4 つ以上の要求が行われた場合、クライアント接続は、ウィンドウが固定レートの間更新されるまで調整されます。 指数バックオフを使用した再試行ロジックは、要求が 1 秒以内に制限を超える場合のレート制限を軽減できます。 レート制限に達しないようにするには、「 HTTP 429 応答」を参照してください。

受信 Webhook を作成する方法については、次のビデオを参照してください。

受信 Webhook の主な機能

次の表に、受信 Webhook の機能と説明を示します。

機能	説明
受信 Webhook を使用したアダプティブ カード	アダプティブ カードは、受信 Webhook を介して送信できます。 詳細については、「受信 Webhookを使用してアダプティブ カードを送信する」を参照してください。
アクション可能なメッセージングのサポート	アクション可能なメッセージ カードは、Teams を含むすべての Microsoft 365 グループでサポートされています。 カード経由でメッセージを送信する場合は、アクション可能なメッセージ カード形式を使用する必要があります。 詳細については、「 従来のアクション可能なメッセージ カードリファレンス 」と「 メッセージ カードの遊び場」を参照してください。
独立した HTTPS メッセージングのサポート	カードは、情報を明確かつ一貫して提供します。 HTTPS POST 要求を送信できるツールまたはフレームワークは、受信 Webhook を介して Teams にメッセージを送信できます。
Markdown のサポート	アクション可能なメッセージング カードのすべてのテキスト フィールドで、基本的な Markdown がサポートされています。 カードには HTML マークアップを使用しないでください。 HTML は無視され、プレーン テキストとして扱われます。
スコープ構成	受信 Webhook のスコープが設定され、チャネル レベルで構成されます。
セキュリティで保護されたリソース定義	メッセージは JSON ペイロードとして書式設定されます。 この宣言型メッセージング構造は、悪意のあるコードの挿入を防ぎます。

注:

• Teams ボット、メッセージング拡張機能、受信 Webhook、およびBot Frameworkは、アダプティブ カードをサポートします。 Adaptive Card は、Windows、Android、iOS などのすべてのプラットフォームで使用されるオープン なクロスカード プラットフォーム フレームワークです。 現時点では、 Teams コネクタ はアダプティブ カードをサポートしていません。 ただし、Teams チャネルにアダプティブ カードを投稿する フロー を作成することはできます。
• カードと Webhook の詳細については、「アダプティブ カード と受信 Webhooks」を参照してください。

受信 Webhook を作成する

Teams チャネルに受信 Webhook を追加するには、次の手順に従います。

1. Webhook を追加するチャネルを開き、右上隅から [•••] を選択します。

2. ドロップダウン メニューから コネクタ を選択します。

   

3. 受信 Webhookを検索し、[追加]選択します。

4. [ 構成] を選択し、名前を指定し、必要に応じて Webhook のイメージをアップロードします。

   

5. ダイアログに存在する一意の Webhook URL をコピーして保存します。 URL はチャネルにマッピングされ、それを使用して Teams に情報を送信することができます。

6. [完了] を選択します。

   

Webhook は Teams チャネルで使用できるようになりました。

Microsoft 365 グループの受信 Webhook またはコネクタを使用して、アクション可能なメッセージを作成して送信できます。 詳細については、「メッセージの作成と送信」を参照してください。

注:

Teams で、[設定]>[メンバーのアクセス許可>メンバーがコネクタを作成、更新、削除できるようにする]を選択して、チーム メンバーがコネクタを追加、変更、または削除できるようにします。

例

C#

サンプル コード リファレンス

url = {{Webhook_URL}};
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var content = new StringContent({{formatted_Card_Payload}}(Adaptive_Card_Json), System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync({{WebhookUrl}}, content);

JavaScript

サンプル コード リファレンス

 axios.post({{WebhookUrl}}, {{formatted_Card_Payload}})
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

受信 Webhook を削除する

Teams チャネルから受信 Webhook を削除するには、次の手順に従います。

1. チャネルを開き、右上隅から [•••] を選択します。

2. ドロップダウン メニューから コネクタ を選択します。

3. [管理] で [構成済み] を選択します。

4. [ 1 構成済み] を選択して、現在のコネクタの一覧を表示します。

   

5. 削除するコネクタの [管理 ] を選択します。

   

6. 削除を選択します。

   

   [ 構成の削除] ウィンドウが表示されます。

7. 必要なチェック ボックスをオンにします。

8. 削除を選択します。

   

コード サンプル

サンプルの名前	説明	.NET	Node.js	マニフェスト
タスク モジュールのサンプル ボット - V4	このサンプルでは、ボット フレームワーク v4 タブと Teams タブを使用してタスク モジュールを作成する方法を示します。	表示	表示	表示

関連項目

• Webhook とコネクタ
• 送信 Webhook を作成する
• Microsoft 365 グループのコネクタを作成する
• メッセージを作成して送信する
• Teams 用のボットを構築する
• メッセージの拡張機能
• カード アクション
• Web アプリを統合する
• Web アプリから Teams に共有する
• Azure Logic Apps でアクセスとデータをセキュリティ保護する