Skip to main content

Slack

The Slack integration lets your Youkore agents reply in your workspace's channels and DMs without exposing public webhooks (it uses Socket Mode).

Setup (~5 minutes)​

1. Create the Slack app​

Go to api.slack.com/apps → Create New App → From scratch. Pick a name (e.g. "Youkore") and your workspace.

2. Enable Socket Mode​

In Settings → Socket Mode flip it on. You'll be asked to generate an App-Level Token with the connections:write scope. Copy the token (starts with xapp-).

3. Configure OAuth scopes​

In OAuth & Permissions → Bot Token Scopes add:

  • chat:write — send messages
  • channels:history, groups:history — read channels (when invited)
  • im:history, mpim:history — read DMs
  • app_mentions:read — receive mentions
  • users:read — resolve user IDs to names
  • channels:read, groups:read — list channels
  • reactions:write, files:write, users.profile:write

4. Subscribe to events​

In Event Subscriptions flip it on. Under Subscribe to bot events add:

  • message.channels, message.groups, message.im, message.mpim
  • app_mention

5. Install to workspace​

In Settings → Install App → Install to Workspace → authorize. Copy the Bot User OAuth Token (starts with xoxb-).

6. Paste tokens into Youkore​

Open Youkore → Settings → Integrations → Slack → paste both tokens (xapp- and xoxb-) → Connect.

7. Invite the bot to channels​

For each channel you want the agent in, type /invite @youkore (or whatever name you picked).

What you can do​

  • DM the bot — the agent replies
  • @bot mentions in invited channels
  • slack(action="send|history|search|react|...", ...) tool for proactive actions

Notes for free workspaces​

Slack's free tier limits message history to 90 days; this affects slack(action="search") and slack(action="history").

Troubleshooting​

Bot doesn't reply to mentions: make sure OAuth scopes were saved and you re-installed the app after changing scopes.

"not_in_channel" error: invite the bot with /invite @name.