Slackとの接続: 手順ガイド
実行結果の概要をチャンネルに投稿します。NEXUS_SLACK_NOTIFY=trueの場合は、失敗したテスト、不安定なテスト、カオステスト、視覚的な回帰テストごとに1件のメッセージも投稿します。失敗についてのメッセージには、対応するJiraチケットがあればそのリンクが含まれます。このガイドでは、準備から接続の確認までの手順を説明し、発生しうるエラーとその原因、解決方法を紹介します。
最終更新日:
認証情報は非公開にしてください。 トークン、キー、パスワード、Webhook URL をチャットに貼り付けないでください。入力先は Studio → 設定 → 連携のみにしてください。認証情報はワークスペースの .env ファイルに保存され、画面上では点で表示されます。AI アシスタントにも同じことが当てはまります。このガイドに沿って手順を案内することはできますが、トークンを伝える必要はありません。
必要なもの
- アプリを追加できるSlackワークスペース。
- メッセージの送信先チャンネル用のIncoming Webhook URLを1つ。
認証情報を取得する
- Slack で Incoming Webhook (https://api.slack.com/messaging/webhooks) を使用するアプリを作成し、チャンネルを選択します。
- Webhook URL をコピーします。https://hooks.slack.com/services/ で始まる URL です。この URL 自体が秘密情報です。
- クリップボードに保持してください。Studio (次の手順) 以外には貼り付けないでください。
Studio で接続する
- Studio で 設定 → 連携 → Slack を開きます。
- Webhook URL を貼り付け、保存 & テスト送信を押します。チャンネルにテストメッセージが送信されます。
SLACK_ENABLEDを有効にします。失敗したテストごとにメッセージを送るには、NEXUS_SLACK_NOTIFYも有効にします。
動作を確認する
- テストメッセージを送信すると "送信しました。" と表示され、チャンネルにメッセージが届きます。
- 任意のテストを実行します。チャンネルに実行結果の概要が届きます。
よくあるエラー
| 確認できる結果 | 原因 | 解決方法 |
|---|---|---|
| "Webhook がありません" | SLACK_WEBHOOK_URL が空です。 | 設定 → 連携に Webhook URL を貼り付けて保存します。 |
"SLACK_WEBHOOK_URL は Slack の Incoming Webhook ではありません" | 値が https://hooks.slack.com/services/ で始まっていません。 | Slack アプリの Incoming Webhooks ページから Webhook URL をもう一度コピーします。 |
| HTTP 404 "no_service" または HTTP 403 "invalid_token" | Webhook が無効化または削除されたか、アプリがワークスペースから削除されました。 | 新しい Incoming Webhook を作成し、新しい URL を保存します。 |
| HTTP 404 "channel_not_found" または HTTP 410 "channel_is_archived" | Webhook の投稿先チャンネルが削除またはアーカイブされました。 | 使用中のチャンネル用に新しい Webhook を作成します。 |
| "Slack に接続できませんでした (ENOTFOUND)" または "20 秒以内に応答がありませんでした" | この PC から Slack に接続できません: VPN やプロキシの影響、またはネットワーク未接続が考えられます。 | 同じ PC でネットワーク接続を確認して再試行します。 |
| テスト送信は成功するが、失敗の通知が投稿されない | SLACK_ENABLED が false、または実行結果の概要のみが有効になっています: テストごとのメッセージには NEXUS_SLACK_NOTIFY=true が必要です。 | 両方のスイッチを有効にします。 |
設定キー
| キー | 主な機能 | 有効な値 | 確認方法 |
|---|---|---|---|
SLACK_ENABLED | Slack にアラートを送信 | true または false | テストメッセージが届いてから有効にします。 |
SLACK_WEBHOOK_URL | アラート用の Slack チャンネル (秘密情報、このコンピューターにのみ保存) | https://hooks.slack.com/services/… (これ以外は使用できません) | テストメッセージを送信すると、チャンネルに投稿されます。 |
NEXUS_SLACK_NOTIFY | 失敗ごとに Slack にアラートを送信 | true または false | 実行結果の概要だけでなく、失敗したテストごとにメッセージが届きます。 |
詳細: すべての連携, 設定ガイド, 問題の解決方法. その他のガイド: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
まだ解決しませんか? Studioに表示されるエラー行をそのまま添えて、[email protected]までご連絡ください。トークンは記載しないでください。