Skip to main content
Connect an agent to its own Slack app so members @mention it in a channel to start and steer sessions. One app per agent, per workspace. Connect from the agent’s page in the dashboard (a guided wizard), or over the API: get a manifest, create the Slack app from it, then finalize with the three values Slack shows you. 
// 1. Manifest to create the Slack app from (Create app → From a manifest).
const { manifest, createUrl } = await oc.agents.slackManifest(agentId);

// 2. Finalize with the App ID, Signing Secret, and Bot User OAuth Token.
const slack = await oc.agents.connectSlack(agentId, {
  appId: "A0…",
  signingSecret: "…",
  botToken: "xoxb-…",
});

await oc.agents.getSlack(agentId); // { status: "active", … } — no secrets
await oc.agents.disconnectSlack(agentId); // purge + stop routing
Then invite the bot (/invite @handle) and @mention it.

​
Routing

An @mention is signature-verified, de-duplicated, and appended to a session as a steer. The first mention in a thread starts a session; later mentions in that thread steer the same one. The session’s user-level events post back to the thread — the agent never calls Slack itself.

​
Reconnect

Replacing the app requires explicit intent, so a stray request can’t tear down a live connection: 
await oc.agents.slackManifest(agentId, { reconnect: true });
Calling it on an active connection without reconnect returns 409. A reconnect resets the connection to pending and retires the prior threads’ bindings, so future mentions start fresh.

​
Limits

  • Anyone who can @mention the bot in a channel it has joined can start and steer the agent — there is no per-user or per-channel allow-list yet. Invite it only where you trust the members.
  • Mention-only: it doesn’t passively follow thread replies.
  • Outbound posts user-level events; live progress isn’t streamed into the thread yet.