> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/agentic-commerce-intelligence/agentic-intelligence/configuration/tools/slack.md).

# Slack AI Tool

A prime example of AI Tools is the Slack tool, which enables collaboration with the Emporix Support Agent within a Slack workspace. Configuration of the Slack tool allows the **Emporix Support Agent** bot to be installed in the selected workspace. Once it's done, your team can interact with the Emporix system directly in the context-aware Slack channels. For instance, they can inquire about orders, returns, or product updates, right where your team communicates with each other. This functionality fosters seamless collaboration and reduces the need to switch between different applications.

## Configuring Slack tool

There are two ways of configuring a Slack tool depending on your setup: automatic and manual.

{% stepper %}
{% step %}

#### Choose to add new tool

In the **Agentic AI** -> **AI Tools**, choose **Add new tool**.
{% endstep %}

{% step %}

#### Choose the way to install the Slack tool

In the creation form, the **Tool Type** is already prefilled with `slack`. Configure Slack automatically or manually, depending on your requirements.

{% hint style="success" %}
As the automatic method of configuration fetches the necessary details for you, it is the simplest and recommended way for Slack tool installation.
{% endhint %}

* Automatic configuration

  Select the **Add to Slack** to install Emporix Slack AI automatically.

  <figure><img src="/files/szBrwohk11qMTXYAdKKF" alt="Add Slack Tool"><figcaption><p>Add Slack Tool</p></figcaption></figure>

  You are taken to the Slack authorization page. Select the workspace to install the Emporix Support Agent bot and confirm the decision. The configuration happens in the background and you are redirected back to the **AI Tools** view in the Management Dashboard. All the details are already filled in for you.

  <figure><img src="/files/2ojfefAcEvLFZvCZNKDA" alt="Slack tool installed" width="300"><figcaption><p>Slack Tool Installed</p></figcaption></figure>
* Manual configuration

  Use the manual configuration option when you already have the Slack bot installed in your workspace and you want to connect it with Emporix. Fill in the tool basic configuration details in the **General** tab, such as **Tool ID** and **Tool Name**. In the **Settings** tab, provide the details specific to Slack integration:

  * **Team ID** – The unique identifier of the Slack workspace
  * **Bot Token** – The token associated with the Slack tool

  <figure><img src="/files/bKN2H8FRy0DubLy22zzM" alt="Manual configuration"><figcaption><p>Slack manual configuration</p></figcaption></figure>

  Providing these values manually makes it possible to link the Emporix Support Agent with your existing bot setup, without a new installation requirement.

  The **Bot Token** gets encrypted and is never exposed.
  {% endstep %}

{% step %}
**Check Slack bot installation**

Navigate to your Slack workspace and verify that the Emporix Support Agent is available. Once the Complaint Agent or Anti-Fraud Agent creates the context for a specific case, you are able to call the Support Agent in Slack to inquire about the relevant details.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Best practices for AI Slack tool**

* Use the automatic "one-click" installation whenever possible for the easiest setup and convenience. This approach handles everything for you - no need to copy tokens or IDs.
* If you manage Slack in a highly controlled environment, manual configuration might be more appropriate as it provides more flexibility.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/agentic-commerce-intelligence/agentic-intelligence/configuration/tools/slack.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.