Slack連携のはじめかた

AgentPM と Slack を接続すると、タスクの更新通知を Slack チャンネルで受け取ったり、Slack からタスクを作成したりできます。このページでは、組織管理者が最初に行う接続設定から、日常での使いかたまでを説明します。

できること

機能	説明
チャンネル通知	タスクの作成・更新・承認などのイベントを、プロジェクトに紐づけたチャンネルへ自動投稿
`/agentpm` コマンド	Slack から直接タスクを作成（タスク作成モーダルが開きます）
@AgentPM メンション	チャンネルで Bot にメンションすると、AI がプロジェクトの状況を踏まえて応答（AI設定が必要）

組織単位の接続は最初に1回だけ行います。

接続に失敗する場合: 「Slack連携に失敗しました」と表示されたときは、時間をおいて再試行してください。ボタン自体が表示されない場合は、システム側で Slack 連携が有効化されていません（運用者向けの Slack App セットアップ手順を参照）。

通知はプロジェクト（Space）単位で、リンクしたチャンネルに送信されます。

通知を受け取りたい Slack チャンネルで、Bot を招待する:
```
/invite @AgentPM
```
※ プライベートチャンネルでは、この招待を先に行わないと AgentPM 側にチャンネルが表示されません。
AgentPM で対象プロジェクトのプロジェクト設定 → 外部連携 → Slack を開く
チャンネル一覧から対象チャンネルを選び、**「リンク」**をクリックする
通知タイプ（タスク作成・更新・承認など）はチャンネルごとにチェックボックスで調整できます

詳しい画面操作はプロジェクト設定 › Slack連携を参照してください。

チャンネルをリンクすると、選択した通知タイプのイベントが自動で投稿されます。追加の操作は不要です。

リンク済みのチャンネルで次のコマンドを入力すると、タスク作成モーダルが開きます:

/agentpm

リンク済みのチャンネルで Bot にメンションすると、AI がプロジェクトの文脈を踏まえて応答します:

@AgentPM 今週のクライアント確認待ちタスクを教えて

チャンネル単位: プロジェクト設定 → 外部連携 → Slack で対象チャンネルのリンクを解除
組織単位（全解除）: 組織メニュー → 組織の外部連携 → Slack の**「接続を解除」**。確認ダイアログで「解除」を選ぶと、全プロジェクトのチャンネルリンクがまとめて解除されます

症状	原因と対処
「Slackと連携する」ボタンが表示されない	システム側で Slack 連携が無効。運用者に連絡（環境変数 `NEXT_PUBLIC_SLACK_ENABLED` と Slack App 設定が必要）
チャンネル一覧に目的のチャンネルが出ない	プライベートチャンネルは `/invite @AgentPM` で Bot を招待してから再読み込み
`/agentpm` が「連携されていません」と返す	そのチャンネルがどのプロジェクトにもリンクされていない。Step 2 を実施
通知が届かない	①チャンネルのリンク状態 ②通知タイプのチェック ③Bot がチャンネルに参加しているか、の順に確認
@メンションに反応しない	チャンネル未リンク、または AI 設定（API キー）未登録

Slack App（Bot）本体の作成・認証情報の設定は、開発・運用者向けの手順書を参照してください: