Slack toma un poco más de clicks que Discord o Telegram, pero el flujo es lineal. Vas a necesitar un workspace de Slack donde tengas permiso para instalar apps.

1. Crear la app

  1. Andá a api.slack.com/appsCreate New AppFrom scratch.
  2. Ponele nombre (ej. el nombre de tu agente).
  3. Elegí tu workspace → Create App.

2. Activar Socket Mode

Socket Mode hace que el bot se conecte por WebSocket — no requiere un endpoint HTTPS público.

  1. Sidebar izquierda → Socket Mode → activá Enable Socket Mode ON.
  2. Cuando te lo pida, creá un App-Level Token con scope connections:write.
  3. Copiá el token — empieza con xapp-…. Guardalo.

3. Agregar scopes del bot

  1. Sidebar izquierda → OAuth & Permissions.
  2. Bajá a Bot Token Scopes, agregá:
    • app_mentions:read
    • chat:write
    • channels:history
    • im:history
    • im:write

4. Activar suscripción a eventos

  1. Sidebar izquierda → Event Subscriptions → activá Enable Events ON.
  2. Bajo Subscribe to bot events, agregá app_mention y message.im.
  3. Save changes.

5. Instalar al workspace

  1. Sidebar izquierda → Install AppInstall to WorkspaceAllow.
  2. Copiá el Bot User OAuth Token — empieza con xoxb-…. Guardalo.

6. Correr sento init

npx sentoagent init

Elegí Slack. Pegá los dos tokens cuando te los pida:

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

Control de acceso

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

{
  "dmPolicy": "allowlist",
  "allowFrom": ["U01ABCD1234"],
  "groups": {
    "C01EFGH5678": { "requireMention": true, "allowFrom": [] }
  }
}
  • allowFrom tiene IDs de usuarios de Slack (empiezan con U).
  • Las claves de groups son IDs de canales (empiezan con C para públicos, G para privados).

Problemas comunes

  • Sin respuesta en DMs: faltan los scopes im:history e im:write. Agregalos y reinstalá la app.
  • Sin respuesta cuando lo mencionás: falta app_mentions:read, o no está suscripto al evento app_mention.
  • Error not_allowed_token_type: pegaste los tokens en el orden equivocado — xapp es el app token, xoxb es el bot token.