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

Paste the bot token when prompted.

​
Configuration

​
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