ドキュメント
Microsoft Teams のアラートとレポート
Teams のチャンネルで Workflows の webhook を作成して AutoPSEO に追加すると、アラートや定期レポートが重大度ごとに色分けされた Adaptive Card で届きます。
AutoPSEO は Workflows の webhook を使って Microsoft Teams に投稿します。Teams で 1 つのチャンネルに投稿するための URL を発行し、その URL を Teams チャンネルとして AutoPSEO に追加します。すると、アラート、定期レポート、テストメッセージ、単発のレポートサマリーが Adaptive Card として届きます。タイトルは重大度に応じて色分けされ、レポートに戻るためのボタンも付きます。Slack ワークスペースは不要で、Teams に AutoPSEO のアプリをインストールする必要もありません。
Teams で webhook URL を取得する
Microsoft の受信 webhook のガイドでは、Workflows アプリを使って URL を作成します。
- Teams で、カードを受け取りたいチャンネルを開き、その横にある More options (...) を選びます。
- Workflows を選び、webhook のテンプレートを選択します。Microsoft では現在このテンプレートを Send webhook alerts to a channel と呼んでいます。AutoPSEO の設定ページにあるヒントは旧名称の Post to a channel when a webhook request is received のままです。
- テンプレートが自動入力したチーム名とチャンネル名を確認し、Save をクリックします。
- ワークフローに表示される webhook リンクをコピーします。
従来の Incoming Webhook コネクタの URL(webhook.office.com のもの)も引き続き使えます。ただし、Microsoft は Microsoft 365 コネクタを廃止する予定で、新規作成もブロックされるため、これから設定する場合は Workflows を使ってください。
AutoPSEO にチャンネルを追加する
- Slack, Teams & Webhooks の Microsoft Teams セクションで、New Teams channel をクリックします。フォームは送信先が Microsoft Teams になった状態で開きます。
- 分かりやすい Name を入力し、URL を貼り付けます。Teams の場合、AutoPSEO は Workflows とコネクタのアドレス(
logic.azure.com、powerautomate.com、azure-api.net、webhook.office.comなどのホスト)を受け付け、それ以外のホストは拒否します。 - Add channel をクリックし、続けてその行の Send test をクリックします。エントリ名をタイトルにしたカードがチャンネルに表示されるはずです。
- 定期レポートまたはアラートを作成し、このチャンネルを選択します。
1 つのルールが送信できるチャンネルは 1 つです。同じアラートを Slack と Teams の両方に届けたい場合は、それぞれに対してルールを 2 つ作成してください。
カードのレイアウト
各メッセージは Adaptive Card(バージョン 1.4、全幅)1 枚になります。カードは message エンベロープに包まれ、Microsoft 自身のサンプルと同じ application/vnd.microsoft.card.adaptive の添付として送られます。
- タイトルは大きな太字で表示されます。アラートでは、critical と high がカードの Attention 色、medium が Warning 色、low が既定の色になります。レポートとテストには Accent 色が使われます。
- サマリーは、Slack のメッセージと同じ一文に、対象期間を添えたものです。
- ファクトは、最大 12 個のラベル付きの値です。たとえばクリック数とその変化、アラートの現在値とベースラインの比較などが表示されます。
- テーブルは、レポートとレポートサマリーで使われ、等幅フォントで最大 10 行まで表示されます。
- フッターには、プロパティ、Search Console のデータが約 1 日遅れること、確定した日のみが集計対象であることの注記、そして送信元が表示されます。
- Open report は、AutoPSEO 内の該当レポートへ移動するボタンです。
カードが届かないとき
Send test では失敗がすぐに表示されます。定期メッセージの場合は、Delivery history に Teams から返された応答が記録されます。
| 表示される内容 | 考えられる原因 | 対処 |
|---|---|---|
| 保存時に「That does not look like a Teams Workflows or Incoming Webhook URL」と表示される | URL が Workflows またはコネクタのホストのものではない | ワークフローからリンクを再度コピーする |
| Send test で HTTP 400 になる | Teams の webhook ではない。Slack の URL、Zapier のフック、または別の形式の本文を想定するよう編集したワークフローなど | テンプレートから新しいワークフローを作成し、その URL を追加する |
| 10 秒でタイムアウトする | Teams が時間内に応答しなかった | しばらくしてからもう一度試す |
| リダイレクトが追跡されない | URL が別の場所に転送されている | 転送先の最終的な URL を追加する |
| 同僚の退職後にカードが届かなくなった | Microsoft はワークフローを所有者に紐付けており、所有者のいないワークフローは停止することがある | ワークフローに共同所有者を追加するか、作り直す |
送信に失敗した定期レポートは、同じ期間内には再送されません。原因を解消してから Send now を使ってください。
webhook を使うべき場面
Teams と送信 webhook は同じルールを扱えますが、想定している受け手が異なります。Teams チャンネルは人向けで、整形済みのカードが届き、構築作業は不要です。webhook はソフトウェア向けで、Zapier、Make、n8n、または自社のサービスに、署名付き JSON として生のイベントを渡します。Teams が受け取るのは AutoPSEO のイベント JSON ではなくカードなので、Teams の URL は必ず Microsoft Teams に追加してください。
Teams ユーザー向けの機能の概要は、Microsoft Teams のページをご覧ください。