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

# Slack Communicator

## Slack Communicator

{% hint style="info" %}
Slack is a Communicator Integration. Communicator Integrations allow the Dropzone platform to ask questions of your employee base and use their responses to improve the quality of analysis.
{% endhint %}

The Dropzone platform uses a Slack Communicator Application to communicate directly with people in your organization.

### Integrations Overview

To enable these integrations you will perform the following actions:

* Create and install a Slack Application with the necessary permissions
* Obtain an Application and Slack Token

### Create a Slack Application

* Navigate to <https://api.slack.com/apps>
* Click "Create New App"
* Select "From a manifest"

<figure><img src="/files/4wI70W1U0Nm2t7npsxu6" alt=""><figcaption><p>Select "From a Manifest"</p></figcaption></figure>

* Input the following JSON manifest

```
{
   "display_information": {
       "name": "DropzoneAI"
   },
   "features": {
       "app_home": {
           "home_tab_enabled": false,
           "messages_tab_enabled": true,
           "messages_tab_read_only_enabled": false
       },
       "bot_user": {
           "display_name": "DropzoneAI",
           "always_online": true
       }
   },
   "oauth_config": {
       "scopes": {
           "bot": [
               "channels:manage",
               "channels:read",
               "chat:write",
               "im:history",
               "im:read",
               "im:write",
               "users:read",
               "users:read.email",
               "channels:history"
           ]
       }
   },
   "settings": {
       "event_subscriptions": {
           "bot_events": [
               "message.im"
           ]
       },
       "interactivity": {
           "is_enabled": true
       },
       "org_deploy_enabled": false,
       "socket_mode_enabled": true,
       "token_rotation_enabled": false
   }
}
```

<figure><img src="/files/bVGbKwOWKsMVeEgfsqZN" alt=""><figcaption><p>Input the manifest</p></figcaption></figure>

* Select your workspace, then click "Next"

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

* Click "Create & Install"
* In the settings page for your Dropzone SlackBot application, navigate to "Basic Information"

<figure><img src="/files/WpN8PeB8UBhKX2rgupsL" alt=""><figcaption><p>Navigate to "Basic Information"</p></figcaption></figure>

* Scroll down to "Display Information"

<figure><img src="/files/gwNdgVHYLVEUwykITvYz" alt=""><figcaption><p>Navigate to "Display Information"</p></figcaption></figure>

* Change the App name to something you will remember, such as "DropzoneAI"

{% hint style="info" %}
Should you wish, we've provided Dropzone icons that you can use here: [transparent](https://go.dropzone.ai/img/logos/logomark-transparent-color.png), [white background](https://go.dropzone.ai/img/logos/logomark-blue-on-white.png), or [black background](https://go.dropzone.ai/img/logos/logomark-blue-on-black.png)
{% endhint %}

* At the bottom, click "Save Changes"

You must install the Slack Application to your organization before it can be used. To do so, do the following:

* Navigate to Settings > Install App

<figure><img src="/files/mj4fMCk9z1L2vJagquQJ" alt=""><figcaption><p>Navigate to "Install App"</p></figcaption></figure>

* Click "Install to \[your workspace name]"
* To grant the application permission to access the workspace, click "Allow"

<figure><img src="/files/0Thcg43LonIzc08d5lT8" alt=""><figcaption><p>Click "Allow"</p></figcaption></figure>

## Create API Tokens

Slack Communicator requires two tokens: a Bot token (`xoxb-*`) and an App token (`x-app-*`)

### Bot Token

To obtain a Bot token, do the following:

* Navigate to Settings > Install App
* Copy the value under "Bot User Auth Token" for use later in the Dropzone UI where it is called "Slack Bot Token"

<figure><img src="/files/G1uGBtwNMuSrwTWueBQA" alt=""><figcaption><p>Copy the Bot token</p></figcaption></figure>

### App Token

To obtain an App token, do the following:

* Navigate to Settings > Basic Information
* Scroll down to App-Level Tokens and click "Generate Token and Scopes"

<figure><img src="/files/Uc8MvREsh5wwSQwQwOpK" alt=""><figcaption><p>Generate Token and Scopes</p></figcaption></figure>

* Name your token something memorable, such as "DropzoneAI"
* Click "Add Scope"

<figure><img src="/files/2CbedxHaeINupSeuwqTu" alt=""><figcaption><p>Add scope</p></figcaption></figure>

* Select the scope "connections:write"
* Click "Generate"

<figure><img src="/files/go5FAHZMXcpN4HLQzi4t" alt=""><figcaption><p>Select "connections:write"</p></figcaption></figure>

* Copy the Token generated for use later in the Dropzone UI where it is called "Application Token"

<figure><img src="/files/tyIGkD2krGgiRo0CzoMe" alt=""><figcaption><p>Copy the Token</p></figcaption></figure>

### Enable Slack Communicator

To enable Slack Communicator, you'll need the following information:

| Dropzone Field    | Source                                         |
| ----------------- | ---------------------------------------------- |
| Slack Bot Token   | The Slack Bot Token value you copied earlier   |
| Application Token | The Application Token value you copied earlier |

To enable the Slack Communicator integration, do the following:

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the bottom left hand corner, navigate to Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="/files/QySQeLXXUC5SLjaXyamH" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search Slack, then click "Configure"

<figure><img src="/files/7ARZUJOGVgvN3WVDX1rj" alt=""><figcaption><p>The Slack Communicator tile</p></figcaption></figure>

* Input the Slack Bot Token and the Application Token

<figure><img src="/files/sJJ0hjGrL0maNDCtUwFn" alt=""><figcaption><p>The Slack Communicator Configuration</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.