Skip to main content

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
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

1

Abrir la sección Canales

Inicia sesión en Jelou, ve a Canales y selecciona la opción Slack.
2

Nombrar el canal y elegir el proyecto

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.
3

Ingresar las credenciales de la app de Slack

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.
4

Crear y conectar 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.
5

Configurar las Request URLs a mano (solo si falla)

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 SubscriptionsRequest URL
  • Interactivity & ShortcutsRequest URL
Puedes volver a encontrar esta URL en cualquier momento en las propiedades del canal, así que no es necesario guardarla aparte.
6

Verificar la URL de Events si Slack lo pide

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.
7

Construir la lógica en Brain Studio

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:
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: 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.