Slack

Documentation Index

Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt

Use this file to discover all available pages before exploring further.

Slack App の Socket Mode を通じて CowAgent を接続します。ダイレクトメッセージ（DM）およびチャンネル（@メンションまたはスレッド内の返信で起動）に対応。Socket Mode は WebSocket の常時接続を使うため公開 IP やコールバック URL は不要で、すぐに利用できます。

​

1. 接続手順

​

ステップ 1: Slack App を作成

1. Slack API アプリ管理ページ を開き、Create New App → From scratch をクリックします。
2. App Name（例: CowAgent）を入力し、インストール先の Workspace を選択して作成します。

​

ステップ 2: Socket Mode を有効化し App Token を取得

1. 左メニューの Settings → Socket Mode で Enable Socket Mode をオンにします。
2. connections:write スコープを持つ App-Level Token の生成を求められます。xapp- で始まるこの Token を保存してください。

​

ステップ 3: Bot 権限を設定してインストール

1. Features → OAuth & Permissions を開き、Bot Token Scopes で Add an OAuth Scope をクリックして以下を 1 つずつ追加します:
   app_mentions:read
   channels:history
   chat:write
   commands
   files:read
   files:write
   groups:history
   im:history
   mpim:history
   users:read
   
   files:read / files:write は画像・ファイルの送受信に使用します。テキスト会話のみであれば省略可能です。
2. Features → Event Subscriptions を開き、Enable Events をオンにして、Subscribe to bot events で Add Bot User Event をクリックし、以下を追加します:
   app_mention
   message.im
   message.channels
   
   非公開チャンネルで使用する場合は message.groups も追加してください。
3. Features → App Home を開き、Show Tabs 内の Messages Tab を有効にして、下の Allow users to send Slash commands and messages from the messages tab（メッセージタブからの送信を許可）にチェックを入れます。これを行わないと DM の入力欄が無効化され、ボットにメッセージを送れません。
4. OAuth & Permissions に戻り、Install to Workspace をクリックしてインストールします。インストール後、xoxb- で始まる Bot User OAuth Token を取得します。

​

ステップ 4: CowAgent に接続

{
  "channel_type": "slack",
  "slack_bot_token": "xoxb-xxxxxxxxxxxx",
  "slack_app_token": "xapp-xxxxxxxxxxxx",
  "slack_group_trigger": "mention_or_reply"
}

[Slack] Bot logged in as user_id=U0XXXXXXX, team=Txxxxxxxx
[Slack] ✅ Slack bot ready, listening for events

​

2. 機能

​

3. 使い方

• ダイレクトメッセージ（DM）: Slack の左サイドバー Apps からアプリを開き、直接メッセージを送ります。
• チャンネル: アプリをチャンネルに招待し（/invite @your-app）、@your-app こんにちは で起動します。以降は同じスレッド内で返信すれば会話を継続できます。