Chatspark
⌘K
⌘K

Slack

Deploy your AI agent to a Slack workspace so team members or customers can ask questions by mentioning the bot or sending it a direct message.

10 min read

Updated September 2026

Overview

The Slack channel turns your ChatSpark AI agent into a Slack bot. Once installed in a workspace, users can ask the bot questions by mentioning it in a channel or sending it a direct message. The agent responds using your training data.

Slack works well for internal teams who need instant answers about company policies, HR questions, IT support, or any other knowledge base. It also supports customer-facing use through Slack Connect shared channels.

Plan Requirement
The Slack channel is available on Pro and Enterprise plans only. Upgrade your plan from Settings before starting this setup.
Create Your Agent First
The Slack setup requires you to create and save your agent before configuring the Slack connection. The App Manifest JSON that Slack needs is generated automatically by ChatSpark and includes your agent ID in the webhook URL. That ID only exists after the agent is saved for the first time. Follow the steps below in order.

Prerequisites

  • A Slack workspace where you have admin access
  • Permission to create and install Slack apps in that workspace

Setup Instructions

Step 1: Create and Save Your Agent

  1. Go to AI Agents in your ChatSpark dashboard
  2. Click Create Agent
  3. In the Settings tab, find the AI Agent Type dropdown
  4. Select Slack
  5. Fill in your agent name and any other settings you want to configure
  6. Click Save to create the agent

After saving, the Slack Integration section in Settings will show a pre-filled Slack App Manifest field with a copy button. This JSON is unique to your agent and contains the webhook URL that Slack will use to send messages to it.

Step 2: Copy the App Manifest JSON

  1. Open your agent and go to the Settings tab
  2. Scroll to the Slack Integration section
  3. Click the copy button next to the Slack App Manifest field to copy the full JSON
Manifest is Read-Only
The App Manifest field is read-only. Use the copy button to get the full JSON content. Do not try to edit it manually.

Step 3: Create a Slack App from the Manifest

  1. Go to api.slack.com/apps
  2. Click Create New App
  3. Choose From an app manifest
  4. Select the Slack workspace where you want to install the agent
  5. On the next screen, click the JSON tab
  6. Clear the existing content and paste the App Manifest JSON you copied from ChatSpark
  7. Click Next and then Create

Step 4: Install the App to Your Workspace

  1. After creating the app, you will be on the app settings page in the Slack API portal
  2. Go to Install App in the left sidebar
  3. Click Install to Workspace
  4. Review the permissions and click Allow

Step 5: Copy Your Bot Token

  1. After installing, you will be redirected back to the Install App page
  2. Under OAuth Tokens for Your Workspace, find the Bot User OAuth Token
  3. It starts with xoxb-
  4. Copy the full token
Keep Your Bot Token Private
Your bot token gives full control over your Slack bot. Do not share it publicly, commit it to version control, or include it in client-side code. If it is ever compromised, regenerate it from the Slack API portal.

Step 6: Add the Token to ChatSpark

  1. Go back to your agent in ChatSpark and open the Settings tab
  2. Scroll to the Slack Integration section
  3. Paste your Bot User OAuth Token into the Bot User OAuth Token field
  4. Click Save

Your agent is now live in Slack. Try mentioning the bot in a channel or sending it a direct message to test it.

How It Works

The App Manifest configures Slack to send messages to your ChatSpark agent through event subscriptions. When a user mentions your bot in a channel (@YourBotName) or sends it a direct message, Slack forwards the event to ChatSpark. ChatSpark processes it through your agent and posts the response back to the same channel or DM thread.

The App Manifest enables two event types: app_mention for channel mentions and message.im for direct messages.

Adding the Bot to Channels

After installation, you need to invite the bot to any channels where you want it to respond. In Slack, open the channel and type /invite @YourBotName. The bot will only respond in channels it has been invited to.

For direct messages, users can find your bot in the Slack sidebar under Apps or by searching for its name.

Troubleshooting

The Slack App Manifest field shows a placeholder message

The App Manifest is only generated after your agent has been saved with a name. Make sure you have filled in the agent name and clicked Savebefore trying to copy the manifest.

Token is rejected or bot does not respond

Confirm you copied the Bot User OAuth Token (starts with xoxb-) and not the User OAuth Token or App-Level Token, which look similar. Only the bot token will work. If you are unsure, go back to the Install App page in the Slack API portal and copy the correct token.

Bot is in the channel but not responding

Make sure the message includes a mention of the bot name (for example, @YourBotName hello). The agent only responds to app mentions in channels, not to all messages. For private conversations without mentions, use a direct message instead.

Slack rejects the App Manifest during creation

Make sure the JSON was pasted into the JSON tab in the Slack manifest editor, not the YAML tab. Also confirm you replaced all existing content in the field before pasting.

Slack Support
For questions about Slack app configuration or permissions, visit the Slack API documentation.

Previous

Telegram

Next

Discord