Slack channel

Slack takes a bit more clicking than Discord or Telegram, but the flow is linear. You'll need a Slack workspace where you have permission to install apps.

1. Create the app

1. Go to api.slack.com/apps → Create New App → From scratch.
2. Name it (e.g. your agent's name).
3. Pick your workspace → Create App.

2. Enable Socket Mode

Socket Mode lets the bot connect via WebSocket — no public HTTPS endpoint required.

1. Left sidebar → Socket Mode → toggle Enable Socket Mode ON.
2. When prompted, create an App-Level Token with scope connections:write.
3. Copy the token — starts with xapp-…. Save it.

3. Add bot scopes

1. Left sidebar → OAuth & Permissions.
2. Scroll to Bot Token Scopes, add:
   • app_mentions:read
   • chat:write
   • channels:history
   • im:history
   • im:write

4. Enable event subscriptions

1. Left sidebar → Event Subscriptions → toggle Enable Events ON.
2. Under Subscribe to bot events, add app_mention and message.im.
3. Save changes.

5. Install to workspace

1. Left sidebar → Install App → Install to Workspace → Allow.
2. Copy the Bot User OAuth Token — starts with xoxb-…. Save it.

6. Run sento init

npx sentoagent init

Pick Slack. Paste both tokens when prompted:

• SLACK_APP_TOKEN=xapp-…
• SLACK_BOT_TOKEN=xoxb-…

Access control

~/.claude/channels/slack/access.json:

{
  "dmPolicy": "allowlist",
  "allowFrom": ["U01ABCD1234"],
  "groups": {
    "C01EFGH5678": { "requireMention": true, "allowFrom": [] }
  }
}

• allowFrom holds Slack user IDs (start with U).
• groups keys are channel IDs (start with C for public, G for private).

Common gotchas

• No response in DMs: im:history and im:write scopes missing. Add them and reinstall the app.
• No response when mentioned: app_mentions:read missing, or app_mention event not subscribed.
• not_allowed_token_type error: you pasted the tokens in the wrong order — xapp is the app token, xoxb is the bot token.