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

# Slack

Integrate WisdomAI with your Slack workspace to query your business data directly from your channels and direct messages. This allows you to get insights without switching contexts.

## Before you begin

Make sure you have the following:

* An active WisdomAI account.
* Administrative permissions to install apps in your Slack workspace.

## Connect to your Slack workspace

Follow these steps to connect your WisdomAI account to Slack:

1. In the left-hand navigation of WisdomAI, click the **Settings** icon, then select **Slack Integration**. You can also navigate directly to `https://<your-account>.askwisdom.ai/settings/slack`, replacing `<your-account>` with your account name.
   <Frame>
     <img src="https://mintcdn.com/wisdomai/91Y9zbvOayCuF7s8/images/image-14.png?fit=max&auto=format&n=91Y9zbvOayCuF7s8&q=85&s=eb9696bf5878e06e8d27a032c09736f1" alt="Image" width="1986" height="1872" data-path="images/image-14.png" />
   </Frame>
2. The **Slack Integration** page introduces what the WisdomAI Slack app can do. Click **Connect to Slack** to start the install.
   <Frame>
     <img src="https://mintcdn.com/wisdomai/91Y9zbvOayCuF7s8/images/image-17.png?fit=max&auto=format&n=91Y9zbvOayCuF7s8&q=85&s=383bfb9bbfb7daff4cb560d894c74500" alt="Image" width="1980" height="1320" data-path="images/image-17.png" />
   </Frame>
3. Authorize the application on the Slack page you are redirected to. After reviewing the permissions WisdomAI is requesting, click **Allow** to grant access and install the app in your workspace.
   <Frame>
     <img src="https://mintcdn.com/wisdomai/91Y9zbvOayCuF7s8/images/image-18.png?fit=max&auto=format&n=91Y9zbvOayCuF7s8&q=85&s=b683362d4b8bb85a700170fe37f44a63" alt="Image" width="1784" height="1498" data-path="images/image-18.png" />
   </Frame>
4. After authorization, you are returned to the **Slack Integration** page. The page now shows that the WisdomAI app is connected to your Slack workspace, with a green **Connected** indicator.
   <Frame>
     <img src="https://mintcdn.com/wisdomai/91Y9zbvOayCuF7s8/images/image-15.png?fit=max&auto=format&n=91Y9zbvOayCuF7s8&q=85&s=453077a1be06254596237dc7b9b156d0" alt="Image" width="2094" height="702" data-path="images/image-15.png" />
   </Frame>
5. Look for the **@WisdomAI** app in your Slack workspace and start using it. When you open a direct message with the app, you'll see a welcome message and some suggested questions. You can now ask questions in natural language to get insights from your data directly within Slack.
   <Frame>
     <img src="https://mintcdn.com/wisdomai/oq67V3T9jhHN9WJO/images/connect-to-slack05.png?fit=max&auto=format&n=oq67V3T9jhHN9WJO&q=85&s=f8f8ed8b2c2c5f628b09ce448a4ac5bd" alt="WisdomAI app welcome message in Slack" width="1167" height="1126" data-path="images/connect-to-slack05.png" />
   </Frame>

## Disconnect the Slack app

To disconnect the WisdomAI app from your Slack workspace:

1. Open **Settings** > **Slack Integration**.
2. Click the **Connected** chip in the upper right of the connection card.
3. Select **Disconnect Slack workspace** from the menu.
4. In the confirmation dialog, click **Disconnect**.

<Frame>
  <img src="https://mintcdn.com/wisdomai/91Y9zbvOayCuF7s8/images/image-16.png?fit=max&auto=format&n=91Y9zbvOayCuF7s8&q=85&s=37963e110d3c3a680692e7091026a3f1" alt="Image" width="2012" height="626" data-path="images/image-16.png" />
</Frame>

<Note>
  Disconnecting does not uninstall the app from your Slack workspace. The app stops responding to questions and scheduled Slack notifications stop working until you reconnect.
</Note>

## Permissions

When you connect WisdomAI to Slack, you will be asked to grant a set of permissions. These allow the WisdomAI app to receive your questions and post answers back into your workspace.

Here is a detailed breakdown of what each permission allows WisdomAI to do:

| Permission          | Description                                                                                                        |
| :------------------ | :----------------------------------------------------------------------------------------------------------------- |
| `app_mentions:read` | Allows the app to see messages that directly mention `@WisdomAI` in conversations where the app is in.             |
| `assistant:write`   | Allows WisdomAI to act as an AI Assistant, enabling it to provide intelligent responses and analysis within Slack. |
| `channels:history`  | View messages and content in public channels that WisdomAI has been added to.                                      |
| `chat:write`        | Allows WisdomAI to send messages and answers to your questions in channels and conversations.                      |
| `chat:write.public` | Allows WisdomAI to send messages to public channels that it isn't a member of.                                     |
| `files:write`       | Allows WisdomAI to upload, edit, and delete files.                                                                 |
| `im:history`        | View messages and content in direct messages with the WisdomAI app.                                                |
| `reactions:write`   | Allows WisdomAI to add emoji reactions to messages, for example, to acknowledge a command.                         |
| `users:read`        | Allows WisdomAI to view basic information about users in your workspace, such as their names and user IDs.         |
| `users:read.email`  | View email addresses of people in the workspace.                                                                   |

## Query your data in Slack

After connecting the app, you can interact with WisdomAI directly from your Slack workspace.

1. **Ask a Question**: You can start a direct message with the WisdomAI app or mention it in a channel to ask a question in natural language. The app will confirm that it is processing your request.
2. **Receive an Answer**: WisdomAI delivers an interactive response directly in Slack. A typical answer includes:
   * A chart visualizing the data, such as a bar chart of AWS usage by service.
   * A set of suggested follow-up questions to guide your analysis.
   * Buttons to **Show data**, **Show SQL**, change the chart type, or **Export CSV**.
     <img src="https://mintcdn.com/wisdomai/7mAQRT22_rrt5Uwo/images/2025-08-25_16-30-52.png?fit=max&auto=format&n=7mAQRT22_rrt5Uwo&q=85&s=a682e275c0936012c8d5efa61a66990f" alt="Snippet showing questions and answers in Slack" title="Snippet showing questions and answers in Slack" className="mx-auto" style={{ width:"90%" }} width="1356" height="1624" data-path="images/2025-08-25_16-30-52.png" />
3. **Interact with Results**: You can modify the visualization and explore the data without leaving Slack. For example, you can change the chart to an Area chart or expand the data table to see the specific values for each service.  See the example below: <img src="https://mintcdn.com/wisdomai/WvFp042LrVpcd3LO/images/slack-example.png?fit=max&auto=format&n=WvFp042LrVpcd3LO&q=85&s=88d199b26880fc18c61a1d9a48b2b7b1" alt="Slack Example Pn" width="1164" height="1500" data-path="images/slack-example.png" /> You can also select **View in WisdomAI** to continue your analysis in the main web application.

## Next steps

<CardGroup cols={2}>
  <Card title="Embed Chat" icon="message" href="/integrations/embeddings/iframe/embed-chat">
    Discover how to embed conversational AI chat interfaces
  </Card>

  <Card title="Embed a Dashboard" icon="chart-bar" href="/integrations/embeddings/iframe/embed-a-dashboard">
    Learn how to embed interactive dashboards and visualizations
  </Card>

  <Card title="Impersonate User API" icon="user" href="/integrations/graphql-api/mutations/auth/impersonate-user">
    Detailed documentation for the authentication API
  </Card>
</CardGroup>