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

* Select the workplace that you wish to deploy the application in, then click "Next"

<figure><img src="/files/HwaT4c88Fr6xNQHASOSY" alt=""><figcaption><p>Select your workplace</p></figcaption></figure>

* Input the following manifest, then click "Next"

```
{
   "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>

* Click "Create"

<figure><img src="/files/qgKWhOAh8mVocRn7JhEZ" alt=""><figcaption><p>Click "Create"</p></figcaption></figure>

* 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-*`)

### Create 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>

### Create 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 copied earlier| \| Application Token| The Application Token value 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 "Available"

<figure><img src="/files/brI7n2Ux40Tk0jTwBCVh" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

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

* Input the Slack Bot Token and the Application Token

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

* Click "Test & Save" to finish

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