Slack Bot 連携

任意のエージェントを Slack Bot に接続すれば、チームは Slack の中から直接それを使えます——Bot に DM したり、チャンネルで @ メンションしたり、/issue と入力してアプリを開かずに Multica イシューを起票したりできます。

Slack は自分のアプリを持ち込む（BYO: bring-your-own-app）モデルを採用しています。ワークスペースの admin が Slack アプリを作成し、自分の Slack ワークスペースにインストールして、そのトークンを Multica に貼り付けます。エージェントごとに専用の Slack アプリを持つため、同じ Slack ワークスペース内で複数のエージェントがそれぞれ別個に @ メンションできる異なる Bot を持てます。（これは紐づけがスキャンしてインストールするフローである Lark とは異なります。）

セットアップ全体は以下のとおりで、所要時間は約 5 分です。最終的に、Multica に貼り付ける 2 つのトークンが得られます。

• Bot トークン —— xoxb- で始まります
• App-level トークン —— xapp- で始まります

Slack アプリをセットアップする

1. マニフェストからアプリを作成する

1. https://api.slack.com/apps を開き、Create New App をクリックします。
2. From a manifest を選びます。
3. アプリをインストールする Slack ワークスペースを選びます。
4. YAML タブに切り替え、下記のマニフェストを貼り付けて、内容を確認しアプリを作成します。

display_information:
  name: Multica
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: Multica
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - groups:history
      - im:history
      - mpim:history
      - chat:write
      - users:read
settings:
  event_subscriptions:
    bot_events:
      - app_mention
      - message.im
      - message.channels
      - message.groups
      - message.mpim
  interactivity:
    is_enabled: false
  org_deploy_enabled: false
  socket_mode_enabled: true
  token_rotation_enabled: false

このマニフェストは Multica が必要とするものをすべて設定するので、手作業で何かを設定する必要はありません。

OAuth リダイレクト URL はありません。BYO は OAuth を使わないからです。

2. アプリをインストールして Bot トークンをコピーする

1. アプリの左ナビで Install App（または OAuth & Permissions）を開きます。
2. Install to Workspace をクリックして承認します。
3. Bot User OAuth Token をコピーします——xoxb- で始まります。これがあなたの Bot トークンです。

3. App-level トークンを作成する

app-level トークンは Socket Mode 接続を認可します。これはコンソールでしか作成できません（OAuth の一部ではありません）。

1. Basic Information → App-Level Tokens を開き、Generate Token and Scopes をクリックします。
2. 任意の名前を付けます。
3. Add Scope をクリックし、リストから connections:write を選びます（これはピッカーなので、入力せずに選択してください）。
4. Generate をクリックし、トークンをコピーします——xapp- で始まります。これがあなたの App-level トークンです。

4. Multica で接続する

1. Agents → あなたのエージェント からそのエージェントを開き、Integrations タブ（または左サイドバーの Integrations 区画）を開きます。
2. Connect Slack をクリックします。
3. Bot トークン（xoxb-）と App-level トークン（xapp-）を貼り付け、Connect をクリックします。
4. エージェントに Connected to Slack と表示されます。Bot はこれで、自身の Socket Mode 接続を通じて待ち受けています。

この連携でできること

Bot を使う（メンバー）

最初のメッセージ：アカウントを紐づける

初めて Bot を @ メンションするか DM すると、Bot は アカウントを紐づける プロンプトで返信します。リンクをタップして Multica にサインインすると、あなたの Slack アイデンティティがあなたの Multica メンバーシップに紐づきます——これによって、エージェントがあなたとして振る舞えるようになります（たとえば /issue はあなたの名義でイシューを起票します）。このリンクは使い切りで、約 15 分で失効します。新しいものが必要なら、もう一度 Bot にメッセージを送るだけです。

対話と /issue

• チャンネルで —— Bot は自動では参加しません。一度 /invite @your-bot を実行してから、@your-bot <あなたのメッセージ> とします。フォローアップのたびに再度メンションしてください（Bot は自分をメンションしたメッセージだけを読みます）。
• DM で —— Slack サイドバーの Apps 区画から Bot を開いて直接メッセージを送ります。メンションは不要です。
• イシューを起票する —— /issue Fix the login redirect と送ります。タイトルの後ろに行を足せば、それが説明になります。

管理と切断

ワークスペース全体の管理は Settings → Integrations にあります。

• Connected bots は、ワークスペース内のすべての Bot と、それぞれが紐づくエージェントを一覧表示します（すべてのメンバーから見えます）。
• Disconnect は owner / admin 専用 です。切断すると Bot は Slack メッセージの受信を停止し、その接続が破棄されます。インストール記録は監査のために保持され、あとで再接続できます。

権限

• 接続 / 切断 にはワークスペースの owner または admin が必要です。
• Bot との対話 には、Slack アイデンティティを紐づけたワークスペースメンバーであることが必要です。それ以外の人は一律に破棄されます。
• 破棄されたメッセージの本文が保存されることはありません——監査のために破棄理由だけが記録されます。

セルフホストのセットアップ

Multica Cloud では連携はすでに利用可能です——このセクションは飛ばしてください。

セルフホストの場合、Slack は保存時の暗号化キーを設定するまでオフです。このキーは、各アプリの bot トークン + app-level トークンがデータベースに触れる前にそれを暗号化します。BYO には OAuth の client id/secret は不要で、デプロイレベルの app トークンも不要です——各インストールは admin が貼り付けたトークンを使います。

1. 32 バイトのキーを生成し、API サーバーに設定します。

   MULTICA_SLACK_SECRET_KEY=<base64-encoded 32-byte key>

   たとえば: openssl rand -base64 32。

2. API を再起動します。キーを設定するまで、Settings → Integrations には「Slack integration not enabled」という通知が表示され、Connect Slack のエントリポイントは非表示のままになります。

次に

• Chat 連携 — チャンネルエンジン、セッション、認可の仕組み
• エージェント · Chat · イシュー
• 環境変数 — セルフホスト構成の完全なリファレンス