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

> Envía notificaciones, escala casos y coordina operaciones en Slack desde tus flujos conversacionales en Brain Studio.

**Slack** es donde los equipos coordinan la operación diaria. A diferencia de integraciones de correo como Gmail (que resuelven comunicación formal y asíncrona), Slack está pensado para reacción interna en tiempo real: el equipo se entera, decide y actúa desde el mismo canal.

En **Brain Studio**, la integración convierte a Slack en el punto de reacción inmediata para tus flujos: escalaciones con contexto, alertas operativas, creación de canales por cliente o proyecto, resúmenes ejecutivos y aprobaciones, siempre en el workspace donde el equipo ya trabaja.

## Qué habilita Slack

Al conectar **Slack**, puedes:

* **Escalar casos al equipo correcto en el acto** — mensajes enriquecidos, threads o Block Kit al canal, grupo o persona adecuada
* **Crear canales para cada cliente, proyecto o incidente** con tema, descripción y miembros preconfigurados
* **Dar visibilidad operativa sin dashboards** — alertas de leads, pagos, errores o hitos que llegan donde el equipo ya conversa
* **Activar aprobaciones y recordatorios** como parte de procesos que requieren validación humana antes de continuar
* **Trabajar sobre usuarios, grupos y archivos** para identificar personas, actualizar membresías o compartir documentos

***

## Instalación

### Requisitos previos

1. Una **cuenta activa de Slack** con acceso al workspace objetivo.
2. Permisos para conectar aplicaciones en tu workspace de Slack.

### Cómo conectarla

La forma más directa es usar [**Jelou Agent**](/guides/getting-started/jelou-agent): describe lo que necesitas y el agente conecta **Slack** automáticamente dentro del flujo.

Si prefieres instalar manualmente, sigue estos pasos en el **Marketplace**. La conexión usa **OAuth de Slack**; no necesitas copiar credenciales.

<Steps>
  <Step title="Abrir el Marketplace">
    En Brain Studio, abre **Marketplace** desde el menú lateral.
  </Step>

  <Step title="Buscar Slack">
    Encuentra la integración y haz clic en **Conectar**.
  </Step>

  <Step title="Autorizar con Slack">
    Completa el flujo de autenticación OAuth con tu cuenta de Slack.
  </Step>

  <Step title="Confirmar instalación">
    La integración aparecerá como **conectada**.

    <Check>
      Puedes usarla en **Canvas** o agregarla como herramienta en **AI Agent**.
    </Check>
  </Step>
</Steps>

***

## Tools disponibles

La integración expone **33 tools** en Brain Studio. Las agrupamos por **tipo de operación en Slack**; los nombres coinciden con los que verás en el producto.

<AccordionGroup>
  <Accordion title="Mensajería y conversación">
    Centraliza el envío, edición y lectura de mensajes dentro de Slack, tanto en canales como en mensajes directos y threads.

    **Tools incluidas**

    * Enviar mensaje
    * Enviar mensaje (Avanzado)
    * Enviar mensaje al canal
    * Enviar mensaje al usuario o al grupo
    * Enviar un mensaje grande (3000+ caracteres)
    * Crea y envía un mensaje de Block Kit
    * Responder a un hilo de mensajes
    * Actualizar mensaje
    * Eliminar mensaje
    * Buscar Mensaje
    * Listar respuestas
    * Agregar reacción con emoji

    **Cuándo usar esta categoría**

    * Cuando el flujo necesita **notificar**, **responder** o **escalar** algo en Slack
    * Cuando quieres enviar mensajes más ricos con **Block Kit** o manejar textos largos sin truncamiento
    * Cuando necesitas trabajar sobre una conversación ya existente, por ejemplo **responder en thread**, **editar** o **eliminar** un mensaje
    * Cuando el agente debe buscar un mensaje previo o reaccionar con emoji como parte de una dinámica interna
  </Accordion>

  <Accordion title="Canales">
    Permite crear, configurar y administrar canales dentro del workspace.

    **Tools incluidas**

    * Listar canales
    * Crear un canal
    * Archivar canal
    * Configurar la descripción del canal
    * Establecer tema del canal
    * Listar miembros en el canal
    * Invitar a un usuario al canal
    * Expulsar usuario

    **Cuándo usar esta categoría**

    * Cuando necesitas **abrir un canal nuevo** para un proyecto, incidente, cliente o squad
    * Cuando quieres mantener actualizado el **topic**, la **descripción** o la **membresía** del canal
    * Cuando el flujo debe orquestar onboarding interno, por ejemplo creando un canal e invitando automáticamente al equipo correcto
    * Cuando necesitas inspeccionar la composición de un canal antes de actuar
  </Accordion>

  <Accordion title="Usuarios y presencia">
    Trabaja sobre usuarios del workspace y sobre el contexto del miembro autenticado.

    **Tools incluidas**

    * Listar usuarios
    * Buscar usuario por correo electrónico
    * Obtener Usuario Actual
    * Actualizar perfil
    * Establecer estado

    **Cuándo usar esta categoría**

    * Cuando el flujo necesita identificar a una persona concreta en Slack antes de enviarle un mensaje o invitarla a un canal
    * Cuando quieres adaptar la lógica al **usuario autenticado**, su perfil o el workspace conectado
    * Cuando necesitas actualizar nombre, título o estado como parte de un proceso interno
    * Cuando el usuario entra por correo y necesitas resolver su identidad en Slack
  </Accordion>

  <Accordion title="Grupos de usuarios">
    Gestiona grupos de usuarios y sus miembros para coordinación interna.

    **Tools incluidas**

    * Listar miembros del grupo
    * Actualizar Miembros del Grupo

    **Cuándo usar esta categoría**

    * Cuando tu operación se organiza por **user groups** y necesitas consultar o actualizar su composición
    * Cuando el flujo debe enrutar comunicación o alertas a grupos funcionales ya definidos
    * Cuando quieres automatizar cambios de membresía en grupos internos según eventos de negocio
  </Accordion>

  <Accordion title="Archivos">
    Permite subir, consultar, listar y eliminar archivos dentro de Slack.

    **Tools incluidas**

    * Subir archivo
    * Obtener archivo
    * Listar Archivos
    * Eliminar Archivo

    **Cuándo usar esta categoría**

    * Cuando el flujo necesita compartir documentos, reportes o evidencias en Slack
    * Cuando quieres consultar o recuperar contexto sobre un archivo ya subido al workspace
    * Cuando el proceso requiere listar archivos recientes o limpiar archivos que ya no deberían seguir disponibles
  </Accordion>

  <Accordion title="Automatización y coordinación interna">
    Soporta recordatorios y mecanismos simples de aprobación dentro de Slack.

    **Tools incluidas**

    * Crear recordatorio
    * Aprobar flujo de trabajo

    **Cuándo usar esta categoría**

    * Cuando quieres que un flujo deje un **recordatorio operativo** a una persona o equipo
    * Cuando necesitas introducir una **aprobación humana** dentro de un proceso automatizado
    * Cuando Slack funciona como capa de coordinación antes de ejecutar una acción sensible en otra integración
  </Accordion>
</AccordionGroup>

***

## Cómo usar en Brain

Una vez conectada, puedes usar **Slack** en dos superficies:

### En AI Agent

Ideal cuando el agente necesita notificar al equipo o buscar un miembro del workspace de forma autónoma durante la conversación.

<Steps>
  <Step title="Abre el nodo AI Agent">
    En el Canvas, selecciona o añade el nodo **AI Agent**.
  </Step>

  <Step title="Abre Herramientas">
    En el panel derecho, entra a la pestaña **Herramientas**.
  </Step>

  <Step title="Agrega Slack">
    Usa **Agregar tool**, busca **Slack** y actívala.
  </Step>

  <Step title="Configura las tools">
    Elige integración completa o activa solo las acciones que necesites.

    <Check>
      **Slack** aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
    </Check>
  </Step>
</Steps>

El agente decidirá automáticamente cuándo enviar un mensaje, buscar un usuario o consultar un canal según el contexto de la conversación.

### En Canvas

Ideal cuando necesitas control total del flujo (por ejemplo: detectar evento → formatear mensaje → enviar notificación al canal responsable).

<Steps>
  <Step title="Arrastra Slack al Canvas">
    En el panel lateral, abre **Marketplace** y arrastra **Slack** al flujo.
  </Step>

  <Step title="Selecciona la tool">
    Con el nodo seleccionado, en **Tools** elige la acción (por ejemplo **Enviar mensaje**).
  </Step>

  <Step title="Configura el cuerpo y la memoria">
    Completa el JSON del cuerpo de la petición y, si aplica, **Guardar respuesta** en una variable de memoria.
  </Step>

  <Step title="Conecta el flujo">
    Enlaza las salidas **Finalizó la tarea** y **Hubo un error** con los nodos siguientes.

    <Check>
      El nodo queda listo para ejecutarse en el orden definido por tu flujo.
    </Check>
  </Step>
</Steps>

**Ejemplo de configuración:**

El editor del nodo muestra un cuerpo JSON alineado con la tool **Enviar mensaje**. Usa `channelId` para canales o `email` para DMs. Los bloques permiten mensajes con formato enriquecido.

```json theme={null}
{
  "channelId": "{{$memory.slack_channel_id}}",
  "text": "Nuevo lead registrado: {{$memory.nombre_cliente}} — {{$memory.empresa}}",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*Nuevo lead registrado*\n*Nombre:* {{$memory.nombre_cliente}}\n*Empresa:* {{$memory.empresa}}\n*Fuente:* WhatsApp"
      }
    }
  ]
}
```

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Escalación de casos desde WhatsApp al equipo interno">
    Cuando una conversación necesita intervención humana, el flujo la escala a Slack con el contexto justo, en el canal correcto y sin copiar ni pegar.

    **Ejemplo concreto:** un cliente de e-commerce pide un reembolso por WhatsApp. El canal no puede procesar reembolsos directamente. El flujo envía un mensaje Block Kit a #soporte-reembolsos con nombre del cliente, monto, número de pedido y extracto de la conversación. El equipo recibe todo el contexto y actúa sin pedir información de vuelta.

    **Ideal para:** equipos de soporte, ventas o incidentes que operan desde canales conversacionales y coordinan en Slack.
  </Accordion>

  <Accordion title="Alertas operativas en tiempo real sin revisar dashboards">
    En lugar de monitorear sistemas, los eventos críticos llegan directamente al canal del equipo responsable.

    **Ejemplo concreto:** una empresa SaaS conecta su flujo de captación a Slack. Cada vez que entra un lead enterprise, el flujo envía una alerta a #leads-enterprise con nombre, empresa, canal de origen y primera intención expresada. El director comercial ve la alerta y asigna al ejecutivo en el mismo hilo.

    **Ideal para:** revenue ops, soporte, operaciones y management que necesitan reacción inmediata ante eventos críticos.
  </Accordion>

  <Accordion title="Creación automática de canales por cliente o proyecto">
    Cada nuevo cliente, proyecto o incidente obtiene su canal de Slack listo para operar, con tema, descripción y miembros invitados automáticamente.

    **Ejemplo concreto:** una agencia de implementación usa Brain Studio para onboarding. Cuando se confirma un nuevo cliente, el flujo crea #cli-nombre-cliente, establece el tema con la fecha de kick-off y el responsable, e invita al equipo de implementación. El canal existe antes de la primera reunión.

    **Ideal para:** agencias, consultoras, customer success y organizaciones que abren canales por cliente o iniciativa.
  </Accordion>

  <Accordion title="Resúmenes ejecutivos sin que nadie arme un reporte">
    En lugar de que el equipo revise múltiples sistemas, el flujo consolida lo importante y lo entrega como resumen periódico en Slack.

    **Ejemplo concreto:** un equipo comercial recibe cada lunes en #ventas-resumen un mensaje con los leads nuevos de la semana, las ofertas que avanzaron de etapa y las reuniones agendadas. El mensaje se arma desde datos de HubSpot, Calendly y el propio flujo. Nadie tuvo que compilar el reporte.

    **Ideal para:** founders, managers y líderes que usan Slack como centro de seguimiento y decisiones.
  </Accordion>
</AccordionGroup>

***

## Integraciones que combinan bien con Slack

<AccordionGroup>
  <Accordion title="HubSpot">
    Cuando un lead calificado entra al CRM o una oferta cambia de etapa, el flujo puede notificar al canal correspondiente en Slack. El equipo comercial se entera del hito sin abrir HubSpot.

    **Flujo combinado:** lead creado en HubSpot → alerta a #ventas en Slack con nombre, empresa y etapa.

    [Documentación de HubSpot](/guides/integraciones/crm/hubspot)
  </Accordion>

  <Accordion title="Salesforce">
    En organizaciones con operaciones complejas en Salesforce, Slack funciona como la superficie de reacción inmediata. Cada oportunidad crítica, caso urgente o cambio relevante en el CRM puede disparar una alerta al canal del equipo responsable.

    **Flujo combinado:** caso urgente creado en Salesforce → alerta a #soporte-urgentes con número de caso y prioridad.

    [Documentación de Salesforce](/guides/integraciones/crm/salesforce)
  </Accordion>

  <Accordion title="Google Calendar">
    Cuando se crea, mueve o cancela una reunión relevante, el flujo puede avisar al canal del equipo para que todos estén al tanto sin revisar la agenda.

    **Flujo combinado:** evento creado en Google Calendar → mensaje a #equipo con fecha, hora y asistentes.

    [Documentación de Google Calendar](/guides/integraciones/agendamiento/google-calendar)
  </Accordion>

  <Accordion title="Supabase">
    Cada inserción o cambio de estado crítico en la base de datos puede convertirse en una alerta operativa en Slack. El equipo técnico o de operaciones reacciona sin monitorear la base directamente.

    **Flujo combinado:** registro actualizado a "error" en Supabase → alerta a #ops-incidentes con tabla, ID y estado.

    [Documentación de Supabase](/guides/integraciones/infraestructura/supabase)
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integraciones" href="/guides/integraciones/integraciones" icon="grid">
    Catálogo de integraciones disponibles en el Marketplace.
  </Card>

  <Card title="Cómo usar integraciones en Brain" href="/guides/integraciones/como-usar-integraciones-en-brain" icon="book-open">
    Flujo general para instalar y usar integraciones en Brain Studio.
  </Card>
</CardGroup>