Enable an AI Worker in Slack

This guide walks you through setting up a Slack App and connecting it to an AI Worker in EverWorker, so that users in your Slack workspace can interact with the AI Worker directly from Slack.

Note: Slack-enabled AI Workers are part of a new generation of AI Workers, currently available under the Labs menu in EverWorker.

Prerequisites

Before you begin, make sure you have:

• Access to a Slack workspace where you can create and install apps (you need to be a workspace admin, or have permission to install apps)
• An EverWorker account with access to the Labs features
• An AI Worker already created in EverWorker that you want to enable in Slack

Part 1: Create and Configure the Slack App

Step 1 — Create a New App in Slack

1. Go to the Slack API portal and click Create New App.
2. Choose From an app manifest (recommended) or From scratch.
3. Select the workspace where the app will be installed.
4. Give your app a name (e.g., the name of your AI Worker).

Tip: If you choose From an app manifest, you can paste a pre-configured manifest to skip several manual configuration steps. See the Example App Manifest section at the end of this guide. You should replace the "https://cloud.everworker.ai/" with your URL.

Step 2 — Generate an App-Level Token

1. On your app's Basic Information page, scroll down to the App-Level Tokens section.
2. Click Generate Token and Scopes.
3. Give the token a name (e.g., socket-token).
4. Add the following scopes:
   • connections:write
   • authorizations:read
   • app_configurations:write
5. Click Generate.
6. Copy and save the token — you will need it later when configuring the EverWorker connector.

Important: Also note the Signing Secret on this same Basic Information page — you will need it for the EverWorker connector configuration.

Step 3 — Enable Socket Mode

1. In the left sidebar, go to Socket Mode.
2. Toggle Enable Socket Mode to On.

Step 4 — Configure Event Subscriptions

Important: Do NOT set a Request URL. It is not needed because EverWorker uses Socket Mode (WebSocket connections) instead of HTTP callbacks.

1. In the left sidebar, go to Event Subscriptions.

2. Toggle Enable Events to On.

3. Click Subscribe to bot events to expand the section.

4. Add at least the following bot events:

   

Step 5 — Configure Bot Token Scopes (OAuth & Permissions)

1. In the left sidebar, go to OAuth & Permissions.
2. Scroll down to the Scopes section.
3. Under Bot Token Scopes (not User Token Scopes), add at least the following scopes:

Note: Depending on your use case, you may need to add/delete scopes. The list above covers the most common scenarios for an AI Worker interacting in channels and direct messages.

Step 6 — Configure the App Home

1. In the left sidebar, go to App Home.
2. Enable the Messages Tab (also called Chat Tab).
3. Check the box Allow users to send Slash commands and messages from the messages tab.

This step ensures that users can send direct messages to your app from its App Home in Slack.

Step 7 — Install the App to Your Workspace

1. In the left sidebar, go to Install App.
2. Click Install to Workspace (or Reinstall to Workspace if you have previously installed it).
3. Review the permissions and click Allow.
4. After installation, copy the Bot User OAuth Token (starts with xoxb-) — you will need it for the EverWorker connector.

⚠️Important: Every time you make a significant change to your app's configuration (adding scopes, changing events, etc.), you need to reinstall the app to your workspace for the changes to take effect.

Part 2: Connect the Slack App to EverWorker

Step 8 — Create a Slack Connector in EverWorker

1. In EverWorker, go to the Connectors section.
2. Create a new Slack connector.
3. Fill in the following fields using the values from your Slack App:

Step 9 — Enable Slack on Your AI Worker

1. Open your AI Worker (new ones, under Labs) in the EverWorker builder.
2. In the Knowledge section enable the Slack integration toggle inside of the AI Worker configuration and assign the Slack connector you just created to the AI Worker.
3. In the Skills section toggle the Slack Api.

Your AI Worker is now connected to Slack. Users in your workspace can interact with it by:

• Direct messaging the app from its App Home
• @mentioning the app in any channel it has been added to

Troubleshooting

Example App Manifest

Below is an example Slack App manifest that pre-configures the required settings. You can use it when creating your app via From an app manifest to skip manual configuration.

{
    "display_information": {
        "name": "EverWorker",
        "description": "I answer Everworker questions using the official documentation and codebase.",
        "background_color": "#1F2937",
        "long_description": "I can help you by:\r\n\r\n- Answering Everworker questions (how features work, how to use/configure them)\r\nTroubleshooting issues by checking the docs and source code\r\n- Drafting quick internal guides/snippets (steps, checklists, messages, templates)"
    },
    "features": {
        "app_home": {
            "home_tab_enabled": true,
            "messages_tab_enabled": false,
            "messages_tab_read_only_enabled": false
        },
        "bot_user": {
            "display_name": "EverWorker",
            "always_online": true
        },
        "slash_commands": [
            {
                "command": "/everworker",
                "url": "https://cloud.everworker.ai/slack/commands",
                "description": "Talk to EverworkerBot",
                "usage_hint": "help | status | run <task>",
                "should_escape": false
            }
        ]
    },
    "oauth_config": {
        "redirect_urls": [
            "https://cloud.everworker.ai/slack/callback"
        ],
        "scopes": {
            "bot": [
                "app_mentions:read",
                "assistant:write",
                "channels:history",
                "channels:join",
                "channels:read",
                "chat:write",
                "chat:write.public",
                "commands",
                "files:read",
                "files:write",
                "groups:history",
                "groups:read",
                "groups:write",
                "im:history",
                "im:read",
                "im:write",
                "im:write.topic",
                "incoming-webhook",
                "links:read",
                "links:write",
                "mpim:history",
                "mpim:read",
                "mpim:write",
                "mpim:write.topic",
                "users.profile:read",
                "users:read",
                "users:read.email"
            ]
        },
        "pkce_enabled": false
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "app_mention",
                "link_shared",
                "message.channels",
                "message.groups",
                "message.im",
                "message.mpim"
            ]
        },
        "interactivity": {
            "is_enabled": true,
            "request_url": "https://cloud.everworker.ai/slack/interactive"
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
    }
}

Note: After creating an app from a manifest, you still need to generate the App-Level Token (Step 2) and install the app to your workspace (Step 7) manually