Slack App Setup

Deploy your autonomous AI agent into your enterprise Slack Workspace using Socket Mode and Manifest.

⚠️ Notice: Slack App configuration includes granular permissions and event subscriptions. In this guide, follow each recommended step directly as demonstrated.

Create a Slack Workspace to host your agent:
⚠️ You may use an existing workspace, but exercise caution as your agent will be capable of reading and interacting with workspace channels and messages.
If you are following this guide on a smartphone, please log in first via the web portal at Slack Login ↗.
Navigate to the Slack API: Your Apps ↗ dashboard.
Click Create an App.
Select From an app manifest and click Continue.

Copy the complete JSON Manifest configuration below by clicking "📋 Copy Manifest", and paste it into the JSON tab on Slack:

App Manifest (JSON)

{
  "display_information": {
    "name": "AgenticBuildAlong",
    "description": "Full-Powered AI Agent for Agentic Build Along"
  },
  "features": {
    "bot_user": {
      "display_name": "AgenticBuildAlong",
      "always_online": true
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "bookmarks:read",
        "bookmarks:write",
        "channels:history",
        "channels:join",
        "channels:read",
        "chat:write",
        "chat:write.customize",
        "chat:write.public",
        "commands",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "groups:write",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users.profile:read",
        "users:read",
        "users:read.email"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel"
      ]
    },
    "socket_mode_enabled": true
  }
}

Select your target Workspace and click Next.
Review the scopes and features, then click Create.
In your App settings dashboard, scroll down to the App-Level Tokens section and click Generate Token and Scopes.
Provide a Token Name (e.g. AgenticToken), add the connections:write scope, and click Generate.
Copy your App-Level Token (prefixed with xapp-...) using the Copy button, and click Done.

App-Level Token (xapp-...):

⚪ Enter or paste your App-Level Token (xapp-...)

Install to Workspace: On desktop browsers, click Install App in the left sidebar. On smartphone browsers where the button may not be directly reachable, add /install-on-team to the end of the URL in your browser's address bar.
Click Install to <Your Workspace Name>.
Click Allow to grant permissions. Your agent is now installed in your workspace.
Copy the Bot User OAuth Token (starts with xoxb-...) with the Copy button.

Bot User OAuth Token (xoxb-...):

⚪ Enter or paste your Bot User OAuth Token (xoxb-...)

Open Slack in a web browser (not the native app) or visit Slack Web Sign-in ↗ and select your workspace.
On Desktop: Click Admin in the left navigation sidebar → select Manage members.
On Smartphone: Tap the menu button in the top-left corner.
Select Members under the People section (if collapsed, tap the small arrow icon next to People to expand it).
In the Workspace members roster, find your name, click/tap on it, and copy your personal User ID (Member ID) (prefixed with U...).

Your Slack User ID (Member ID: U...):

⚪ Enter or paste your Slack Member ID (starts with U)