> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atonom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Create a Slack bot from a manifest and connect it to an Atonom Cloud Employee.

Connect a Slack workspace to an Atonom Cloud Employee. Create the Slack app from the manifest below, then paste the bot token into the Cloud Employee's external chat channel.

Microsoft Teams and Google Chat are not covered here.

***

## Create the Slack bot

1. Open [Your Apps](https://api.slack.com/apps) on the Slack API site.
2. Click **Create New App**.
3. Select **From a manifest**.
4. Open the **JSON** editor. Paste the [manifest](#slack-app-manifest). Change both `CHANGE THIS NAME` values to the bot name you want. For an Enterprise Grid app, set `org_deploy_enabled` to `true`. Leave the event request URL as it is in the manifest.
5. Choose the workspace where you want to install the app.
6. Click through the remaining Slack prompts and install the app to the workspace.
7. Open the new app's settings. Go to **App Home**. Under **Show Tabs**, turn on **Messages Tab**. Check **Allow users to send Slash commands and messages from the messages tab**.
8. Go to **OAuth & Permissions**. Under **OAuth Tokens**, copy the **Bot User OAuth Token**. You need this token for the next section.

<Note>
  The bot token is created when the app is installed. If **OAuth Tokens** is empty, install the app to the workspace from the Slack app settings, then copy the token.
</Note>

***

## Link the bot to a Cloud Employee

1. In Atonom, open the Cloud Employee **channel settings**.
2. Open the **external chat** channel.
3. Paste the **Bot User OAuth Token** from the Slack app dashboard and save.

If the token is for an Enterprise Grid app (`org_deploy_enabled` is `true`), pick the workspace you want to enable in that same channel settings page and save again.

***

## Slack app manifest

Replace both `CHANGE THIS NAME` values before you create the app. Set `org_deploy_enabled` to `true` only for an Enterprise Grid app.

```json theme={null}
{
    "display_information": {
        "name": "CHANGE THIS NAME"
    },
    "features": {
        "bot_user": {
            "display_name": "CHANGE THIS NAME",
            "always_online": false
        }
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "users:read.email",
                "app_mentions:read",
                "channels:history",
                "chat:write",
                "groups:history",
                "im:history",
                "im:write",
                "mpim:history",
                "users:read"
            ]
        },
        "pkce_enabled": false
    },
    "settings": {
        "event_subscriptions": {
            "request_url": "https://app.getsignals.ai/api/chatinator/slack-actions",
            "bot_events": [
                "app_mention",
                "message.channels",
                "message.groups",
                "message.im",
                "message.mpim"
            ]
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false,
        "app_level_token_rotation_enabled": false,
        "is_mcp_enabled": false
    }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.