> For the complete documentation index, see [llms.txt](https://docs.1millionbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1millionbot.com/chatbot/channels/slack.md).

# 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. 
* 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.