Módulo 4: Slack

Conectar Slack a n8n

Descripción de la cápsula

Conectar Slack es distinto a conectar Google. Con Sheets, Gmail y Calendar el flujo era "Sign in with Google y aceptar". Slack no funciona así: para que n8n hable con tu workspace, tienes que crear una "app de Slack" — una pequeña aplicación, dentro de Slack, que representa a tu integración.

Suena más complejo de lo que es. No vas a programar nada — vas a llenar un formulario en el sitio de Slack, marcar qué permisos (scopes) necesita tu app, instalarla en tu workspace, y copiar un token a n8n. Es un setup de una sola vez, y entenderlo te da algo valioso: control fino sobre qué puede y qué no puede hacer tu integración.

Esta cápsula te lleva por ese proceso paso a paso, y termina con una credencial funcionando y un mensaje de prueba enviado a un canal.


Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

  • Crear una app de Slack para tu integración con n8n
  • Entender los scopes y elegir los que tu app necesita
  • Instalar la app en tu workspace y obtener el token
  • Crear la credencial de Slack en n8n
  • Enviar un mensaje de prueba a un canal
  • Entender la diferencia entre el token de bot y otros tipos

Por qué Slack es diferente: la "app de Slack"

Con Google, autorizas a n8n a actuar como tú. Con Slack, el modelo es otro: creas una app (una identidad propia, un "bot") que vive en tu workspace. Cuando n8n manda un mensaje, no lo manda "como tú" — lo manda como esa app.

Ventajas de este modelo:

  • El bot aparece con su propio nombre y avatar (Asistente n8n, no tu nombre personal)
  • Controlas exactamente qué permisos tiene (puede escribir en canales pero no borrar mensajes, por ejemplo)
  • Si algo sale mal, desinstalas la app sin tocar tu cuenta personal

El "precio" es el setup inicial. Vale la pena.


Paso a paso: crear la app de Slack

Paso A: Ir al panel de apps de Slack

  1. Entra a api.slack.com/apps
  2. Click en Create New App
  3. Elige From scratch (desde cero)
  4. Dale un nombre (Asistente n8n) y elige tu workspace

Ya tienes una app — vacía, sin permisos todavía.

Paso B: Darle permisos (scopes)

Aquí decides qué puede hacer tu app. En el panel de la app:

  1. Ve a OAuth & Permissions
  2. Busca la sección Scopes → Bot Token Scopes
  3. Agrega los scopes que tu integración va a necesitar

Los scopes básicos para empezar (enviar mensajes y trabajar con canales/usuarios):

ScopePermite
chat:writeEnviar mensajes
channels:readVer la lista de canales públicos
users:readVer la lista de usuarios
channels:historyLeer mensajes de canales (si vas a recibir eventos)

Principio: pide solo lo que necesitas. Si tu workflow solo manda notificaciones, chat:write y channels:read bastan. Cada scope extra es permiso que tu app no necesitaba. Siempre puedes agregar más scopes después (reinstalando la app).

Paso C: Instalar la app en el workspace

  1. En la misma página de OAuth & Permissions, arriba, click en Install to Workspace
  2. Slack te muestra qué permisos pide la app → Allow
  3. Al volver, aparece un Bot User OAuth Token — empieza con xoxb-...

Ese token xoxb-... es la "llave" que n8n va a usar. Cópialo.

El token xoxb- es el Bot Token — la identidad de tu app. Hay otros tipos de token en Slack (de usuario, de app-level), pero para el caso normal de n8n, el Bot Token es el que usas. Trátalo como una contraseña: quien lo tenga puede actuar como tu app.


Paso a paso: crear la credencial en n8n

Paso 1: Agregar la credencial

  1. En n8n → CredentialsAdd credential
  2. Busca Slack
  3. Selecciona Slack API (la opción de token; también existe Slack OAuth2, pero el token de bot es lo más directo)
  4. Pega el Bot Token (xoxb-...)
  5. Nombra la credencial: Slack - workspace negocio

Paso 2: Invitar al bot al canal

Detalle clave que confunde a todos: tu app no puede escribir en un canal hasta que la inviten a ese canal. Tener chat:write no es suficiente — el bot tiene que ser miembro del canal.

En Slack, en el canal donde quieres que escriba:

  • Escribe /invite @Asistente n8n (el nombre de tu app)
  • O ve a los detalles del canal → Integraciones → agregar app

Hazlo en al menos un canal de prueba antes de seguir.


Paso a paso: mensaje de prueba

El workflow

  1. Workflow nuevo → Manual Trigger
  2. Agrega un nodo Slack
  3. Credential: la que acabas de crear
  4. Resource: Message
  5. Operation: Send
  6. Send Message To: Channel
  7. Channel: elige el canal de prueba (donde invitaste al bot)
  8. Message Text: Hola desde n8n 👋

Ejecutar

Click en Test step. Mira el canal en Slack. Si aparece el mensaje, enviado por Asistente n8n: la conexión funciona.

Si da un error de not_in_channel → el bot no fue invitado a ese canal (volver al paso anterior). Si da missing_scope → falta un scope (volver al Paso B y reinstalar).


Trampas comunes

Trampa 1: El bot no fue invitado al canal

Qué pasa: Error not_in_channel. La credencial está bien, el scope está bien, pero el bot no es miembro del canal.

Cómo evitar: /invite @tu-app en cada canal donde el bot deba escribir. Tener el scope no equivale a tener acceso al canal.


Trampa 2: Faltan scopes

Qué pasa: Error missing_scope. Tu app intenta algo (leer usuarios, escribir) para lo que no le diste permiso.

Cómo evitar: Agrega el scope que falta en OAuth & Permissions y reinstala la app (los scopes nuevos no aplican hasta reinstalar).


Trampa 3: Confundir el Bot Token con otros tokens

Qué pasa: Copias un token que no es el xoxb-... (un token de usuario, un client secret) y la credencial no funciona como esperas.

Cómo evitar: Para el caso normal de n8n, usa el Bot User OAuth Token que empieza con xoxb-.


Trampa 4: Reinstalar y olvidar actualizar el token

Qué pasa: Cambias scopes, reinstalas la app, pero sigues usando el token viejo en n8n.

Cómo evitar: Después de reinstalar, verifica si el token cambió y actualízalo en la credencial de n8n.


Trampa 5: Exponer el token

Qué pasa: Pegas el xoxb-... en un mensaje, un repo, un screenshot. Cualquiera que lo vea puede actuar como tu app.

Cómo evitar: Trátalo como una contraseña. Si se filtra, en el panel de la app puedes revocar y regenerar el token.


Ejercicio: crea la app y envía

Objetivo: terminar con una app de Slack instalada, una credencial en n8n y un mensaje enviado.

Tu tarea

  1. Crea una app de Slack Asistente n8n en api.slack.com/apps
  2. Agrégale los scopes chat:write y channels:read
  3. Instálala en tu workspace y copia el Bot Token (xoxb-...)
  4. Crea la credencial Slack API en n8n con ese token
  5. Crea un canal de prueba #pruebas-n8n e invita al bot con /invite
  6. Construye Manual Trigger → Slack (Send) y manda un mensaje al canal

Checklist de éxito:

  • La app de Slack existe y está instalada en tu workspace
  • El bot tiene al menos chat:write y channels:read
  • El bot fue invitado al canal de prueba
  • El mensaje aparece en el canal, enviado por el bot

Resumen y siguiente paso

  • Slack no usa "Sign in" como Google — hay que crear una app de Slack que representa tu integración
  • La app es un bot con identidad propia (nombre, avatar) y permisos controlados — tú decides exactamente qué puede hacer
  • Los scopes definen qué puede la app — pide solo los que necesitas (chat:write, channels:read para empezar)
  • Tras instalar la app, copias el Bot Token (xoxb-...) a la credencial de n8n
  • Detalle clave: el bot debe ser invitado a cada canal donde escriba — tener el scope no basta
  • 5 trampas: bot no invitado, faltan scopes, token equivocado, no actualizar token tras reinstalar, exponer el token

Antes de avanzar deberías poder:

  • Crear e instalar una app de Slack
  • Explicar qué son los scopes y por qué pedir solo lo necesario
  • Invitar el bot a un canal y enviar un mensaje

Lo que sigue (cápsula 03):

Ya conectado, profundizamos en la operación dominante: enviar mensajes. A canales públicos y privados, a personas por mensaje directo, y cómo componer el contenido del mensaje con datos del workflow.


Recursos adicionales

  1. Slack API: crear apps - Guía oficial de creación de apps.
  2. Slack: scopes de bot - Lista completa de scopes y qué permite cada uno.
  3. n8n Slack Credentials Docs - Setup de la credencial en n8n.

Creado: Mayo 14, 2026 Versión: 1.0