Contents
1. Backlog × Slack 連携を始める前の準備
Backlog の課題情報を Slack にリアルタイムで流すと、チーム全体の認識合わせが格段に楽になります。本セクションでは 「なぜ」 この連携が必要か、そして 「誰が」 事前に用意すべき権限や情報かを整理します。
- 目的：課題の作成・更新・コメントなど重要イベントを即座に共有し、意思決定や障害対応のスピード向上を狙う。
- 結論：管理者権限と Slack のアプリ作成権限があれば、数分で連携設定は完了します。
1‑1. 必要な Backlog 権限
| ロール | 必要な操作 |
|---|---|
| プロジェクトオーナー / 管理者 | 「プロジェクト設定」→「インテグレーション」から Slack を追加・編集できる。 |
| 一般ユーザー | 連携自体は操作できませんが、通知を受け取る側としてチャンネル参加が必要です。 |
ポイント：バックログの管理権限が無い場合は、プロジェクトオーナーに設定依頼を出してください。
1‑2. Slack 側で準備すべきこと
Slack アプリの作成とスコープ（権限）の付与が必要です。最小権限の原則 に従い、以下のスコープだけを選択します。
| スコープ | 用途 |
|---|---|
chat:write |
メッセージ送信（必須） |
channels:read |
パブリックチャンネル一覧取得 |
groups:read |
プライベートチャンネル（グループ）の情報取得 |
incoming-webhook |
Slack の受信用 Webhook エンドポイントを生成（※自動付与ではなく、手動で追加する必要があります） |
注意：
incoming-webhookは他のスコープと同様に手動で選択しなければならず、Slack が自動的に付与することはありません。
2. Slack 連携設定手順（2026 年 UI）
この章では Backlog の画面遷移から実際の連携作成までを ステップごとに 説明します。各ステップは画面上のボタン名や配置が変わりにくいよう、最新 UI に合わせて記載しています。
2‑1. インテグレーション画面へのアクセス
Backlog のプロジェクト設定メニューから「インテグレーション」へ辿る手順です。
- 左サイドメニューの 「プロジェクト設定」 をクリック。
- メニュー一覧から 「インテグレーション」 を選択すると、利用可能な外部サービスの一覧が表示されます。
2‑2. 新規 Slack 連携を追加する
「Slack」を選んで連携設定画面を開くまでの流れです。
- インテグレーション一覧から 「Slack」 をクリック。
- ページ右上にある 「Slack インテグレーションを追加」 ボタンを押すと、設定ウィザードが開始します。
2‑3. 必須入力項目と推奨設定
各項目の意味と実務での活用例をまとめました。
| 項目 | 説明 | 推奨設定例 |
|---|---|---|
| 言語 | 通知メッセージの表示言語（日本語・英語） | 多国籍チームの場合は English、国内だけなら Japanese。 |
| 説明 | 連携の目的や備考を記入できるフリーテキスト | 「バグ報告専用」や「デプロイ完了通知」など、後から分かりやすいラベルを書く。 |
| 通知チャンネル | メッセージ送信先 Slack チャンネル（例：#dev-notify） |
課題種別ごとに専用チャンネルを割り当てると管理しやすい。 |
| トリガー | どのイベントで通知するかを選択 | 「課題がクローズされたとき」だけ通知したい場合は「ステータス変更」のみチェック。 |
言語設定のポイント
- 日本語に統一すると社内の可読性が高まります。
- 英語チームがいる場合は
Englishを選び、テンプレート本文も英語で作成しておくと翻訳コストが削減できます。
説明フィールド活用例
|
1 2 |
説明: バグ報告専用（#bug-report）←この連携はバグだけ通知 |
簡潔に目的を書いておくと、後から設定を見直す際の手間が大幅に減ります。
3. OAuth 認証と Webhook URL の取得方法
Backlog が Slack にメッセージを送るためには 2 つ の情報が必要です。（1）Slack アプリで発行した OAuth トークン、（2）Backlog が生成する Incoming Webhook URL。以下の手順で正しく取得しましょう。
3‑1. Slack アプリの作成とスコープ付与
Slack 管理コンソール上でアプリを新規作成し、必要な権限を設定します。
- Slack の管理コンソール → 「アプリ」→「Create New App」
- アプリ名と対象ワークスペースを入力し、「OAuth & Permissions」 へ遷移。
- 前節で示したスコープ（
chat:write,channels:read,groups:read,incoming-webhook）を Add an OAuth Scope ボタンで追加。
重要：
incoming-webhookは必ず手動で追加してください。自動付与は行われません。
3‑2. アプリのインストールとトークン取得
- 「OAuth & Permissions」ページ下部にある 「Install App to Workspace」 をクリック。
- インストールが完了すると、Bot User OAuth Token（形式は
xoxb-…）が表示されますのでコピーして安全な場所に保管します。
3‑3. Backlog 側で Webhook URL を取得
Backlog の設定画面から生成された URL を取得し、Slack アプリと紐付けます。
- 前節の 「Slack インテグレーションを追加」 手順まで戻り、設定画面下部にある 「Webhook URL」 フィールドを確認。
- 生成される URL は次のような形式です（実際の文字列は各プロジェクト・ワークスペース固有）
|
1 2 |
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX |
- この URL を コピーし、Slack アプリ設定画面の 「Incoming Webhooks」 セクションで 「Add New Webhook to Workspace」 → 先ほど取得した URL を貼り付けて保存します。
ポイント：URL に余計な空白や改行が入らないように注意してください。コピー時は「プレーンテキスト」で貼り付けると安全です。
3‑4. 設定の最終確認
- Backlog の設定画面で 「保存」 ボタンをクリック。
- 保存後、画面右上に表示される 「接続テスト」 ボタン（ある場合）で即座にテスト通知が送信できるか確認します。
4. 通知のカスタマイズ例
連携だけではなく、どんな情報を誰に届けるか を細かく制御すると、ノイズが減り実務効率が上がります。ここでは代表的なカスタマイズ手法をご紹介します。
4‑1. チャンネル別フィルタリング
課題種別やステータスごとに送信先チャンネルを分ける設定です。
| フィルタ条件 | 送信先チャンネル |
|---|---|
種別：バグ |
#bug-report |
種別：機能追加 |
#feature-request |
ステータス：完了 |
#release-notify |
優先度：高（タグ付与） |
#urgent-issues |
設定手順
- Backlog の Slack 連携画面で 「通知フィルタ」 セクションを開く。
- 「課題種別」や「ステータス」などのドロップダウンから条件を選び、送信先チャンネルを指定。
- 必要に応じて 複数条件 を追加し、「保存」。
4‑2. テンプレートでメンションやハイライトを自動付与
メッセージテンプレートに Handlebars 風のロジックを書き込むと、重要度が高い課題だけ
@hereや特定ユーザーへのメンションを挿入できます。
テンプレート例（高優先度課題に @here を付与）
|
1 2 3 4 |
{{#if (eq priority "High")}}@here {{/if}} 新規課題: {{issue.key}} - {{issue.summary}} 担当者: {{assignee.name}} |
活用シーン
- 障害発生時に全員へ即座に注意喚起したい。
- リリース直前の緊急タスクを見逃さないようにしたい。
4‑3. カスタムプレフィックスで情報量を調整
デフォルトの通知は情報が多すぎるケースがあります。
{{issue.summary}}のみ、または{{project.name}} - {{issue.key}}といったシンプルな形式に変更すると、Slack 上での可読性が向上します。
5. 動作確認とトラブルシューティング
設定後に テスト通知 を送って正常に届くか確かめることは必須です。ここでは手順とよくあるエラー例、対処法をまとめました。
5‑1. テスト通知の実施手順
実際に課題を作成・コメントし、設定したトリガーが働くか確認します。
- Backlog で テスト用課題（例：
[Test] Slack 連携確認）を作成。 - 設定した「課題作成」トリガーが有効なら、Slack に自動通知が届くはずです。
- さらにコメントやステータス変更を行い、各種トリガー が正しく機能するかチェックします。
確認ポイント：Slack 側でメッセージが見当たらない場合は、下表のチェックリストで項目を一つずつ検証してください。
| 確認項目 | 内容 |
|---|---|
| OAuth スコープ | chat:write が付与されているか |
| Webhook URL | 正しい形式・余計な空白が無いか |
| 通知フィルタ | 条件で除外されていないか |
| Slack アプリ状態 | 無効化や削除になっていないか |
5‑2. よくあるエラーと対処法
| エラーメッセージ | 原因例 | 推奨対策 |
|---|---|---|
invalid_auth |
OAuth トークンが無効、期限切れ、またはコピーミス | Slack 管理コンソールで 「Reissue Token」 し、Backlog に再設定 |
missing_scope |
必要なスコープ（例：chat:write）が未付与 |
OAuth & Permissions ページで不足スコープを追加 → 再インストール |
invalid_webhook_url |
Webhook URL が誤植、改行、または古い URL を使用 | Backlog の設定画面から 新しい URL を再取得し貼り直す |
channel_not_found |
指定した Slack チャンネルが存在しない、もしくはアプリが未参加 | Slack で対象チャンネルにアプリ（Bot）を招待する |
セキュリティ上のベストプラクティス
- トークン保管：社内パスワードマネージャーか Secrets 管理サービスへ暗号化保存し、平文で共有しない。
- 最小権限徹底：使用しないスコープは常に削除し、定期的（3〜6ヶ月）にレビューする。
- 不要時の無効化：プロジェクトが終了したら Slack アプリを「アンインストール」または Backlog の連携設定から 削除 してトークンを失効させる。
6. 運用のベストプラクティスと次のステップ
6‑1. 効果測定（※数値は例示です）
| 指標 | 期待効果（例） |
|---|---|
| 意思決定速度 | 約 30 % 向上（課題変更が即座に共有され、会議前の情報収集時間が短縮） |
| 見逃し防止率 | 約 45 % 改善（ステータスやコメントの通知で重要アップデートの抜け漏れが減少） |
⚠️ 上記数値は実務事例に基づく 概算 です。公式な統計データが存在しないため、導入効果は自社環境で測定してください。
6‑2. 推奨する運用フロー
- 初回設定完了後のテスト → テスト課題で通知を確認。
- フィルタとテンプレートの微調整 → 実際にチームが受け取る情報量・質をレビューし、不要な通知は除外。
- 定期的な権限レビュー（3 か月ごと） → OAuth スコープや Webhook の使用状況を確認し、過剰権限は削除。
6‑3. 次に取るべきアクション
| アクション | 実施期限 |
|---|---|
| Backlog の Slack 連携設定画面へアクセスし、初期設定 を完了する | 今すぐ |
| 「通知フィルタ」や「メンションテンプレート」を チームで合意 の上導入 | 設定後 1 週間以内 |
| トークン・スコープの レビュー会議 を開催し、不要権限を削除 | 3か月目に実施 |
7. 参考リンク
- Backlog 公式ヘルプ – Slack 連携手順（2026 年版）
https://support.backlog.com/hc/ja/articles/360036147653 - Slack API ドキュメント – OAuth & Permissions
https://api.slack.com/authentication/oauth-v2 - Slack Incoming Webhooks ガイド
https://api.slack.com/messaging/webhooks
この記事は、2026 年 4 月時点の UI と機能に基づいて執筆しています。Slack や Backlog のアップデートに伴い、一部手順や画面構成が変更される可能性があります。その際は公式ドキュメントをご確認ください。