Slack App Setup

Add your NeuroGen AI agent to your Slack workspace. Your app can respond to mentions and DMs.

Prerequisites

• A NeuroGen account with an AI agent created
• A Slack account
• Admin access to a Slack workspace

Step 1: Create Your Slack App

1. Go to api.slack.com/apps

2. Click the green "Create an App" button

⚠️ Note: Ignore the "Your App Configuration Tokens" section at the bottom - that's not what you need.

1. Choose "From scratch"

2. Enter an App Name (e.g., "NeuroGen Assistant")

3. Select your Workspace

4. Click "Create App"

You'll be taken to the app's "Basic Information" page with a left sidebar for configuration.

Step 2: Add Bot Scopes

1. In the left sidebar, click "OAuth & Permissions"

2. Scroll down to the "Scopes" section

3. Under "Bot Token Scopes", click "Add an OAuth Scope"

4. Add these scopes:

Do NOT add links:read - it's not needed and can cause issues.

Step 3: Enable Direct Messages

1. In the left sidebar, click "App Home"

2. Scroll down the page until you find the "Show Tabs" section (near the bottom)

3. Check the box: "Allow users to send Slash commands and messages from the messages tab"

4. The page saves automatically

Troubleshooting: If you don't see "Show Tabs", look for "Messages Tab" toggle or "Your App's Presence in Slack" section.

Step 4: Set Up Event Subscriptions

1. In the left sidebar, click "Event Subscriptions"

2. Toggle "Enable Events" to ON

3. For Request URL, enter: https://neurogen.cc/api/slack/events Wait for the green "Verified" checkmark.

4. Scroll down to "Subscribe to bot events"

5. Click "Add Bot User Event" and add:

1. Click Save Changes

⚠️ Important: Do NOT add anything to "App Unfurl Domains" - leave it empty. Adding domains there can break your workspace access.

Step 5: Install to Workspace

1. In the left sidebar, click "Install App"

2. Click "Install to Workspace"

3. Click "Allow" to grant permissions

4. Copy the "Bot User OAuth Token" (starts with xoxb-)

Use the Bot User OAuth Token, not the User OAuth Token.

Step 6: Connect to NeuroGen

1. Go to Dashboard → Integrations

2. Click Slack

3. Paste your Bot User OAuth Token

4. Select an AI Agent

5. Click Connect Slack App

Step 7: Test Your Bot

Option 1: Direct Message

1. In Slack, find "Apps" in the left sidebar
2. Click your app name
3. Send a message like "Hello"

Option 2: In a Channel

1. Go to any channel
2. Type /invite @YourAppName
3. Then type @YourAppName hello

Troubleshooting

Greyed Out Screen / Can't Access Workspace

This is usually caused by App Unfurl Domains:

1. Go to api.slack.com/apps → your app
2. Click "Event Subscriptions"
3. Scroll to "App Unfurl Domains"
4. Remove all domains listed there
5. Save and reinstall the app

"Sending messages to this app has been turned off"

The Messages Tab isn't enabled:

1. Go to api.slack.com/apps → your app
2. Click "App Home"
3. Scroll down to "Show Tabs"
4. Check "Allow users to send Slash commands and messages from the messages tab"
5. Reinstall the app

Bot Not Responding

1. Check Event Subscriptions is enabled with green checkmark
2. Verify Request URL: https://neurogen.cc/api/slack/events
3. Make sure message.im and app_mention events are subscribed
4. Reinstall the app after any changes

Can't Find the Bot in Slack

1. In Slack sidebar, look for "Apps" section
2. If not visible, click "More" → "Apps"
3. Or press Ctrl+K and search for your app name

Token Errors

• Make sure you copied the Bot User OAuth Token (starts with xoxb-)
• NOT the User OAuth Token (starts with xoxp-)

What You DON'T Need

These are not required and can cause problems:

• ❌ Redirect URLs - only needed for public distribution
• ❌ links:read scope - causes unfurl domain requirements
• ❌ link_shared event - causes unfurl domain requirements
• ❌ App Unfurl Domains - can break workspace access
• ❌ User OAuth Token - use Bot token instead

Quick Reference

Need Help?

Contact support@neurogen.cc