# Slack

## Set up

To set up your assistant integration in Slack, you'll need the following:

* A Slack account with access to the Workspace where you will install the assistant.&#x20;
* Space to add new applications to your Workspace.

### Create a Slack app

1. Access the a la [Slack developer console](https://api.slack.com/apps).
2. Click on 'Create New App' and select the 'From Scratch' option.
3. Enter a name for your application and choose a workspace.Enter a name for your application and choose a workspace.
4. Click 'Create App'.

### Set permissions

1. Access the **App Home** menu section to add the permissions list.
2. Click 'Review Scopes to Add'.<img src="/files/9lLmr3rXzaBNArMspa6m" alt="" data-size="original">
3. In the Scopes module click 'Add an OAuth Scope' under Bot Token Scopes. ![](/files/cT4zviJAZw3GEsUiEnXR)
4. Select at least the following permissions:\
   \- *chat:write*\
   \- *im:history*\
   \- *im:read*\
   \- *im:write*
5. Next, we go back to the **App Home** section and in the **Show Tabs** module we will activate the 'Messages Tab' option along with the 'Allow users to send Slash commands and messages from the messages tab' permission.\
   ![](/files/fPmKBY4V9cDKBl5B0Wjr)

### Activate integration

1. Access the **Event Subscriptions** menu section and enable the use of events.
2. Copy the URL that you will find in the integration options and paste it into 'Request URL' in the **Enable Events** section.\
   \
   ![](/files/J2eJqgKH85S33TiU8haa)\
   ![](/files/SXgTOI8rsmAS5ypQGERy)
3. In the same section, in the **Subscribe to bot events** section, click on 'Add Bot User Event' and add the *message.im* event to enable the reception of messages.
4. Go to the **Interactivity & Shortcuts** menu section and insert the same URL that you copied in step 2.\
   ![](/files/NIIlTsqUhtGRb4kVjPoU)
5. Access the **Install App** menu section, click on 'Install to Workspace' and copy the token generated in 'Bot User OAuth Token'.\
   ![](/files/QiTDONjaMivyvaQkOAQ4)
6. Finally, insert the necessary data for the integration into the platform:\
   \- *Bot User OAuth Token*: The token generated through the **Install App** section.\
   \- *Signing Secret*: Token that verifies the origin of the requests, it is found in the **Basic Information** section of the menu.\
   ![](/files/eTFWcPv33IvPfEIcO9uD)\
   ![](/files/V6bUMyGVrLwuwFoRmdMR)
7. Done!:tada: Run tests to verify the functionality of your assistant in your Slack account.

## Limitations

* Only 1 message can be sent per second.


---

# 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.1millionbot.com/chatbot/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.
