> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack
> Activa y configura el canal de Slack para conectar tu agente de Brain Studio al espacio de trabajo de tu equipo.
## Introducción
El canal **Slack** conecta tu agente de Brain Studio a Slack para que tu equipo y tus clientes reciban respuestas rápidas y personalizadas por mensaje directo, sin salir de su espacio de trabajo.
La conexión se hace a través de una **app de Slack** que tú creas en tu workspace. Jelou recibe los eventos y las interacciones desde Slack, ejecuta el flujo publicado y devuelve las respuestas del agente al mismo chat.
El canal opera únicamente sobre **mensajes directos** con el bot. No responde en canales públicos ni privados del workspace.
## Requisitos previos
Antes de activar el canal, asegúrate de tener:
* Una cuenta activa en Jelou y acceso a la sección **Canales**
* Una **app de Slack** creada en tu workspace, con estos datos a la mano:
* **Bot User OAuth Token** (empieza con `xoxb-`), en *OAuth & Permissions*
* **Signing Secret**, en *Basic Information*
* **App ID**, en *Basic Information*
* Un **token de configuración de la app** (empieza con `xoxe.xoxp-`), que se genera en la [página de configuración de apps de Slack](https://api.slack.com/apps)
Si no ves la opción de Slack en la lista de canales, tu plan no la incluye. Contacta con tu administrador o con el equipo de soporte de Jelou.
## Activar el canal
Inicia sesión en Jelou, ve a **Canales** y selecciona la opción **Slack**.
Asigna un nombre descriptivo, por ejemplo `Slack - Soporte interno`. El nombre debe tener entre 4 y 50 caracteres.
Luego selecciona el **proyecto** de Brain Studio al que se conectará el canal.
Usa un nombre que identifique el entorno además del canal, por ejemplo `Slack - RRHH Producción`, para distinguirlo con facilidad en el listado.
En el segundo paso del modal completa los cuatro campos, todos obligatorios:
* **Bot User OAuth Token**: el token del bot que empieza con `xoxb-`
* **Signing Secret**: el Signing Secret de *Basic Information*
* **App ID**: el App ID de *Basic Information*
* **Token de configuración de la app**: el token que empieza con `xoxe.xoxp-`
Si dejas un campo vacío, el formulario lo marca en rojo con el mensaje *Este valor es obligatorio* y el botón de creación permanece deshabilitado.
El token de configuración se usa **una sola vez** para establecer las Request URLs de tu app y **no se guarda**. Expira alrededor de 12 horas después de generarlo, así que genéralo justo antes de activar el canal.
Pulsa **Crear y conectar canal**. Jelou crea el canal, configura las Request URLs en tu app de Slack y muestra la **Request URL** resultante.
Si el token de configuración fue aceptado, verás la confirmación de que las Request URLs de **Events** e **Interactivity** quedaron establecidas en tu app. No tienes que hacer nada más del lado de Slack.
Slack entrega los eventos y las interacciones a la **misma** ruta, por lo que una sola URL sirve para ambos campos.
Si la configuración automática falla, el canal ya quedó creado y el modal te muestra la URL para que la pegues tú. Copia la URL y pégala en los dos campos de tu app de Slack:
* **Event Subscriptions** → *Request URL*
* **Interactivity & Shortcuts** → *Request URL*
Puedes volver a encontrar esta URL en cualquier momento en las propiedades del canal, así que no es necesario guardarla aparte.
En algunos casos Slack necesita una verificación manual. Si el modal muestra ese aviso, abre **Event Subscriptions** en tu app de Slack y pulsa **Verify** una vez para activar la URL de Events.
Abre el proyecto en Brain Studio, selecciona el canal **Slack** en el listado de workflows y comienza a construir tu flujo.
## Propiedades del canal
Una vez creado el canal, sus propiedades muestran:
| Campo | Descripción |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **App ID de Slack** | El App ID que ingresaste al activar el canal |
| **Bot User ID** | El id de usuario del propio bot en Slack. Jelou lo resuelve automáticamente desde el bot token y lo usa para ignorar los mensajes del propio bot |
| **Bot User OAuth Token** | Enmascarado y no copiable |
| **Signing Secret** | Enmascarado y no copiable |
| **Request URL** | La URL a la que tu app de Slack envía eventos e interacciones, con botón para copiarla |
El bot token y el Signing Secret se guardan encriptados y no se vuelven a mostrar. Para reemplazarlos hay que crear el canal de nuevo.
## Contenido soportado
El canal de Slack admite un subconjunto de los bloques disponibles en WhatsApp:
| Bloque | Disponible | Límite |
| ------- | ---------- | ---------------------- |
| Texto | Sí | 3000 caracteres |
| Imagen | Sí | JPEG y PNG, hasta 5 MB |
| Botones | Sí | Máximo 10 por mensaje |
| Lista | Sí | Máximo 10 opciones |
| CTA URL | Sí | Se envía como enlace |
Otros límites que aplica el canal:
* **Caption de multimedia**: 3000 caracteres
* **Cuerpo de mensajes con botones**: 3000 caracteres
* **Nombre de archivo**: 255 caracteres
* **Mensaje de opción no encontrada**: 250 caracteres
## Limitaciones del canal
En el builder, algunos nodos y herramientas no están disponibles en el canal **Slack** porque dependen de WhatsApp u otras integraciones.
### Nodos y bloques no disponibles
* Plantilla HSM
* WhatsApp Flows
* Video
* Audio
* Documento y Archivo
* Sticker
* Carrusel
* Lista numerada
* Webview
* Ubicación
* Contacto
* Respuestas rápidas
* Pagos
* Connect (asesor)
* Biometría
* Transferencia a humano (HubSpot, Genesys u otros)
### Herramientas del Agente IA no disponibles
* Call to action (`send_call_to_action`)
* Transferir a asesor (`transfer_to_agent`)
* Jelou Shop
## Próximos pasos
Una vez conectado el canal:
1. Envía un mensaje directo al bot desde Slack para verificar la conexión
2. Revisa los logs de ejecución en Brain Studio para confirmar que el flujo se ejecuta
3. Ajusta el flujo con los bloques soportados por el canal
Prueba el canal con un usuario real de tu workspace antes de publicarlo, para confirmar que las Request URLs de Events e Interactivity quedaron bien configuradas.