# Slack

## What you can do

* Deploy a knowledge agent your team can @mention in any channel
* Get instant answers from your connected knowledge sources
* Send messages to channels programmatically

## Connecting Slack

1. Go to **Integrations > Slack**
2. Click **Connect**
3. Authorize eesel AI in your Slack workspace
4. Choose which channels the agent should have access to

### Prerequisites

* Admin access to your Slack workspace (or permission to install apps)

## Trigger

| Trigger              | Description                                           |
| -------------------- | ----------------------------------------------------- |
| **@eesel Mentioned** | Fires when someone @mentions eesel in a Slack channel |

When triggered, the agent reads the message, searches your knowledge base, and replies in the thread.

## Action

| Action           | Description                                                       |
| ---------------- | ----------------------------------------------------------------- |
| **Send Message** | Send a message to a Slack channel (supports Block Kit formatting) |

## How it works

1. A team member types `@eesel what's our PTO policy?` in a channel
2. The agent picks up the mention
3. It searches your connected knowledge sources
4. It replies in the thread with an answer

```
#general
├── @alice: @eesel what's our return policy for defective items?
└── @eesel: Our return policy for defective items allows returns
             within 90 days of purchase. The customer needs to...
             📎 Source: Returns Policy (Confluence)
```

## Tips

**Add the agent to relevant channels.** Start with your support team channel, then expand to other teams as they find it useful.

**Train on internal docs.** Connect [Confluence](https://docs.eesel.ai/integrations/confluence), [Notion](https://docs.eesel.ai/integrations/notion), or [Google Drive](https://docs.eesel.ai/integrations/google-drive) so the agent can answer questions from your internal documentation.

**Introduce it to the team.** Post a quick message explaining what the agent can do and how to use it. Example: "We've added @eesel to this channel! Mention it with any question and it'll search our docs for an answer."

## Troubleshooting

**Agent not responding to mentions?**

* Check that the trigger is enabled in Settings > Triggers
* Verify the agent has been added to the channel
* Make sure you're using `@eesel` (the exact name)

**Agent responding in wrong channels?**

* Review which channels the agent has access to in the Slack integration settings


---

# 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.eesel.ai/integrations/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.