Slack Communicator

Slack Communicator

The Dropzone platform uses a Slack Communicator Application to communicate directly with people in your organization. For more information, see our Communicators overview.

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 the workplace that you wish to deploy the application in, then click "Next"

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

• Click "Create"

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

• At the bottom, click "Save Changes"

You must install the Slack Application to your organization before it can be used.

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

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"

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"

• 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, do the following:

• Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app

• In the bottom left hand corner, click Settings > Integrations

• Click "Available"

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

• Input the Slack Bot Token and the Application Token

• Click "Test & Save" to finish

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