Skip to main content
Consumers are entry points where users interact with the AI. This guide covers adding a Slack consumer, the most common type.

​
Prerequisites

  • A Slack bot token and app token (configured at org level in Settings > Integrations)
  • A workspace to bind the consumer to

​
Configure Slack at org level

Before binding channels, you need to configure the Slack bot at the organisation level:
  1. Go to Settings > Integrations
  2. Enter your Slack bot token and Slack app token
  3. Click Test to verify the connection
This creates a single Slack bot shared by all workspaces.

​
Bind a channel via dashboard

  1. Navigate to your workspace
  2. Open the Consumers tab
  3. Click Add consumer
  4. Select Slack as the type
  5. Enter the Slack channel ID and optional channel name
  6. Click Save
The channel is now bound to this workspace. Messages mentioning the bot in this channel will be routed here.

​
Bind via API

​
Connect consumer credentials

curl -X POST https://your-instance/api/connectors/consumer \
  -H "Content-Type: application/json" \
  -H "Cookie: supaproxy_session=YOUR_JWT" \
  -d '{
    "type": "slack",
    "workspace_id": "ws-example",
    "credentials": {
      "bot_token": "xoxb-...",
      "app_token": "xapp-..."
    }
  }'

​
Bind a channel

curl -X POST https://your-instance/api/connectors/consumer/channel \
  -H "Content-Type: application/json" \
  -H "Cookie: supaproxy_session=YOUR_JWT" \
  -d '{
    "type": "slack",
    "workspace_id": "ws-example",
    "channel_id": "C0EXAMPLE123",
    "channel_name": "#support-assist"
  }'
A channel can only be bound to one workspace. If the channel is already bound elsewhere, the request will be rejected.

​
How Slack messages are processed

  1. User mentions the bot in a bound channel
  2. SupaProxy receives the message via Socket Mode
  3. The channel ID is looked up to find the workspace
  4. A conversation is created (or the existing thread conversation is extended)
  5. The query runs through the agent loop
  6. The response is posted back to the Slack thread