Teams コネクタと Webhook:廃止の状況と Workflows への置き換え方法
By Mirko Peters ·
Teams の Office 365 コネクタとコネクタベースの受信 Webhook は、2026 年 5 月に廃止されました。このガイドでは、動かなくなったもの、その代替手段、移行の方法、そして Workflows にまだ残る違いについて説明します。
Automatically translated with AI from the original post. Read the English original
受信 Webhook コネクタを含め、Teams のコネクタは使えなくなりました。Microsoft Learn によると、Teams の Office 365 コネクタは 2026 年 5 月に廃止され、Webhook 要求を受け取り Teams に投稿する方法は、現在 Workflows アプリです。トリガー Teams の Webhook 要求を受信したとき を使ったワークフローが、従来のコネクタ URL の代わりになります。
重要なポイント
- Microsoft Learn によると、Webhook ベースの受信を含め、Teams の Office 365 コネクタは 2026 年 5 月に廃止されました。開発者ブログに記載された最終的な展開期間は、2026 年 5 月 18 日から 5 月 22 日です。
- 代替手段は、Teams の Workflows アプリ(Power Automate)です。トリガー「Teams の Webhook 要求を受信したとき」を使うか、既成のテンプレートを利用してください。
- ワークフローには独自の Webhook URL があるため、従来のコネクタ URL はもう機能しないので、送信元となるすべてのシステムを新しい URL に切り替える必要があります。
- MessageCard のペイロードは表示されますが、HttpPost ボタンは動作しません。対話型のコンテンツには Adaptive Cards を使用してください。
- ワークフローは、チャネルではなく所有者に紐づきます。所有者が離脱してもワークフローが管理者不在にならないよう、共同所有者を追加してください。
この記事では、何が廃止されたのか、何に置き換わるのか、移行の方法、そして今後も影響しうる違いについて説明します。
廃止の内容と時期
廃止は約 2 年にわたって進められ、その期日は何度も変更されました。Microsoft 365 開発者ブログには、その経緯が次のように記録されています。
- 2024 年 7 月:最初の計画では、2024 年 8 月 15 日から新しいコネクタをブロックし、2024 年 10 月 1 日にすべてのコネクタを停止する予定でした。
- 2024 年 7 月:廃止の時期が 2025 年 12 月まで延期されました。
- 2025 年 10 月:移行の期限が 2026 年 3 月 31 日に変更されました。
- 2026 年 2 月:Workflows に Message Card のサポートが追加され、Workflows のボットが共有チャネルに投稿できるようになりました。期限は 2026 年 4 月 30 日に変更されました。
- 2026 年 4 月 14 日(最終更新):展開は 2026 年 5 月 18 日に開始され、5 月 22 日に完了します。その後、コネクタは機能しなくなります。
対象となるのは、Teams の Office 365 コネクタです。これには、受信 Webhook などの Webhook ベースのコネクタや、URL に投稿するサードパーティ製コネクタが含まれます。ブログでは、この Webhook URL の変更は Webhook ベースのコネクタに適用され、RSS などのポーリング型コネクタには適用されないと記されています。
古いコネクタを経由して今も投稿されているものがあれば、すでに動作しないか、まもなく動作しなくなるものとして扱い、今のうちに移行を計画してください。
コネクタの代替手段
Microsoft は Learn で 3 つの方法を挙げています。
- Workflows アプリ(Power Automate)は、受信 Webhook に使用します。事前定義のテンプレートか、トリガー Teams の Webhook 要求を受信したとき を使用してください。
- ISVや製品チーム向けのPower Automateコネクタです。Learnでは、Teamsとの間でプログラムからデータを安全かつ拡張性高くやり取りする方法として紹介されています。
- プロアクティブ メッセージを送信できるTeamsアプリです。自社システムのトリガー イベントに基づいて、ユーザーがメッセージを設定できます。
ほとんどの管理者やスクリプト担当者にとって、パス1が直接の置き換えになります。
WebhookをWorkflowsに移行する方法
この記事の執筆時点では、受信Webhookに関するMicrosoftサポートページを読み込めませんでした。そのため、以下の手順は開発者ブログとLearnのコネクタリファレンスに基づいています。
- 使用中のコネクタをすべて一覧にしてください。チャネルの管理 > コネクタを使用しているチャネルと、監視、ビルド、チケット管理などのツールからアラートを送信しているシステムを確認します。
- TeamsでWorkflowsアプリを開きます。開発者ブログによると、チャットやチャネルからその他のオプション (...)を選択して開くこともできます。
- 事前定義されたWebhookテンプレートを選ぶか、トリガーTeams Webhook要求を受信したときを使って一から作成します。
- チームとチャネルを選択して保存し、Power AutomateでワークフローのトリガーURLをコピーします。
- 送信元システムで、古いコネクタのURLを新しいURLに置き換えます。
- ワークフローの名前と説明を設定してテストし、共同所有者を追加します。
- テストのPOSTを送信し、メッセージが表示されることを確認します。
このトリガーはPOSTリクエストのみを受け付けます。LearnのコネクタリファレンスではGETリクエストはサポートされていないと記載されています。
ペイロード形式とカード
トリガーの本文には、アダプティブ カードの配列を含めることができます。リファレンスでは、attachments配列を持つメッセージが示されており、そのcontentTypeはapplication/vnd.microsoft.card.adaptiveです。単一のMessage Card本文も受け付けられます。
次の点に注意してください。
- インタラクティブなコンテンツを構築する場合、サポートされている方法はアダプティブ カードです。
- MessageCardのペイロードは表示されますが、HttpPostを使用するボタンは動作しません。開発者ブログでは、インタラクティブなカード要素を使用する場合はアダプティブ カードに切り替えるよう案内しています。
アクセス制御
実際の改善点の一つは、トリガーに認証設定があることです。Learnでは3つの選択肢が挙げられています。
| 設定 | 送信側で必要な操作 | |---|---| | 全員 | 認証トークンのヘッダーを送信しない。送信しないとリクエストは失敗します | | 自分のテナント内の任意のユーザー | 認証トークンを送信する | | 自分のテナント内の特定のユーザー | 認証トークンを送信する。ユーザーは許可リストに登録されている必要があります |
テナント向けのオプションについては、LearnのHTTP要求トリガー向けOAuth認証に関するガイドを参照してください。ツールがURLへの単純なPOSTしか送信できない場合は、「全員」の設定が必要になります。その場合、URLはシークレットとして扱ってください。
従来のコネクタとの違い
切り替え前に、以下の点を検討してください。
- 送信者のID。2026年4月の開発者ブログの更新によると、Webhookの投稿では、ボットのアイコンと名前をカスタマイズできません。メッセージには、既定のWorkflowsボットのIDが表示されます。
- 所有者。Learnによると、ワークフローはチームやチャネルではなく所有者に紐づいています。所有者が退職し、共同所有者がいない場合、フローが孤立する可能性があります。完全な制御権を持つ共同所有者を追加してください。
- 制限。Learnのリファレンスでは、トリガーの同時受信呼び出しは約1,000件、チャットまたはチャネルにアダプティブ カードを投稿アクションは28 KBまでと記載されています。これを超えるペイロードは「Request Entity too large」エラーを返します。
- プライベートチャネル。情報源の内容が一致していません。開発者ブログでは、WorkflowsアプリでのプライベートチャネルのLearn選択機能が2026年4月20日までに全面展開される予定だったとされています。あるLearnのページではWorkflows Webhookがプライベートチャネルをサポートするとされ、別のLearnのページではプライベートチャネルのサポートは開発中とされています。また、Microsoft Teamsコネクタのリファレンスでは、現在プライベートチャネルへのメッセージやカードの投稿はサポートされていないと記載されています。依存する前に、対象チャネルでテストしてください。
よくある間違い
- チャネルだけを移行し、送信元システムのURLを変更し忘れること。
- ワークフローの所有者を一人だけにしておくこと。
- 「全員」に設定したトリガーにトークンを送信すること。
- MessageCardのボタンを残したまま、コールバックが動作すると想定すること。
- 古いボット名とアイコンが引き継がれると想定すること。
関連情報
データソース
- Microsoft Teams内のOffice 365コネクタの廃止(Microsoft 365開発者ブログ)
- Teams 用 Office 365 コネクタの作成 (Microsoft Learn)
- Teams における Microsoft 365 コネクタとカスタム コネクタの廃止 (Microsoft Learn)
- Power Automate 用 Microsoft Teams コネクタ リファレンス (Microsoft Learn)
FAQ
Teams のコネクタはまだ使えますか?
いいえ、使えません。Microsoft Learn によると、コネクタベースの受信 Webhook を含め、Teams の Office 365 コネクタは 2026 年 5 月に廃止されました。Microsoft 365 開発者ブログでは、最終的な展開期間は 2026 年 5 月 18 日から 5 月 22 日とされており、その開始前に Webhook を移行しておく必要があるとしています。
Teams の受信 Webhook コネクタの代わりは何ですか?
Power Automate 上で動作する Workflows アプリです。Microsoft Learn によると、Webhook 要求を受信したときにチャットやチャネルに投稿する事前定義のテンプレートを使うか、トリガー「Teams の Webhook 要求を受信したとき」を使ってフローをゼロから作成します。
監視ツールやスクリプトには新しい URL が必要ですか?
はい、必要です。ワークフローには独自のトリガー URL があり、コネクタのリファレンスでは、このトリガーは当該エンドポイントへの POST 要求によって開始されると説明されています。私が参照したページには URL の表示場所は書かれていないため、Power Automate でワークフローのトリガーを開いて URL をコピーしてください。そのうえで、POST 要求を送信するシステムに貼り付けます。
Workflows の Webhook から、自分のシステムに戻るボタンを投稿できますか?
MessageCard では無理です。開発者ブログによると、MessageCard はコンテンツを表示できますが、HttpPost のアクションボタンはサポートしていません。対話型の要素には、Microsoft は Adaptive Cards を勧めています。また Learn では、応答を処理するようにワークフローを構成する必要があるとされています。
誰がワークフローの Webhook に要求を送信できますか?
選択できます。Learn の Microsoft Teams コネクタのリファレンスには、3 つの選択肢が記載されています。誰でも、テナント内の任意のユーザー、またはテナント内の特定のユーザーです。テナント内の選択肢を使う場合、要求には認証トークンを含める必要があります。「誰でも」を選択した場合は、トークンを送信してはいけません。