Applied LabsDocs
Skip to Content

Slack Agent Installs

Install Slack per agent when you want separate Slack bot identities in the same workspace.

Install model

Applied supports one shared Slack app and any number of custom agent apps.

  • Applied Labs app — reserved for the singleton Applied Assistant agent. If the Assistant does not exist yet, Applied provisions it during Slack authorization and binds the install to that Assistant.
  • Custom agent app — required for every other sandbox agent. The generated Slack manifest uses the agent name for the Slack app name and a Slack-safe version of the agent name for the bot display name.

Each Slack install is owned by one Applied agent. In one Slack workspace, you can install the Applied Labs app for the Assistant and separate custom apps for other agents, then mention each bot independently.

Channel and DM behavior

Invite the app to each public or private channel where it should respond.

  • In channels, mention the bot, for example @Applied, @AgentA, or @AgentB. Applied replies in the same Slack thread.
  • In direct messages, message the bot from Slack. Applied replies in the DM without creating a Slack thread.

Private channels work after the app is invited to the channel.

Create a custom Slack app for an agent

  1. Open the agent in Applied.
  2. Go to Settings -> Integrations.
  3. Click Create app in the Slack section.
  4. Copy the generated Slack manifest.
  5. In Slack, create a new app from the manifest.
  6. Copy the Slack app’s App ID, Client ID, Client Secret, and Signing Secret into Applied.
  7. Continue to Slack and approve the installation.
  8. Invite the app to the Slack channels where the agent should respond.

Generated manifest

The generated custom app manifest includes:

  • App Home Messages tab enabled for direct messages.
  • A bot user display name based on the agent name.
  • Event subscriptions for app_mention, message.channels, message.groups, message.im, and reaction_added.
  • Bot scopes: chat:write, app_mentions:read, channels:history, channels:join, channels:read, emoji:read, groups:history, im:history, im:read, im:write, reactions:read, users:read, users:read.email, files:read, and files:write.

The shared Applied Labs app uses Applied-managed credentials and includes the hosted app scopes needed for the Assistant install, including chat:write.customize, groups:read, and team:read.

Verify

After installation, the agent’s Settings -> Integrations page shows the Slack install status and workspace. In Slack, mention the bot in a channel or send it a direct message to confirm the response routes to the expected agent.

Last updated on
Help Center Custom CSSManaging Agent Versions