Slack

Setup

Connecting Your Agentic Bot to Slack

This guide will help you connect your AI-powered agentic chatbot with Slack, enabling your bot to send and receive messages directly in your Slack workspace.

Once connected, your bot can:

Reply to Slack users in real time
Send automated updates or alerts
Handle customer support directly from Slack

Step 1: Create a New Slack Configuration

Navigate to your website’s Integrations → Slack section.
Click ➕ Add Configuration or New Configuration.
A new configuration form will open (as shown in the image above).
Fill in the following fields:
- SignIn Secret
- SignIn Bot Token
- (Optional) Configuration name
Choose the agent (if applicable) you want to connect from the dropdown menu.
Click 💾 Save Configuration.

Once saved, you’ll see Webhook URLs generated for each environment:

DEV — Development
UAT — Testing
PROD — Production

These URLs will be used later inside your Slack App settings.

Step 2: Create a Slack App

Before you can fill in your SignIn credentials, you need to register a Slack App.

Go to Slack API Apps.
Click Create New App → From scratch.
Enter an App Name (e.g., Agentic Chatbot).
Select the Workspace where you want to install the bot.
Click Create App.

You’ve now created a Slack app — next, we’ll configure permissions and tokens.

Step 3: Generate the Bot Token

In your app’s left sidebar, go to OAuth & Permissions.
Scroll to the Scopes section.
Under Bot Token Scopes, add the following recommended permissions:

chat:write
channels:read
channels:history
im:read
im:history
users:read
files:read
files:write

(You can add more scopes depending on your bot’s features.)

Scroll up and click Install to Workspace.
Authorize the app by clicking Allow.
Copy the Bot User OAuth Token — it starts with xoxb-....
Paste this token into your website’s SignIn Bot Token field.

Step 4: Get Your Signing Secret

In your Slack App settings, go to Basic Information.
Scroll down to App Credentials.
Copy the Signing Secret.
Paste it into the SignIn Secret field in your website’s configuration form.

Step 5: Save and Copy the Webhook URL

Once both fields are filled, click Save Configuration.

After saving, your integration will generate Webhook URLs for each environment:

DEV: https://api-server-dev.yourdomain.ai/slack/.../development

UAT: https://api-server-dev.yourdomain.ai/slack/.../uat

PROD: https://api-server-dev.yourdomain.ai/slack/.../production

Step 6: Connect Your Bot to Slack Events

Now that your app and credentials are ready, you need to link the webhook URL with Slack’s Event Subscriptions.

In your Slack App, go to Event Subscriptions (under Features).
Turn ON “Enable Events.”
Copy the appropriate Webhook URL (e.g., DEV) from your website.
Paste it into the Request URL field in Slack.
Slack will verify the URL automatically.
Once verified, scroll down and click Save Changes.

💡 Note: Slack allows only one Request URL per app.
If you’re testing, use your DEV URL first and switch to PROD when ready.

Still in Event Subscriptions, scroll to Subscribe to bot events and add the events your chatbot needs, for example:

message.channels → for public channels
message.im → for direct messages
app_mention → to respond when mentioned

Click Save Changes.

Your chatbot can now listen and respond to these Slack events. 🎉

Summary

Step	Action	Output
1	Create configuration	Opens Slack setup form
2	Create Slack app	Registers app in your workspace
3	Generate Bot Token	Provides authentication token
4	Get Signing Secret	Adds verification for secure requests
5	Save config	Generates webhook URLs
6	Add webhook to Slack	Connects your bot to Slack events

Common Issues

Invalid Request URL:
Ensure your webhook URL is publicly accessible (e.g., HTTPS).

Token Expired:
If token rotation is enabled in Slack, tokens may expire after 12 hours.
Disable token rotation for production use.

Missing Permissions:
Double-check that all required scopes are added under Bot Token Scopes.