Skip to main content

Connect a Coworker Agent to Slack

Give an agent its own Slack identity so anyone on the team can hand it work by @-mentioning it in a channel.

Each agent gets its own Slack app — its own name, avatar, and bot identity — rather than sharing one workspace-wide bot. That keeps conversations unambiguous (you mention the specific agent you want) and lets you remove one agent's Slack access without touching the others.

Create the Slack app​

Save a Slack app configuration token once in the Coworker Agents Settings tab, then create each agent's app without copying its credentials. To set up an app without a configuration token, use Create an app manually.

Save a configuration token​

Use an account that can create apps in the Slack workspace. Generate the token as the primary owner or a service account, because apps created with it belong to that account.

  1. Open the Coworker Agents page and select Settings.
  2. Expand Slack app creation.
  3. Follow the link to Slack's app settings.
  4. Under Your App Configuration Tokens, generate a token for the workspace you want to connect.
  5. Copy the Refresh Token, not the access token.
  6. Paste it into Mintive's Refresh token field and click Save.

The setting shows Connected, the workspace, and Created by. Keep the refresh token private; you do not need to paste it again for each agent.

Create and install an agent's app​

  1. Open the agent's Slack settings, or continue to Connect to Slack in the creation dialog.
  2. Click Create Slack app.
  3. In Slack, review the requested permissions and click Allow.

If your workspace requires approval, request it in Slack. Once the app is approved, return to the agent's Slack settings and click Install to finish installing the same app.

Existing apps keep their current configuration. When Reinstall is offered, use it to authorize the app again. Use the manual setup controls to edit an app's credentials.

Replace or remove the configuration token​

If Slack app creation shows Needs a new token, generate another refresh token in Slack and save it in the same setting.

To stop creating new apps with the stored token, click Remove and confirm. Apps already created keep working, and you can save another token later.

Create an app manually​

  1. On the agent's detail page, open its Slack settings.
  2. Click Create New Slack App. This opens Slack's app-creation page with a manifest pre-filled by Mintive — the bot scopes and event subscription are already configured, so you just confirm and create.
  3. Copy the new app's Client ID, Client Secret, and Signing Secret from Slack's app settings and paste them into Mintive.
  4. Click Add to Slack to install the app to your workspace.

To connect an app you already manage, use the manual setup controls in the agent's Slack settings: paste its signing secret and bot token into Mintive, then copy Mintive's event subscription and interactivity URLs into your Slack app's configuration.

Invite the agent to a channel​

The app only receives mentions from channels it's in, so invite it with /invite @agent-name in each channel where people will use it.

Talk to the agent​

Mention the agent with a request:

@bella-billing-agent can you pull the overdue invoices for June and post a summary here?

The agent acknowledges with an eyes reaction right away to confirm it saw the message, then starts a run. It reads the full thread for context, posts progress updates as it works, and replies in the same thread when it finishes. Mentioning the agent again in the same thread reaches the same conversation rather than starting an unrelated run, so follow-ups and corrections work naturally.

The agent can also upload files to the thread and react to messages, so it can deliver reports or artifacts directly in Slack.

Security notes​

  • The Slack app's scopes are limited to what the agent needs: reading mentions and channel history, posting messages, uploading files, adding reactions, and looking up user names.
  • Mintive verifies Slack's request signature before dispatching any run, so forged webhook calls are rejected.
  • Messages from other bots don't trigger the agent unless you explicitly allowlist those bot IDs in the agent's configuration, which prevents two agents from triggering each other in a loop.

Troubleshooting​

  • The agent doesn't respond to mentions: check it's been invited to the channel, and that the agent's Slack settings show the app as installed.
  • The OAuth popup was blocked — use the Copy this link option on the install step and open it in a new tab.
  • The install shows "Pending": finish any required workspace approval, then click Install in the agent's Slack settings.

Next steps​