Slackの接続

Slackを接続すると、AIが作成したレポート・分析結果・通知をチームのSlackチャンネルへ直接送信できます。送信専用の連携のため、会話の内容は読み取りません。

必要なもの

• Slackワークスペースでアプリを作成できるアカウント — 管理者でなくても構いませんが、組織の設定によってはアプリのインストールに管理者の承認が必要な場合があります。

• Neuroワークスペースで連携を追加できる権限

まず、すでにインストール済みか確認する

チームのほかのメンバーが、すでにPango Neuroアプリをインストールしている可能性があります。NeuroからはSlackにアプリがすでにあるかどうかがわからないため、新しく作成する前に次の3点を確認してください。重複作成や承認の手間を省けます。

• ほかのNeuroワークスペースにすでに接続されている場合 — 接続画面上部の既存の Slack 接続を使用に表示されます。選ぶだけで完了です。ただし、この一覧には自分がアクセスできるワークスペースだけが表示されます。外部メンバーとして特定のワークスペースにだけ招待されている場合や、同僚が別の組織に所属している場合は、その同僚がすでに接続していても自分の画面には表示されません。

• 以前に自分でアプリを作成した場合 — 接続画面の作成済みアプリを確認リンク（またはapi.slack.com/apps）にアプリが表示されます。新しく作成せず、そのアプリのOAuth & Permissionsでトークンだけをコピーして、ステップ2に進んでください。

• 同僚が作成した場合 — 自分のアプリ一覧には表示されません。Slackのアプリ一覧には、自分が作成したアプリか、コラボレーターとして追加されたアプリだけが表示されます。その同僚にNeuroで直接接続してもらうか、Slackアプリ画面のCollaboratorsに自分を追加してもらうよう依頼してください。

ステップ1 — Slackアプリを作成する

1. Neuroワークスペースのデータ連携 → Slackカードをクリックします。

2. 上記の確認が済んだら、接続画面のSlack アプリを作成ボタンを押します。新しいタブでSlackアプリの作成画面が開き、アプリ名と必要な3つの権限が入力済みの状態になっています。（隣の作成済みアプリを確認からは、自分が作成したアプリの一覧に移動します。）

3. 同じ画面の下にあるWorkspaceで、アプリをインストールするSlackワークスペースを選び、Nextを押します。（ワークスペースを選ぶまでNextは押せません。）

1. 次の画面（Review your app）で権限を確認し、Create and Installを押します。権限の確認画面が表示されたら許可してください。アプリの作成とワークスペースへのインストールが、この1回で完了します。

ステップ2 — Botトークンをコピーする

1. アプリ画面左側のメニューでOAuth & Permissionsを開きます。

2. OAuth TokensにあるBot User OAuth TokenをCopyでコピーします。xoxb-で始まる文字列です。

同じ画面の下にあるBotトークンのスコープ（Bot Token Scopes）で、3つの権限がそのまま残っているか確認できます。

ステップ3 — Neuroに接続する

1. 接続画面のBot User OAuth Token入力欄にコピーしたトークンを貼り付け、接続を押します。

2. 保存の前に、NeuroがSlackに直接問い合わせてトークンが有効か、3つの権限がすべて揃っているかを検査します。検査を通過したトークンだけが暗号化して保存され、保存後は画面に再表示されません。

（任意）アプリアイコンを設定する

Slackアプリの設定では、アイコンを自動で入れられません。接続画面のアプリアイコンをダウンロードで画像を保存し、Slackアプリ画面のBasic Information → Display Information → App Iconでアップロードすると、チャンネルに表示されるBotのアイコンが変わります。

リクエストする権限

• chat:write — メッセージを送信します。

• chat:write.public — Botを招待していない公開チャンネルにも送信します。チャンネルごとにBotを招待する手間が省けます。

• channels:read — 公開チャンネルの一覧（名前・ID）を表示します。会話の内容ではありません。「マーケティングのチャンネル」のように大まかに伝えたチャンネル名から、実際のチャンネルを見つけるために使います。

アプリの所有権と責任の分担

NeuroはSlackマーケットプレイスで共用アプリを配布していません。代わりにお客様が自社のワークスペースにアプリを作成し、NeuroはそのアプリのBotトークンを受け取って送信にのみ使用します。そのため、権限の付与・取り消し・監査はすべてお客様の管理下にあります。

• アプリの所有 — お客様のSlackワークスペース。アプリの名前・アイコン・権限・削除はすべてお客様が管理します。

• 権限の範囲 — 上記の3つ。入力済みの設定を変えて作成したアプリは権限が異なる場合があり、その範囲はワークスペース側の管理責任となります。

• トークンの保管 — Neuroが暗号化し、該当ワークスペースに限って保管します。保存後は、どこにも再表示されません。

• 送信内容 — ユーザーの指示に基づいてAIエージェントが作成します。送信は取り消せないため、実行前に承認ステップを経ます。

• 権限の取り消し — Slackのアプリ管理画面でアプリを削除すると、すぐに取り消されます。Neuroのデータ連携画面で連携解除すると、保存されたトークンも削除されます。

• 監査 — Botが送信したメッセージはお客様のSlackにそのまま残るため、いつ何が送信されたかを確認できます。

管理者の承認が必要な組織の場合

アプリのインストールにワークスペース管理者の承認が必要な組織では、接続画面の承認申請の文面をコピーを押し、表示された文面をそのまま承認申請に貼り付けてください。リクエストする3つの権限と「会話を読み取らない」ことがまとめられているため、セキュリティ審査が早く進みます。

使い方の例

接続後は、チャットでふだんの言葉で依頼するだけです。チャンネル名を正確に知らなくても構いません。#の有無、スペース、大文字・小文字の違いは自動で合わせて探します。

• 「今週の広告成果をまとめて、#マーケティングチャンネルに送って」

• 「昨日と比べてコンバージョン数が急減したキャンペーンをまとめて、運用チャンネルに知らせて」

• スケジュール実行と組み合わせれば、毎朝レポートを自動でチャンネルに投稿できます。

トラブルシューティング

「このトークンには必要な権限がありません」と表示される

アプリ設定画面の権限一覧と、トークンに実際に付与されている権限は別物です。権限を追加しても再インストールしなければ、トークンは以前の権限のままです。OAuth & Permissions → Reinstall to Workspaceで再インストールし、新しく発行されたトークンを貼り付け直してください。アプリが複数ある場合は、Pango Neuroアプリのトークンかどうかも確認してください。

「Botトークンの形式ではありません」と表示される

ユーザートークン（xoxp-）を貼り付けた場合です。この連携はBotの名前でのみ送信するため、Bot User OAuth Token（xoxb-）が必要です。

チャンネルが見つからないと表示される

チャンネル一覧の取得は公開チャンネルだけが対象です（アーカイブ済みのチャンネルを除く）。プライベートチャンネルに送信するには、そのチャンネルで/invite @Pango Neuroを実行してBotを招待し、チャンネルID（C…）を指定して依頼してください。チャンネルIDは、Slackでチャンネル名を右クリックし、チャンネル詳細の下部で確認できます。

どのSlackに送信されるかわからない

1つのNeuroワークスペースにSlack接続が複数ある場合は、勝手に選ばずに確認します。誤ったワークスペースに通知が送信されるのを防ぐための動作です。

連携を解除したい

Neuroのデータ連携画面でSlackを連携解除すると、保存されたトークンが削除されます。アプリ自体を削除するには、Slackのアプリ管理画面で該当アプリを削除してください。削除するとすぐに、すべての権限が取り消されます。