# Slack

Bring Actian AI Analyst's AI agents directly into your Slack workspace for fast, conversational access to business data.

By following this guide, you'll configure your Slack app, set up authentication, and deploy your agent to handle tasks.

***

### Step 1: Connect your slack workspace

Navigate to Connections

Click 'Slack' and then click 'Connect'

<figure><img src="/files/MCWrxzeJzCIRn9opLeah" alt=""><figcaption></figcaption></figure>

Review permissions and allow the app to connect to your workspace

<figure><img src="/files/WlabyMMj7wo8Yb7ahkbR" alt=""><figcaption></figcaption></figure>

Once connected: You should be redirected to the integration page and see connection details\\

<figure><img src="/files/PTpnXX24SGg7o8Ku91tZ" alt=""><figcaption><p>Slack Connected</p></figcaption></figure>

### Step 2: Connect agent to a slack channel

1. Navigate to an agent you wish to connect to a slack channel
2. On the top right, press share
3. Open up the slack integration and choose an existing channel or create a new one.
4. Confirm access by toggeling the checkbox acknowledging the permission.

<figure><img src="/files/mHZJxJijfvf8eLAUR2Nu" alt=""><figcaption></figcaption></figure>

After connecting you should see the following\\

<figure><img src="/files/Yh6UNTwdwqbtN8bSreTW" alt=""><figcaption><p>Agent connected to channel</p></figcaption></figure>

Once successfully connected, the agent will announce itself in the selected channel.\\

<figure><img src="/files/zsTfwdcEuctxB3RgfW5T" alt=""><figcaption><p>Agent message in channel</p></figcaption></figure>

#### Step 3: Use the agent

You can trigger agent's by tagging them using @ActianAIAnalyst\
The agent will respond with reactions and as a reply to that message.\
Tagging the agent in a follow up to that thread will trigger a follow up task in the same conversation.

Add `--plan` to your query to trigger Plan Mode. The previous `--deep` flag has been removed.

***

## Integration health & tokens

### Bot token vs user token

When you connect Slack, an *org-level bot token* is created automatically. This allows the bot to post messages and join *public* channels without any additional setup.

You (or any Studio admin) can also connect a *personal user token* by navigating to Connections > Slack and clicking "Connect". This walks you through an OAuth flow using your personal Slack account. The user token is required to invite the bot into *private* Slack channels — without it, the bot cannot access private channels.

The user token is per-user, meaning each Studio admin can connect their own personal Slack account independently.

### Checking integration health

On the Connections > Slack page, the integration health panel shows the current status of both the bot token and user token:

* A green check indicates the token is valid and working.
* A red X indicates the token is invalid or has been revoked.

Use the refresh button to re-test the tokens at any time. If a token is shown as invalid, click "Reconnect" to go through the OAuth flow again and restore the connection.

### Disconnecting

The "Disconnect" button on the Connections > Slack page removes the org's Slack integration entirely. Once disconnected, any agents that were connected to Slack channels will stop responding to messages.

***

That's it! You're ready to use Actian AI Analyst's AI agents in Slack.

Need support? Send an email to <info@wobby.ai> - our team is happy to help!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wobby.ai/connections/messaging-apps/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
