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

# Slack

> Start chats with the agent by mentioning the Datalooma bot in Slack.

Connect Datalooma to Slack to work with the agent where your team already talks. Mention the bot in a channel, and the agent answers in a thread with result tables, charts, and files.

## Connect Slack

An org admin connects Slack once for the organization.

**1. Open Slack settings**

Open **Settings** from the account menu, and find **Slack** on the **General** tab.

**2. Add to Slack**

Click **Add to Slack** and approve the app in your Slack workspace.

**3. Invite the bot**

In Slack, invite the Datalooma bot to the channels where you want to use it.

The Slack section then shows the bot's handle and how many people have linked their accounts, with **Reinstall** and **Disconnect**.

## Link your account

The first time you mention the bot, it sends you a direct message with **Link your Datalooma account**. Open it in a browser where you are signed in to Datalooma. The link expires after 15 minutes.

Linking connects your Slack identity to your Datalooma account, so the agent works with your connections, knowledge, and permissions.

## Use it

* **Mention the bot** in a channel to start a chat. The agent replies in a thread.
* **Reply in the thread** to continue the chat.
* **Message the bot directly** for a private chat.

Answers include result tables, charts, and attachments such as CSV files and images. Each Slack chat also appears in your [Main workspace](/docs/workspaces/overview.md#main-and-project-workspaces), where you can continue it in the browser.

When the agent needs approval, it posts a card with buttons in the thread. Only the person who started the thread can answer it.

Teammates can reply in the thread if they have edit access to the chat's [workspace](/docs/workspaces/overview.md#sharing). Anyone else is asked to have the owner share the workspace with them first.

A Slack chat never starts in **Auto** or **Bypass**. If that is your saved default, it starts in **Default** instead, because other people can see and join the thread.

### Change the permission mode

Use the `/datalooma` command in Slack:

```text theme={null}
/datalooma mode plan
```

Modes are `ask` (the **Default** mode), `plan`, `auto`, `read-only`, and `bypass`. Only the person who started the chat can change its mode. See [permission modes](/docs/foundations/agent-and-tools.md#permission-modes).

## Related

> [card] [Chats](/docs/workspaces/chats.md)
>
> Working with the agent in the browser.

> [card] [Agent & Tools](/docs/foundations/agent-and-tools.md)
>
> What the agent may do in each mode.


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