Slack Communicator

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"

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

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.