Slack Bot

• Listens for mentions in Slack channels
• Processes questions using the same agent as the web chat interface
• Returns answers with SQL queries, data tables, and visualizations
• Maintains conversation context within Slack threads

​

Setup

​

Step 1: Create a Slack App

1. Go to https://api.slack.com/apps/
2. Click “Create New App”
3. Select “From scratch”
4. Name your app (e.g., “nao-chat”)
5. Select your workspace
6. Click “Create App”

​

Step 2: Configure Bot Scope

1. In your Slack app settings, go to “OAuth & Permissions”
2. Scroll to “Bot Token Scopes”
3. Add the following scopes:
   • app_mentions:read - To receive mentions of your bot
   • chat:write - To send messages to Slack

​

Step 3: Install App to Workspace

1. Still in “OAuth & Permissions”, scroll to the top
2. Click “Install to Workspace”
3. Review permissions and click “Allow”

​

Step 4: Connect your Slack Bot to nao Agent

1. From “OAuth & Permissions” page, copy the Bot User OAuth Token (starts with xoxb-)
2. In nao UI, go to Settings / Project / Slack integration and paste the Bot Token
3. In Slack interface, go to “Basic Information” in your app settings and copy the Signing Secret
4. In nao UI, paste the signing secret

1. From “OAuth & Permissions” page, copy the Bot User OAuth Token (starts with xoxb-)
2. In Slack interface, go to “Basic Information” in your app settings and copy the Signing Secret
3. Add these variables to your deployed container

SLACK_BOT_TOKEN=xoxb-your-bot-token-here
SLACK_SIGNING_SECRET=your-signing-secret-here

​

Step 5: Configure Event & Interactions Subscriptions

1. In nao UI, go to the Settings / Project / Slack integration You will see 2 urls: Event Subscriptions → Request URL and Interactivity & Shortcuts → Request URL
2. Go to “Event Subscriptions” in your app settings
3. Enable “Enable Events”
4. Set the Request URL to the Event Subscriptions → Request URL from nao UI Example:
   Copy

   https://your-deployed-instance-url/api/slack/events/{projectId}/app_mention
   
5. Under “Subscribe to bot events”, add:
   • app_mentions - Listen for when users mention your bot
6. Click “Save Changes”
7. Go to “Interactivity & Shortcuts” in your app settings
8. Enable “Interactivity”
9. Set the Request URL to Interactivity & Shortcuts → Request URL Example:
   Copy

   https://your-deployed-instance-url/api/slack/events/{projectId}/interactions
   
10. Click “Save Changes”

​

Step 6: Add Bot to Channels

1. In Slack, go to any channel where you want the bot
2. Type /invite @nao-chat (or your bot’s name)
3. The bot will now listen for mentions in that channel

​

Usage

@nao-chat What were our top 5 products by revenue last month?

1. Process your question using the same agent as the web interface
2. Generate SQL queries based on your context
3. Execute queries against your connected databases
4. Return results in a formatted Slack message
5. Send you the link to the full conversation to open it in browser UI

@nao-chat What were our top 5 products by revenue last month?
# ... bot responds ...

@nao-chat Can you break that down by region?
# ... bot responds with regional breakdown ...