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"

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

Select your workspace, then click "Next"

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

Scroll down 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, white background, or black background

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

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

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"

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"

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

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

Copy the Token generated for use later in the Dropzone UI where it is called "Application 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 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