Microsoft Teams Webhook:2026年のメッセージ投稿方法
ホーム
Microsoft Teams Webhook
Microsoft Teams Webhook:Workflowsの設定とカードのペイロード | We.Inc
2026年にWebhookでTeamsチャネルへメッセージを送る方法。Office 365コネクタに代わるWorkflows、廃止の日程、ペイロードビルダーを紹介します。
現在、サイトやアプリからTeamsチャネルに投稿するには、チャネルのWorkflowsメニューを開き、「Send webhook alerts to a channel」(チャネルにWebhookアラートを送信)などのテンプレートを選んで保存し、表示されるリンクをコピーします。そのリンクに、JSONの本文を付けてHTTP POSTを送ります。旧来のOffice 365コネクタのWebhookは廃止されています。
旧コネクタのWebhookと、後継のWorkflows
Office 365コネクタのWebhook WorkflowsのWebhook
状況 廃止:Microsoftによると、2026年5月18日から22日の展開をもって動作しなくなる 現在Microsoftがドキュメントで案内している方法
作成場所 チャネルのコネクタ設定 チャネルのメニューからWorkflows
基盤 Microsoft 365コネクタ Power Automate
カードの形式 メッセージカード アダプティブカードとメッセージカード形式(ボタンは表示されない)
所有者 チャネル ワークフローを作成したユーザー(共同所有者を追加可能)
Webhookとは、ショップ、フォーム、監視ツールなどの別のシステムからメッセージを受け取り、Teamsチャネルに届ける非公開のウェブアドレスです。下のビルダーに入力すると、すぐに使えるJSONの本文とcurlコマンドが得られます。ブラウザー内だけで動作します。
Teamsでチャネルを開き、「その他のオプション」(...)を選んでから Workflows を選びます。 「Send webhook alerts to a channel」テンプレートを検索し、設定を入力して「保存」を選びます。 ワークフローに表示されるWebhookのリンクをコピーします。リンクを知っている人は誰でも投稿できるため、パスワードと同じように扱いましょう。 ビルダーで作った本文を使い、Content-Type: application/json を付けてそのリンクにHTTP POSTを送ります。
メッセージは1件あたり28 KB未満に収めましょう。Microsoftはこのサイズ上限を定めており、超えるとエラーを返します。 リクエストは1秒あたり4件までにしましょう。それを超えるとTeamsに制限されるため、アラートをキューに入れ、待ち時間を延ばしながら再試行します。 ワークフローに共同所有者を追加しましょう。作成者が退職すると、所有者のいないフローは動かなくなることがあります。 カードのテキストにHTMLを入れないでください。Microsoftによると、HTMLは無視されてプレーンテキストとして表示されます。基本的なMarkdownは使えます。
よくある質問
旧来のTeams受信Webhookのリンクはまだ使えますか?
Microsoftの2026年4月14日の更新では、展開は2026年5月18日から5月22日まで行われ、その後はOffice 365コネクタが機能しなくなるとされています。旧コネクタのリンクを指しているものは、すべてWorkflowsのリンクに移しましょう。
WorkflowsのWebhookでアダプティブカードを投稿できますか?
はい。Microsoftは、Workflowsでアダプティブカードと旧来のメッセージカード形式をサポートしていると明記しています。ただし既知の制限が1つあり、メッセージカードのボタンは表示されません。
プライベートチャネルに投稿できますか?
Microsoftのページでは、プライベートチャネルにフローボットとして投稿する機能はまだ開発中とされていますが、ユーザーの代理としての投稿は動作します。頼りにする前に、公式ページの既知の問題を確認してください。
コードを書く必要がありますか?
必ずしも必要ありません。多くのフォームツール、ショップのアプリ、稼働監視ツールにはWebhookの入力欄があるので、そこにWorkflowsのリンクを貼り付けます。コードが必要なのは、メッセージを自分で組み立てる場合だけです。
Webhookのリンクは秘密にすべきですか?
はい。リンクを知っている人は誰でもチャネルに投稿できるため、サーバーの設定や環境変数に保管し、訪問者が読めるサイトのコードには絶対に入れないでください。
2024年から2026年に変わったこと
Microsoftは2024年7月3日に、TeamsのOffice 365コネクタを廃止すると発表し、その後何度か日程を変更しました。2026年4月14日付けの最新の更新で、最終的な展開は2026年5月18日から5月22日とされました。 後継は、Power Automate上で動くTeams内のWorkflowsアプリです。ワークフローは「When a Teams webhook request is received」(Teams Webhook要求を受信したとき)というトリガーで始まり、チャットやチャネルにメッセージを投稿します。
プレーンテキストかアダプティブカードか
最もシンプルな本文は、text という1つのフィールドだけです。アダプティブカードはJSONのレイアウトで、Teamsが見出しや項目を整えたボックスとして描画するため、注文の通知やフォームの送信内容に向いています。コンテンツタイプ application/vnd.microsoft.card.adaptive を指定した attachments の一覧に包んで送ります。
コピーして使える例
どちらの例も、ワークフローで発行されたリンクに送信します。リンクはサーバーの環境変数に保管しましょう。
アダプティブカードの本文
Microsoft自身のサンプルと同じ形です。メッセージに添付ファイルが1つあり、その content がカードです。
Node.jsから送信し、429で再試行する
ステータス429はリクエストが多すぎることを意味します。ループは拒否されるたびに待ち時間を延ばしてから再試行します。
ペイロードビルダー
メッセージの形式
プレーンテキスト
アダプティブカード
カードのタイトル
メッセージ
Webhookのリンク(ブラウザー内にとどまります)
Workflowsのリンクを貼り付けてください
JSONの本文
curlコマンド
本文のサイズ:{n} バイト。Microsoftの上限は28 KBです。
この本文は28 KBを超えているため、Teamsに拒否されます。
コピー
コピーしました
新しい注文
注文1042の支払いが完了しました。金曜日までに発送してください。
無料で始める · クレジットカード不要
関連: ガイド|Webマーケティングと集客を学ぶ
製品
ご利用いただける方
機能
リソース
会社情報
サイトマップを見る