Slack

Connect your Slack workspace to ORQO so that Doorkeeper can receive and respond to messages, and agents can deliver workflow output to Slack channels and DMs.

Category	Communication
Capabilities	Send + Receive
Adapter path	/slack
Auth method	OAuth 2.0

Prerequisites

• A Slack workspace where you have permission to install apps
• A Slack app created at api.slack.com
• Access to the ORQO Settings area

Setup

1. Create a Slack App

If you don't already have one:

1. Go to api.slack.com/apps and click Create New App.
2. Choose From scratch.
3. Name it (e.g., "ORQO") and select your workspace.
4. Note the Signing Secret from the Basic Information page.

2. Configure Bot Permissions

Under OAuth & Permissions, add these bot token scopes:

• chat:write — Send messages
• channels:read — List public channels
• groups:read — List private channels the bot is in
• im:read — Read DM metadata
• im:write — Send DMs
• im:history — Read DM history (for context)
• users:read — Resolve user information

Install the app to your workspace and copy the Bot User OAuth Token (xoxb-...).

3. Install the Slack App in ORQO

1. Navigate to Settings > Apps in ORQO.
2. Find Slack in the app catalog and click Install.
3. The app is created with the correct adapter URL and capabilities.

4. Add Credentials

After installation, the credentials checklist shows what's needed:

Credential	Type	Value
SLACK_BOT_TOKEN	api_key	Your xoxb-... bot token
SLACK_SIGNING_SECRET	api_key	The signing secret from your Slack app's Basic Information page

Create these credentials in Settings > Credentials if they don't exist, then assign them to the Slack App. The credential dropdown is filtered to show only relevant credentials.

5. Configure Event Subscriptions

In your Slack app settings at api.slack.com:

1. Navigate to Event Subscriptions and enable events.
2. Set the Request URL to your ORQO webhook endpoint:

   https://your-orqo-domain.com/api/v1/webhooks/:app_id

   Replace :app_id with the App ID shown on the Slack app card in ORQO.
3. Slack sends a verification challenge — ORQO handles this automatically.
4. Subscribe to bot events:
   • message.im — Direct messages to the bot
   • message.channels — Messages in channels where the bot is present
   • app_mention — When someone @mentions the bot

6. Add Contacts

For each person who should be able to message ORQO through Slack:

1. Go to Settings > Contacts and create a Contact.
2. Add a Contact Channel linked to the Slack App.
3. Set the channel address to the person's Slack user ID (e.g., U01ABCDEF).

warning

Only registered Contacts can interact with Doorkeeper. Messages from unknown Slack users are silently rejected.

7. Verify the Connection

Click Verify on the Slack app card in ORQO. This tests the connection to the adapter and discovers any MCP tools the Slack adapter provides.

Send a direct message to your Slack bot from a registered Contact. Doorkeeper should respond.

Available Tools

The Slack adapter exposes MCP tools that agents can use in workflows:

Tool	Description
send_slack_message	Send a message to a Slack channel or DM
list_slack_channels	List channels the bot has access to

These tools are discovered automatically when the App is verified and can be assigned to agents via Skills.

Platform-Specific Behavior

• Thread awareness — Replies in Slack threads are threaded correctly. DM conversations persist across messages.
• OAuth 2.0 — Full OAuth authorization flow with automatic token refresh.
• URL verification — Slack's url_verification challenge is handled automatically during webhook setup.
• Signature verification — Every inbound webhook is verified via the X-Slack-Signature header using HMAC-SHA256 with the signing secret.
• Session reset — Send reset, new session, clear session, or start over to clear the conversation and start fresh.

What's Next

• Apps & Channels for the full architecture
• Configure Webhooks for detailed webhook setup
• Doorkeeper AI to understand what Doorkeeper can do