> ## Documentation Index
> Fetch the complete documentation index at: https://wisdomai-add-trigger-agent-api.mintlify.site/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. Navigate to the Slack integration page in your WisdomAI account at `https://<your-account>.askwisdom.ai/slack`. Remember to replace `<your-account>` with your specific account name.
2. Initiate the Connection by clicking the **Connect to Slack** button.
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.

<img src="https://mintcdn.com/wisdomai-add-trigger-agent-api/24Y8uyueYkarqKQ-/images/connect-to-slack.png?fit=max&auto=format&n=24Y8uyueYkarqKQ-&q=85&s=3b53d9773341edcf265cb5238053765d" alt="Snippet showing the Connect To Slack button" width="1505" height="1593" data-path="images/connect-to-slack.png" />

4. Verify the `https://<account>.askwisdom.ai/slack` page shows that WisdomAI app is connected to your workspace.

<img src="https://mintcdn.com/wisdomai-add-trigger-agent-api/24Y8uyueYkarqKQ-/images/connect-to-slack03.png?fit=max&auto=format&n=24Y8uyueYkarqKQ-&q=85&s=962d3c427d313a78fa294e92f1970233" alt="Snippet showing the Slack Integration ready" width="1544" height="371" data-path="images/connect-to-slack03.png" />

5. Look for `@WisdomAI` app on your slack workspace and start using it. When you open a direct message with the app, you will 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.

<img src="https://mintcdn.com/wisdomai-add-trigger-agent-api/24Y8uyueYkarqKQ-/images/connect-to-slack05.png?fit=max&auto=format&n=24Y8uyueYkarqKQ-&q=85&s=8ce8e9ac92092a3f35fb45184a4af66b" alt="Snippet showing the WisdomAI Integration on Slack" width="1167" height="1126" data-path="images/connect-to-slack05.png" />

## 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-add-trigger-agent-api/73vRyivjgx00o08B/images/image.png?fit=max&auto=format&n=73vRyivjgx00o08B&q=85&s=cf429befcfda58cfe0ff43285758241c" alt="Snippet showing questions and answers in Slack" title="Snippet showing questions and answers in Slack" className="mx-auto" style={{ width:"90%" }} width="1718" height="718" data-path="images/image.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. You can also select **View in WisdomAI** to continue your analysis in the main web application.

<img src="https://mintcdn.com/wisdomai-add-trigger-agent-api/L_sl-UlH6zJyfH6x/images/2025-08-25_16-30-52.png?fit=max&auto=format&n=L_sl-UlH6zJyfH6x&q=85&s=eb02e231f07b9073830e1ec3560c7f6c" 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" />