Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Slack Socket Mode

Slack is configured in custom/conf/protocols/slack.yaml.

Minimal shape:

ProtocolConfig:
  AppToken: xapp-{{ decrypt "<slack-app-token>" }}
  BotToken: xoxb-{{ decrypt "<slack-bot-token>" }}
  HearSelf: false
  UserMap:
    alice: U12345678

Notes

  • UserMap is connector-local in v3. It does not belong in robot.yaml.
  • The engine still makes authorization decisions by canonical username, not by Slack user ID.
  • Slash commands arrive as hidden bot-addressed messages, so hidden commands still have to be explicitly allowed by the plugin.

If Slack is your primary protocol, set it in custom/conf/environments/<environment>.yaml or directly in custom/conf/robot.yaml, depending on how you structure your environments.