Slack app

Loma reaches your team in Slack via Socket Mode — no public webhook URL required. Once installed, the agent answers direct messages, channel mentions, and thread replies.

Setup

  1. Create a Slack app at api.slack.com/apps.
  2. Enable Socket Mode.
  3. Create an app-level token with the connections:write scope and set it as SLACK_APP_TOKEN.
  4. Add these bot token scopes:
    • app_mentions:read
    • chat:write
    • channels:history
    • channels:read
    • groups:history
    • im:history
    • im:read
    • im:write
    • files:read
    • reactions:read
    • reactions:write
    • users:read
    • users:read.email
  5. Subscribe to these bot events:
    • app_mention
    • message.im
    • message.channels (needed for Slack-triggered flows in public channels)
    • message.groups (needed for Slack-triggered flows in private channels)
  6. Install the app to your workspace and set the bot token as SLACK_BOT_TOKEN.
  7. Invite the bot to any channels where it should respond to mentions.

Troubleshooting

  • DMs don’t get a response — confirm message.im is subscribed and the bot token has im:write.
  • New scopes don’t take effect — Slack only applies OAuth scope changes after you reinstall the app to the workspace. Updating the scope list without reinstalling leaves the running token under-scoped.