Skip to main content

​
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

​
Setup

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
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
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.
4

Install to Workspace

Click Install to Workspace and authorize the app. Copy the Bot User OAuth Token (xoxb-...).
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

FeatureSupported
Direct messagesYes
Channel messagesYes
ThreadsYes
File uploadsYes
Slash commandsPlanned
Interactive modalsNo
Workflow BuilderNo

​
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