## Slack Communicator

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.

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"

Select "From a Manifest"

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

Select your workplace

- Input the following manifest, then click "Next"

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

Input the manifest

- Click "Create"

Click "Create"

- In the settings page for your Dropzone SlackBot application, navigate to "Basic Information"

Navigate to "Basic Information"

- Scroll down to "Display Information"

Navigate to "Display Information"

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

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)

- 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

Navigate to "Install App"

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

Click "Allow"

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

Copy the Bot token

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

Generate Token and Scopes

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

Add scope

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

Select "connections:write"

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

Copy the Token

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

Integrations Dropdown

- Click "Available"

Click Available

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

The Slack Communication Tile

- Input the Slack Bot Token and the Application Token

The Slack Communication Configuration

- Click "Test & Save" to finish

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