Slack

Overview

ArgentOS integrates with Slack as a workspace app using the Events API for incoming messages and the Web API for sending responses.

Prerequisites

• A Slack workspace where you have admin permissions
• ArgentOS gateway running

Step 1: Create a Slack App

1. Go to api.slack.com/apps
2. Click Create New App > From scratch
3. Name your app and select your workspace

Step 2: Configure Permissions

Navigate to OAuth & Permissions and add these Bot Token Scopes:

• chat:write -- Send messages
• channels:history -- Read messages in public channels
• groups:history -- Read messages in private channels
• im:history -- Read direct messages
• im:write -- Send direct messages
• users:read -- Look up user info

Step 3: Enable Events

Navigate to Event Subscriptions and enable events. Subscribe to these bot events:

• message.im -- Direct messages to the bot
• message.channels -- Messages in channels the bot is in
• app_mention -- When someone @mentions the bot

The Request URL will be configured automatically when you add the channel.

Step 4: Install to Workspace

Click Install to Workspace and authorize the app. Copy the Bot User OAuth Token (xoxb-...).

Step 5: Add the Channel

argent channels add slack

Paste the bot token when prompted.

Configuration

{
  "channels": {
    "slack": {
      "enabled": true,
      "token": "xoxb-your-bot-token",
      "signingSecret": "your-signing-secret",
      "allowedChannels": [],
      "allowedUsers": []
    }
  }
}

Supported Features

Tips

• Invite the bot to channels where you want it to respond: /invite @your-bot
• Use allowedChannels to restrict which channels the agent responds in
• The bot only responds when directly messaged or mentioned unless configured otherwise