Skip to main content
Connects via Socket Mode — no public inbound URL required.

Prerequisites

  1. A Slack app with Socket Mode enabled
  2. An App-Level Token (xapp-...) with connections:write scope
  3. A Bot Token (xoxb-...) with these scopes: chat:write, channels:history, channels:read, users:read, app_mentions:read

Configuration

In ~/.meepagateway/agents/<id>/agent.yaml:
connectors:
  - type: slack
    bot_token: "xoxb-..."
    app_token: "xapp-..."
bot_token
string
required
Slack Bot User OAuth Token (starts with xoxb-).
app_token
string
required
Slack App-Level Token with connections:write scope (starts with xapp-).

Behavior

  • The bot calls auth.test on connect to learn its own user ID and filter self-messages
  • Usernames are resolved from Slack user IDs via users.info and cached in memory
  • Responds to both regular messages and app_mention events
  • Long responses are chunked at Slack’s 4000-character limit
  • Rate limits are handled automatically