Slack Integration — Setup

This page covers the one-time workspace setup — creating the Slack app, wiring the event URLs, and setting the environment variables. For the day-to-day end-user flow (mentioning the bot, replying in threads, approving tool calls), see the tutorial: Trigger agents from Slack.

How a Slack user is matched to an auxilia user

When a Slack message comes in, auxilia looks up the Slack user’s email via users.info and matches it against the workspace’s user table. If there’s no match, the bot replies with a message telling the user to sign in to auxilia first (which creates the account).

Slack users therefore need an auxilia account with the same email address as their Slack profile.

Configure the integration

Set these environment variables on the backend:

SLACK_SIGNING_SECRET=...
SLACK_BOT_TOKEN=xoxb-...

If either value is missing, the Slack endpoints still mount but will reject all incoming requests.

Create the Slack app

1. Go to api.slack.com/apps  and click Create New App → From scratch
2. Give it a name (e.g. auxilia) and pick your workspace
3. Under OAuth & Permissions, add the Bot Token Scopes:
   • app_mentions:read
   • assistant:write
   • channels:history, groups:history, im:history, mpim:history
   • chat:write
   • users:read
   • users:read.email
4. Install the app to your workspace and copy the Bot User OAuth Token (xoxb-...) into SLACK_BOT_TOKEN
5. Copy the Signing Secret from Basic Information into SLACK_SIGNING_SECRET

Event subscriptions

Under Event Subscriptions, point Slack at:

<BACKEND_URL>/integrations/slack/events

Subscribe to bot events:

• app_mention
• assistant_thread_started
• message.channels, message.groups, message.im, message.mpim

Under Interactivity & Shortcuts, enable interactivity and set the Request URL to:

<BACKEND_URL>/integrations/slack/interactions

This is where Approve / Reject button clicks are delivered.

Next

Your Slack app is now connected. For the end-user experience — how teammates mention the bot, pick an agent, send messages, and approve tool calls — see Trigger agents from Slack.