Slack

The Slack integration connects an agent profile to a bot. Each new Slack conversation launches a separate agent from that profile. The agents start with the profile’s current config but keep independent conversations and histories. Later replies return to the agent for that thread or DM.

Before you start

Agents handling Slack conversations automatically receive send_integration_message unless it is explicitly disabled in the profile’s config. You do not need to add it yourself.

Self-hosting? Set OMNARA_PUBLIC_URL to a public HTTPS origin so Slack can deliver webhooks. Hosted Omnara is already configured.

Connect Slack

Create the Slack App with Omnara

Get a Slack app configuration token from api.slack.com/apps under Your App Configuration Tokens. Omnara uses it to create and configure the Slack app for you.

API
Dashboard

The examples assume the client, $ORG/orgID, and $PROJ/projectID setup from the quickstart. One call creates the app and returns the install link:

omnara profiles slack aprf_3jehcyd5n6a2bfgik7mv4qtrwz \
  --app-name "Release Research" \
  --app-configuration-token "xoxe.xoxp-..."

curl "$OMNARA_API/orgs/$ORG/projects/$PROJ/agent-profiles/aprf_3jehcyd5n6a2bfgik7mv4qtrwz/slack-setup" \
  -H "Authorization: Bearer $OMNARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_name": "Release Research",
    "app_configuration_token": "xoxe.xoxp-..."
  }'

const setup = await sdk.createSlackSetup({
  client,
  path: { orgID, projectID, agentProfileID: 'aprf_3jehcyd5n6a2bfgik7mv4qtrwz' },
  body: {
    app_name: 'Release Research',
    app_configuration_token: 'xoxe.xoxp-...',
  },
})
console.log(setup.data.oauth_url)

{
  "provider": "slack",
  "slack_app_id": "A0919XJRZ3T",
  "oauth_url": "https://slack.com/oauth/v2/authorize?client_id=…&scope=…&state=…",
  "redirect_uri": "https://app.omnara.com/api/integrations/oauth/callback",
  "events_url": "https://app.omnara.com/api/integrations/slack/events",
  "actions_url": "https://app.omnara.com/api/integrations/slack/actions",
  "expires_at": "2026-08-03T21:41:00Z"
}

Open oauth_url within 10 minutes while signed in to Omnara as the user who started setup. Approve the Slack install, and the browser returns to the dashboard. The CLI opens the link in your browser for you; --no-browser prints the authorization URL instead.

Each setup creates a new Slack app, so run it only once for each bot you want.

Use an existing Slack app

If you already have a Slack app, provide its credentials instead. This path is not available in the dashboard:

omnara profiles slack aprf_3jehcyd5n6a2bfgik7mv4qtrwz \
  --client-id "1234567890.0987654321" \
  --client-secret "…" \
  --signing-secret "…"

curl "$OMNARA_API/orgs/$ORG/projects/$PROJ/agent-profiles/aprf_3jehcyd5n6a2bfgik7mv4qtrwz/integration-oauth/setup" \
  -H "Authorization: Bearer $OMNARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "1234567890.0987654321",
    "client_secret": "…",
    "signing_secret": "…"
  }'

const setup = await sdk.createIntegrationOAuthSetup({
  client,
  path: { orgID, projectID, agentProfileID: 'aprf_3jehcyd5n6a2bfgik7mv4qtrwz' },
  body: {
    client_id: '1234567890.0987654321',
    client_secret: '…',
    signing_secret: '…',
  },
})
console.log(setup.data.oauth_url)

Your Slack app must already be configured with Omnara’s event, action, and redirect URLs — the setup response returns them. Then open oauth_url to approve the install; the CLI opens the approval page in your browser and waits until the integration is created. Both setup paths connect one Slack workspace to the profile.

Removing a Slack integration from Omnara keeps its agents and histories, but does not uninstall the app from Slack. Remove it separately in Slack if you are decommissioning the bot.

How Slack conversations map to agents

The first mention in a channel thread launches an agent from the profile. Later replies return to the same agent without another mention.
A DM keeps one persistent agent for the whole conversation.
Messages in other threads are ignored until someone mentions the bot.

Slack messages are attributed to their sender and appear in the same timeline as dashboard activity. Questions and approvals can be answered in Slack or the dashboard; either response resumes the same agent.

Full schema and playground: Create Slack app and OAuth setup · Create integration OAuth setup.

Get started

Agents

Inputs & events

Tools

Machines

Organization

Integrations

Examples

Before you start

Connect Slack

Create the Slack App with Omnara

Use an existing Slack app

How Slack conversations map to agents

​Before you start

​Connect Slack

​Create the Slack App with Omnara

​Use an existing Slack app

​How Slack conversations map to agents

Before you start

Connect Slack

Create the Slack App with Omnara

Use an existing Slack app

How Slack conversations map to agents