> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add your AI agent to Slack

> Add your AI agent to a Slack workspace so your team can ask it questions in any channel

The Chatbase Slack integration puts your AI agent inside a Slack workspace, so anyone can @mention it in a public or private channel and get an answer in the thread, drawn from the AI agent's Data Sources. It's built for internal use, such as answering your team's questions from company docs, and it needs a paid plan.

> [card] What you can do:
>
> Give your whole workspace an AI teammate: mention it in any channel and it answers right there, in the thread, without anyone leaving Slack.

> [!NOTE]
>
> Attachments are supported: the AI agent reads JPEG, PNG, and PDF files up to 5 MB and transcribes audio files. See [Attachments and audio](#attachments-and-audio).

> [!NOTE]
>
> This page covers deploying your AI agent *into* Slack so people can talk to it. For other ways to use Slack with Chatbase:
>
> * To have your AI agent *notify* a Slack channel when a customer mentions a topic, use the [Slack notification Action](https://chatbase.co/docs/user-guides/chatbot/actions/slack.md).
> * To reply to Helpdesk tickets from Slack, see [Slack Ticket Threads](https://chatbase.co/docs/user-guides/chatbot/help-desk/slack-ticket-threads.md).
> * To post a Slack message when a Helpdesk ticket matches a trigger, use the [Send Slack message](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md#send-slack-message) trigger action.

Read our [Privacy Policy](https://www.chatbase.co/legal/privacy) for details on how Chatbase collects, uses, and stores data.

## Before you start

* A Chatbase account with an AI agent, on a paid plan. Without one, the Slack channel shows **Upgrade to enable**. If you haven't built an AI agent yet, [create a Chatbase account](https://www.chatbase.co/auth/signup), subscribe to a plan, and follow [Your first AI agent](https://chatbase.co/docs/user-guides/quick-start/your-first-agent.md).
* A Slack workspace you can install apps into.
* A workspace that isn't HIPAA-compliant. Slack is "Not available on HIPAA-compliant accounts."

## How to connect Slack

You can start the connection from either of two places. Both run the same Slack authorization:

* **Integrations**: the **Slack** card ("Manage your Slack conversations.") has a **Connect** button, which shows **Connected** afterwards.
* **Channels**: the **Slack** card shows **Setup**, and **Manage** once connected.

**1. Open your Chatbase AI agent**

Head to your [dashboard](https://www.chatbase.co/dashboard/) and click the AI agent you wish to integrate with Slack.

**2. Connect Slack**

Click **Integrations** in the left sidebar, then click **Connect** under the Slack card. A Slack window opens asking you to authorize Chatbase. Choose the workspace, review the permissions, and click **Allow**.

![Slack authorization window with the workspace picker, Chatbase permissions, and Allow button](https://mintcdn.com/chatbase/efIGqFzGSfDcyAlh/user-guides/integrations/images/slack/slack-3.png?fit=max\&auto=format\&n=efIGqFzGSfDcyAlh\&q=85\&s=573894e4d7bec2e3c4c0d79d9cec744c)

**3. Open your Slack workspace**

If all goes well, you'll see a message saying **Chatbase has been successfully added to your workspace**.

![Confirmation that Chatbase was added to the workspace](https://mintcdn.com/chatbase/kU-6NVMb2BBkym9H/user-guides/integrations/images/slack/slack-5.png?fit=max\&auto=format\&n=kU-6NVMb2BBkym9H\&q=85\&s=1a55879ef57eb235363af92c00269179)

Click **Open Slack** to launch your workspace. You'll be prompted to sign in, or to select from the workspaces you're already signed into. Click **Open** beside the target workspace.

![Selecting the target Slack workspace](https://mintcdn.com/chatbase/kU-6NVMb2BBkym9H/user-guides/integrations/images/slack/slack-6.png?fit=max\&auto=format\&n=kU-6NVMb2BBkym9H\&q=85\&s=6aa67f3d2e9b53af4241f63757463f93)

**4. Invite the AI agent to a channel**

Open any channel in your workspace and type **@chatbase** followed by a question related to your AI agent's purpose. Slack will prompt you to invite the AI agent to the channel.

![Slack prompting you to invite the Chatbase AI agent to a channel](https://mintcdn.com/chatbase/kU-6NVMb2BBkym9H/user-guides/integrations/images/slack/slack-7.png?fit=max\&auto=format\&n=kU-6NVMb2BBkym9H\&q=85\&s=9b8a4733a1f6be2f0a1fd388256f23d1)

Click **Invite Them**. The AI agent is then available in that channel. This works the same way in private channels: the app has to be a member of the channel before it can answer there.

> [!TIP]
>
> Type **@chatbase** followed by a question in the channel and confirm your AI agent responds.

![The Chatbase AI agent answering a question in a Slack channel](https://mintcdn.com/chatbase/kU-6NVMb2BBkym9H/user-guides/integrations/images/slack/slack-8.png?fit=max\&auto=format\&n=kU-6NVMb2BBkym9H\&q=85\&s=84a06ec905e5e7e350bca3af0ba8d936)

## How the AI agent works in Slack

* **It answers @mentions only.** The AI agent replies when a message mentions the Chatbase app. It doesn't answer other channel messages, and it doesn't answer direct messages sent to the app.
* **It replies in the thread.** When you mention it, the AI agent first posts a "Thinking..." placeholder, then posts the answer. If it's mentioned inside a thread, it replies in that thread rather than the main channel.
* **Each thread is one conversation.** Earlier turns in the same thread are part of the conversation history, so you can ask follow-up questions.
* **It reads the thread for context.** On each mention, the AI agent reads the thread replies posted since its last reply (or all earlier replies, the first time it's mentioned), skips messages from bots, and adds them with their authors' names ahead of your question. Messages in the channel outside the thread aren't read.
* **Conversations appear in Activity.** Slack conversations are logged in your AI agent's [Activity](https://chatbase.co/docs/user-guides/chatbot/activity.md) like any other channel, with Slack as the source.

For example, in a thread where Jane Doe posted "Our customer Acme says the export fails on large files" and John Smith replied "It happens on the Business plan too", a message saying "@chatbase what's the file size limit for exports?" gets an answer that takes both earlier replies into account.

### Attachments and audio

Files attached to the message that mentions the AI agent, and to earlier messages in the thread, are handled like this:

| File type | What happens |
| - | - |
| JPEG, PNG, and PDF, up to 5 MB each | Sent to the AI model, which reads them and answers based on their content |
| Audio files (any audio format) | Transcribed to text, and the text is used as part of the message |
| Anything else | Skipped |

Attachments use extra message credits. See [Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments).

### Message credits

Each reply in Slack uses message credits at your AI agent's [model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md) cost, the same as a reply on any other channel. [Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments) add credits per image or per PDF page.

## Settings

The Slack channel page (**Channels → Slack → Manage**) has these tabs: **Overview**, **Connections**, **Actions**, and **Extra Settings**.

### Message appearance

Replies sent by your AI agent in Slack use the AI agent name and avatar configured in your Chat Bubble settings. If a custom name and avatar are set there, those are reflected in Slack. If not, the defaults are used:

* **Name:** Chatbase
* **Avatar:** Chatbase logo

To change how your AI agent appears in Slack, update the profile picture and display name inside the widget's settings in your Chatbase dashboard.

![Updating the AI agent's display name and avatar in widget settings](https://mintcdn.com/chatbase/MVZzd9e05cJ7lFRq/user-guides/integrations/images/slack/slack-11.png?fit=max\&auto=format\&n=MVZzd9e05cJ7lFRq\&q=85\&s=373b74aecb8cfaf10f9948709372a064)

> [!NOTE]
>
> A custom display name changes only how replies look. It doesn't change the name people type to @mention the AI agent. To change that, see [Mention name](#mention-name).

### Mention name

By default, people type **@chatbase** to mention your AI agent. You can change that name, for example to **@emma**, but only from Slack. Slack stores the name in your workspace, and Chatbase has no setting for it.

**1. Open Manage apps in Slack**

Click your workspace name in the Slack sidebar, then **Tools & settings**, then **Manage apps**.

**2. Open the Chatbase app**

Select **Installed Apps**, find **Chatbase**, and click **App Details**.

**3. Rename the bot user**

Open the **Configuration** tab, find **Bot user**, edit the name, and save.

Slack describes the rename in the Bot names section of its [app design guide](https://docs.slack.dev/concepts/app-design#bot-names). A Workspace Owner can restrict who manages apps, so if you don't see these options, ask a Workspace Owner in Slack.

After the rename, people type **@** and the new name to [mention](https://slack.com/help/articles/205240127-Use-mentions-in-Slack) the AI agent, and it answers as before. The rename applies to that Slack workspace only.

### Ignore bot messages

Under **Channels → Slack → Manage → Extra Settings**, tick **Ignore bots** ("Ignore mentions posted by any bot or app").

When enabled, your AI agent ignores mentions posted by other Slack bots and apps and only responds to people. This is useful if your workspace contains automation bots or AI agents that post messages, since it prevents bot-to-bot loops.

## Limitations

* **One workspace per AI agent, and one AI agent per workspace.** The dashboard notes "Your chatbot can be connected to one Slack workspace." Connecting a Slack workspace that's already linked to another AI agent fails with "Workspace already connected".
* **No direct messages.** The AI agent answers only when mentioned in a channel or thread.
* **Not available on HIPAA-compliant workspaces.** Mentions to an AI agent on a HIPAA workspace are ignored.

## Troubleshooting

> [accordion] The AI agent doesn't reply in a channel
>
> Check that the app is a member of the channel (mention it and click **Invite Them** when Slack asks), that your message @mentions the Chatbase app, and that your workspace has a paid plan. If **Ignore bots** is on, mentions posted by bots or apps are ignored.

> [accordion] The AI agent doesn't reply to direct messages
>
> That's expected. The Slack integration answers @mentions in channels and threads only.

> [accordion] Connecting fails with "Workspace already connected"
>
> That Slack workspace is already connected to another AI agent. Each workspace can connect to one AI agent. Use the AI agent it is already connected to, or connect a different workspace.

> [accordion] The AI agent ignored a file
>
> Only JPEG, PNG, and PDF files up to 5 MB, and audio files, are processed. Other file types, and larger images or PDFs, are skipped.

## Backstage

Slack is one of the ways you can interact with Backstage, Chatbase's AI assistant for managing your AI agent. See the [Backstage documentation](https://chatbase.co/docs/user-guides/chatbot/backstage.md) to learn more.

## Frequently asked questions

> [accordion] Which Chatbase plan do I need for Slack?
>
> Any paid plan. Without one, the Slack channel shows **Upgrade to enable**. Slack isn't available on HIPAA-compliant workspaces.

> [accordion] Does @Chatbase in Slack use message credits?
>
> Yes. Each reply uses message credits at your AI agent's [model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md) cost, like any other channel, and attachments add credits. Slack conversations also appear in your AI agent's Activity.

> [accordion] Can I mention the AI agent by a name other than @chatbase?
>
> Yes. Rename the Chatbase bot user from **Manage apps** in your Slack workspace. See [Mention name](#mention-name).

> [accordion] Can I connect several AI agents to one Slack workspace?
>
> No. A Slack workspace connects to one AI agent, and an AI agent connects to one Slack workspace.

> [accordion] Does the AI agent work in private channels?
>
> Yes. Invite the app to the private channel, then @mention it.

> [accordion] Can the AI agent read the rest of the thread?
>
> Yes. When mentioned in a thread, it reads the replies in that thread (skipping bot messages) and uses them as context. It doesn't read channel messages outside the thread.

> [accordion] Can I send files to the AI agent in Slack?
>
> Yes. Attach JPEG, PNG, or PDF files up to 5 MB, or audio files, to your message. Images and PDFs are read by the AI model, and audio is transcribed to text. Other file types are skipped.

## Next steps

> [card] [Slack notification Action](https://chatbase.co/docs/user-guides/chatbot/actions/slack.md)
>
> Have your AI agent post to a Slack channel when a customer mentions a topic you care about.

> [card] [Backstage](https://chatbase.co/docs/user-guides/chatbot/backstage.md)
>
> Manage your AI agent conversationally, from Slack.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.