# Slack

{% embed url="<https://www.loom.com/share/866db333d2cf4bfaada3d49a1d415477?sid=1aab8361-54ae-41f2-81e8-af2fe2f8c9b8>" %}

1. Log in to [Dashboard](https://orimon.ai/login) -> navigate to the overview page of the bot that you want to change.
2. On the overview page, you will see several tabs. Look for the one labelled "Launch" and click on it.

<figure><img src="/files/78Vke399BhS8XtzzAuPM" alt=""><figcaption></figcaption></figure>

3. Select the "Slack" tab. Click on the "**Enable**" switch to enable the integration.

<figure><img src="/files/79DFkJRInXb8ZcB23fuw" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important Note:** *Please note that you must <mark style="color:blue;">**sign-in**</mark> to your slack workspace where you wish to integrate your OrimonAI chat-bot, before proceeding further. A link for doing the same is provided on the Integration page as well as* [*here*](https://slack.com/signin#/signin)*.*\
\
*You need to create a Slack workspace,* [*here*](https://slack.com/get-started#/createnew) *in-case you don't have one.*
{% endhint %}

4. Now scroll down to see 2 dialog boxes as shown below.

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

**Bot Name:** Here you can set the name you want for you bot ***in Slack***, according to your preference.

**Event Name:** This is the event in Slack that your bot will respond to, which can be one of 2 configurations.

* **App Mention:** Configuring your bot to this event type, ensures that your chat-bot in Slack is only invoked/triggered, if it is directly mentioned by typing its command (@\<bot-name>).
* **Message:** Configuring your bot to this event type, ensures that your chat-bot responds and reads to every message in your channel/workspace, without the need to directly mention it.

5. Once, you configure your Bot Name & Event Name, click on "**Get Started**". Then you will see a page as shown below.

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

Now click on, "**Add To Slack**" to begin the integration process, after which you will be redirected to Slack's Official Website, and a dialog box will open up as shown below.

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

6. Select the workspace where you want to integrate your bot and click on "**Next**". After this Slack will ask you to authorize the App.

<figure><img src="/files/tsL8P7b0ld7nvRNGYz0X" alt="" width="418"><figcaption></figcaption></figure>

7. Click on "**Create**", after which you will be redirected to the App's page & prompted to add this App to your Workspace by clicking "**Add To Workspace**".
8. After this, you'll see a screen as shown below, click on  "**Allow**".

<figure><img src="/files/SEqpuO3GEJDsXXIrDzuS" alt="" width="457"><figcaption></figcaption></figure>

{% embed url="<https://www.loom.com/share/acd387cc3b6a4aedbd0e3757b38c939a?sid=d8faa0a5-352c-43eb-9060-eff2c1c55f06>" %}

9. Now, on the left panel go to "**Event Subscriptions**" where you will see a configuration as shown below.

<figure><img src="/files/e40h3euQFr2njLvbrSys" alt="" width="563"><figcaption></figcaption></figure>

Here in the **Request URL** you will be a  button "**Retry**", click on this button and then click on "**Save Changes**".

10. After this navigate back to the Slack Integration page on your OrimonAI dashboard, where you will see a configuration as shown below. Click on "**Verify Event URL**"

<figure><img src="/files/S0vZeuS66qNvcEoS10c1" alt="" width="563"><figcaption></figcaption></figure>

11. As soon as your, Event URL is verified a new dialog box will show up as follows.

<figure><img src="/files/IxKp5tFZZ5isebq8y1P1" alt="" width="563"><figcaption></figcaption></figure>

12. To proceed further, go back to the Slack API page of your App, navigate to **Oauth & Permissions** under the section **OAuth Tokens for Your Workspace**, copy the token provided, as shown below and paste it on the **Bot Token** dialog box on your dashboard, then click on "**Connect To Slack**".
13. If the installation process of your bot has been followed correctly, you will see a configuration screen on your dashboard as shown below.

<figure><img src="/files/8URNPoGKnpdmsIVpzfd6" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.loom.com/share/d753718625d4413e9d32562c30e895c7?sid=846472a8-f90a-48b9-ae49-b5a2450bacc2>" %}

That's all for Integrating your chat-bot with Slack!


---

# 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://orimon.gitbook.io/docs/channels/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.