> ## 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.

# Slack

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

## Overview

Chatbase provides a quick way to add an AI agent to your Slack workspace. In a few minutes, you can make an AI agent available across your company's Slack channels, where it understands natural language, answers common queries, resolves issues, and looks up information, giving you round-the-clock automated support inside Slack.

> **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, so your AI agent can process them and respond based on their content. See [Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments).

> [!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.

## Before you start

* A Chatbase account with an AI agent, on a paid plan. If you haven't built one 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.

## How to connect Slack

**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.

> [!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)

## 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]
>
> If the AI agent is mentioned inside a thread, it replies within that same thread rather than the main channel. Each Slack thread is treated as a separate conversation, so the AI agent maintains accurate context within each discussion.

### Ignore bot messages

Under **Channels → Slack → Manage → Extra Settings**, tick **Ignore bots** and click **Save**.

When enabled, your AI agent ignores messages sent by other Slack bots and only responds to human users. This is useful if your workspace contains automation bots or AI agents that post messages, since it prevents bot-to-bot loops and infinite conversations.

## 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.

## Next steps

> **[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.

> **[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.