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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dropzone.ai/integrations/communicator/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.