# Slack

## Introduction

In this tutorial we will show you how to integrate your Caleida AI Agent into a Slack Workspace. This integration is very easy and quick to do, it won't take you more than 5 minutes to do it.

## *Previous step*

For this integration you need a Slack account and a workspace. If you have one you can easily create it from the following [link](https://slack.com/intl/es-es/). Make sure you are logged in before starting the process to speed up the process.

## 1. Choose your Agent

As with all integrations, the first thing you must do is choose the Agent you want to integrate from the Caleida Dashboard control panel. If you don't have one yet or just want to integrate a new one for Slack you can consult our tutorial on [How to create and configure an Agent step by step.](/set-up-your-agent/set-up-your-agent-step-by-step..md)

## 2. Integrate your AI Agent with Slack

Once we already have the Agent chosen we will go to **Integrations > Advanced,** and here we will click on **Settings** in the Slack integration.

<figure><img src="/files/5N3HOarKEUMZNDcGu9cJ" alt=""><figcaption></figcaption></figure>

### 2.1 Add the Agent to Slack

Once you have clicked on "**Add "**, it will appear in the Pop-Up. Here you must click on **Add to Slack.**.

Clicking it will redirect you to a **Slack** window to grant permissions to the Agent.

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

#### 2.1.1 Grant Permissions to the Agent

In this window you will simply need to grant permissions to the Agent in order to add it to your Workspace.

Your privacy is important to us, so the permissions required are those strictly necessary for your Agent to function correctly in your **Slack Workspace**.

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

### 2.2 Verification

To check that you have integrated your **Caleida AI Agent** correctly in your **Workspace** access it from Slack.

In the left side menu, under **Applications**, a new application called **Caleida** should appear.

By clicking on it you will be able to start interacting with your Agent.

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

And so much for the tutorial to integrate your Caleida AI Agent into your Slack Workspace. Remember that if you have any questions, you can contact the Caleida team via email <support@caleida.io>.


---

# 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.caleida.io/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.
