ドキュメント
Slack、Teams、Webhook連携
Search Consoleの定期レポートやアラートを、Slack、Microsoft Teams、または任意のHTTPSエンドポイントに送信できます。設定はすべて1つのページで管理でき、配信ログも確認できます。
AutoPSEOでは、数値をアプリの外へ届ける方法が2つあります。1つは、プロパティの主要な Search Console の指標をまとめた定期レポート。もう1つは、クリック数、CTR、掲載順位、インデックス登録、トラッキング中の順位、監査に変化があったことを検出器が捉えたときに通知するアラートです。どちらも、あらかじめ1回だけ追加しておくチャンネル(Slackの受信Webhook、Microsoft TeamsのWorkflows URL、署名付きJSONを受け付ける公開HTTPSエンドポイントのいずれか)に送信されます。管理はすべて1つのページで行えます。
設定ページの場所
左サイドバーの Slack, Teams & Webhooks を開くか、Account に移動して、Slack, Teams & webhooks カードの Manage を選択します(アプリで開く)。ページには、送信先ごとのセクション(Slack - Connected workspaces、Microsoft Teams、Outbound webhooks)があり、その下に Scheduled reports、Alerts、Delivery history が続きます。
チャンネル、ルール、配信
この機能は3つの要素で構成されています。
- チャンネル: 送信先URLを1つ登録したもので、Slack、Microsoft Teams、Webhookのいずれかのラベルが付きます。AutoPSEOはURLを暗号化して保存し、保存後はホスト名と末尾の数文字だけを表示します。1アカウントに登録できるチャンネルは25件までです。
- ルール: 定期レポートまたはアラートを、ちょうど1つのチャンネルに紐付けたものです。1つのチャンネルを複数のルールで使えますが、ルールの上限は1アカウントあたり50件です。同じアラートをSlackとTeamsの両方に届けたい場合は、ルールを2つ作成してください。
- 配信: メッセージを投稿する1回の試行です。Delivery history には、テストや単発のサマリーも含め、全チャンネルの直近50件の試行が記録されます。各試行について、ステータス(sent、failed、skipped)、HTTPステータス、送信先が応答するまでの時間、失敗した場合はその理由を確認できます。
チャンネルとルールは、ご自身のログインに紐付きます。チームメンバーが自分のチャンネルでアラートを受け取りたい場合は、そのメンバーが自分で設定する必要があります。
最初のメッセージが届くまで
- レポート対象にしたい Search Console プロパティを接続します(Search Consoleの接続)。デモ用プロパティはどの選択肢にも表示されるため、ご自身のデータが入る前でもルールを試せます。
- Add to Slack、New Teams channel、New webhook のいずれかでチャンネルを追加します。名前を付けて、URLを貼り付けてください。各URLの取得方法は次のとおりです: Slack、Microsoft Teams、Webhook。
- チャンネルの行にある Send test をクリックし、メッセージが届いたことを確認します。
- New scheduled report または New alert でルールを作成します。どちらのボタンも、チャンネルが1つ以上できるまでグレーアウトされたままです。
メッセージが送信されるタイミング
ジョブは毎時0分(UTC)に実行され、送信対象を判定します。
| メッセージ | 送信タイミング |
|---|---|
| 定期レポート | 指定した時刻に、毎日・毎週・毎月のいずれかで送信。1期間につき最大1回 |
| クリック数、CTR、掲載順位、失われたクエリ、順位トラッキング、監査に関するアラート | 1日1回、06:00 UTCの実行時にチェック |
| インデックス状態の反転に関するアラート | 毎時チェック |
| Send test、Send now、Test rule | 即時 |
| レポートページの Send to Slack | 即時(SlackでAutoPSEOを使う) |
Search Consoleのデータは公開までに遅延があるため、レポートとアラートの集計期間は、実行日の前日までです。すべてのメッセージに使用した日付が明記されているので、対象期間に迷うことはありません。
必要なもの
- 有効なプラン、または進行中のトライアル。プランに加入しないままトライアルが終了すると、定期レポートとアラートは停止し、新規チャンネルの追加、ルールの変更、テスト、送信は、プランを選択するまで受け付けられません(プランと請求)。
- ご自身で管理できる送信先。具体的には、Slackで受信Webhookを作成する権限、Teamsチャンネルで Workflows のWebhookを作成する権限、またはご自身のHTTPSエンドポイントのいずれかが必要です。
チャンネルの閲覧権限にご注意ください
すべてのメッセージには、クリック数、表示回数、クエリ、ページのアドレスといった検索パフォーマンスのデータが含まれます。SlackやTeamsのチャンネル、またはWebhookの受信先システムを閲覧できる人には、これらのデータがすべて見えます。クライアントのプロパティは非公開チャンネルに投稿してください。送信先URLもシークレットです。Slackもそのwebhookについて注意を促しているとおり、URLを知っている人は誰でもチャンネルに投稿できます。このため、AutoPSEOでは保存後にURLを再表示することはありません。
次に読む
- 受信Webhookを使ったSlack連携: SlackでのURLの作成方法、追加手順、Slackが返す可能性のあるエラー。
- 定期レポート: レポートの種類、期間、送信頻度、1期間1回のルール。
- アラート: 9種類の検出器、しきい値、重要度、ミュート。
- SlackでAutoPSEOを使う: メッセージの内容と、Send to Slack の仕組み。
- Microsoft Teams: Workflows URLとAdaptive Card。
- アウトバウンドWebhook: JSONの本文、イベントタイプ、署名の検証。
このセクション内
incoming webhook で Slack を連携する
チャンネル用の Slack incoming webhook を作成して AutoPSEO に追加し、テストメッセージを送信する手順と、投稿に失敗したときに Slack が返すエラーの対処法を説明します。
Slack、Teams、Webhook へのレポート定期配信
プロパティのクリック数、表示回数、CTR、掲載順位と、上位のクエリ、ページ、順位変動を、毎日・毎週・毎月チャンネルに投稿します。
アラート:検出器、しきい値、重大度
9つの検出器がクリック数、CTR、掲載順位、失われたクエリ、インデックス状態の変化、ランキング、監査を監視し、しきい値を超えたときだけチャンネルに通知します。
Slack で AutoPSEO を使う
AutoPSEO の Slack メッセージの内容、Send to Slack で任意のレポートテーブルをチャンネルに投稿する方法、そして Slack 上でできること・できないことを説明します。
Microsoft Teams のアラートとレポート
Teams のチャンネルで Workflows の webhook を作成して AutoPSEO に追加すると、アラートや定期レポートが重大度ごとに色分けされた Adaptive Card で届きます。
アウトバウンド Webhook:ペイロードと署名
AutoPSEO のアラートとレポートを、署名付き JSON として任意の HTTPS エンドポイントで受信できます。リクエストヘッダー、本文のフィールド、イベントタイプ、署名の検証方法を説明します。