Supabase

Supabase es una plataforma backend open-source construida sobre PostgreSQL que permite gestionar bases de datos, autenticación y funciones desde una sola interfaz. A diferencia de integraciones con CRMs o ERPs (que trabajan sobre modelos predefinidos), Supabase conecta Brain Studio directamente con tus propias tablas y funciones, respetando las políticas de acceso y la lógica que ya definiste en la base. En Brain Studio, la integración permite que tus flujos consulten datos, inserten y actualicen registros, y ejecuten funciones RPC desde la conversación. El control sigue en Supabase: permisos, RLS y lógica centralizada.

Qué habilita Supabase

Al conectar Supabase, puedes:

Responder con datos reales de tu base — consultar tablas con filtros para que el agente no invente ni pida información que ya existe
Registrar eventos del negocio en el momento — insertar filas cuando la conversación genera un lead, pedido, solicitud o cualquier hecho relevante
Actualizar estados operativos — cambiar columnas (estado de pedido, etapa de onboarding, resultado de verificación) según lo que ocurre en el flujo
Ejecutar lógica de negocio centralizada — llamar funciones RPC de PostgreSQL para cálculos, validaciones o transacciones que no deben vivir en el flujo
Explorar estructura antes de operar — listar tablas y revisar columnas para que el agente sepa dónde escribir

Instalación

Requisitos previos

Un proyecto de Supabase activo (hosted) con las tablas y funciones que vayas a usar.
Los dos valores que pide el modal de Brain Studio, coherentes con ese proyecto:
- Supabase url
- Api Key
Políticas RLS (Row Level Security) y permisos alineados con lo que el flujo debe poder hacer con la clave que configures.

Cómo obtener credenciales

Para conectar Supabase en Brain Studio necesitas dos datos del proyecto:

Supabase url — la URL del proyecto, también mostrada por Supabase como Project URL
Api Key — una clave pública de acceso al API del proyecto

En el dashboard de Supabase, abre tu proyecto y ve a Settings → API o API Keys.

Copia la Supabase url

Busca la Project URL de tu proyecto (por ejemplo https://<tu-proyecto>.supabase.co) y pégala en el campo Supabase url de Brain Studio.

Copia la Api Key correcta

Usa una clave de bajo privilegio, asociada al acceso público del proyecto:

anon public key si tu proyecto usa las claves heredadas
Publishable key (sb_publishable_...) si tu proyecto ya usa el esquema nuevo de claves

Ese valor va en el campo Api Key del modal de instalación.

No uses la service_role ni una secret key en esta integración. Esas claves tienen privilegios elevados, pueden saltarse políticas RLS y no deben exponerse en flujos conversacionales.

Verifica permisos y RLS

Antes de conectar en producción, revisa que las políticas RLS y permisos del proyecto permitan exactamente las operaciones que tu flujo necesita ejecutar.

Con Supabase url y Api Key ya puedes completar el modal de conexión de Supabase en Brain Studio.

Cómo conectarla

La forma más directa es usar Jelou Agent: describe lo que necesitas y el agente conecta Supabase automáticamente dentro del flujo. Si prefieres instalar manualmente, abre el Marketplace y sigue estos pasos con la URL y API Key que obtuviste en el paso anterior.

Abrir el Marketplace

En Brain Studio, abre Marketplace desde el menú lateral.

Buscar Supabase

Encuentra la integración y haz clic en Conectar.

Completar Supabase url y Api Key

Pega la Supabase url (Project URL) y la Api Key (anon o Publishable, nunca service_role ni secret key para este uso).

Confirmar instalación

La integración aparecerá como conectada.

Puedes usarla en Canvas o agregarla como herramienta en AI Agent.

Tools disponibles

La integración expone 7 tools en Brain Studio. Los nombres coinciden con los del editor de nodos. Los JSON son orientativos: confirma siempre los campos exactos en el panel de la tool.

Listar tablas

Enumera las tablas del proyecto. Úsala al inicio de un flujo o cuando el agente deba confirmar sobre qué tablas puede actuar.Inputs en prosa: según el editor del nodo (a menudo sin cuerpo o objeto vacío).Ejemplo orientativo:

{}

Describir Tabla

Devuelve la estructura de una tabla (columnas, tipos, restricciones relevantes). Úsala antes de insertar o actualizar para no fallar por tipos u obligatoriedad.Inputs en prosa: nombre de la tabla; valida el identificador exacto en el editor.Ejemplo orientativo:

{
  "table_name": "customers"
}

Tabla de consultas

Lee filas con filtros y límite. Es la herramienta base para responder con datos o ramificar según lo guardado en Supabase.Inputs en prosa: tabla; filtros (igualdad u otros operadores si el editor los ofrece); límite opcional.Ejemplo orientativo:

{
  "table_name": "orders",
  "filters": {
    "status": "paid"
  },
  "limit": 25
}

Insertar Fila

Crea un registro nuevo. Encaja con altas desde el chat (leads, eventos, filas de hechos).Inputs en prosa: tabla y objeto data con columnas y valores.Ejemplo orientativo:

{
  "table_name": "leads",
  "data": {
    "name": "Ana Pérez",
    "email": "[email protected]",
    "source": "whatsapp"
  }
}

Actualizar fila

Modifica filas que cumplan los filtros. Encaja con cambios de estado o correcciones tras validar con el usuario.Inputs en prosa: tabla; filtros que seleccionen el registro; data con campos a actualizar.Ejemplo orientativo:

{
  "table_name": "orders",
  "filters": {
    "id": "ord_987"
  },
  "data": {
    "status": "fulfilled"
  }
}

Eliminar fila

Elimina filas que cumplan los filtros. Operación destructiva: úsala solo con criterios muy acotados y, si puedes, delega borrados sensibles en una RPC con comprobaciones adicionales.Inputs en prosa: tabla y filtros; revisa operadores disponibles en el editor.

Un filtro demasiado amplio puede borrar más filas de las previstas. Prueba primero en entornos de desarrollo y revisa políticas RLS.

Ejemplo orientativo:

{
  "table_name": "draft_sessions",
  "filters": {
    "session_id": "sess_tmp_001"
  }
}

Llamar a la función RPC

Ejecuta una función PostgreSQL expuesta como RPC en Supabase. Centraliza lógica de negocio (cálculos, validaciones, transacciones) en la base.Inputs en prosa: nombre de función y parámetros según la firma en PostgreSQL.Ejemplo orientativo:

{
  "function_name": "get_customer_summary",
  "parameters": {
    "customer_id": "cst_123"
  }
}

Cómo usar en Brain

En Supabase, lo normal es usar AI Agent cuando el flujo debe decidir dinámicamente qué consultar o actualizar, y Canvas cuando el proceso sigue una secuencia fija, por ejemplo: consultar registro → validar estado → actualizar fila → notificar.

En AI Agent

Úsalo cuando la conversación sea abierta: el usuario puede pedir datos, registrar algo o disparar una función sin un guion fijo. El agente elige la tool dentro del subconjunto que habilites.

Abre el nodo AI Agent

En el Canvas, selecciona o añade el nodo AI Agent.

Abre Herramientas

En el panel derecho, entra a la pestaña Herramientas.

Agrega Supabase

Usa Agregar tool, busca Supabase y actívala.

Configura las tools

Limita acciones sensibles (por ejemplo sin Eliminar fila en agentes públicos).

Supabase aparece en la lista de herramientas del agente; ajusta desde el icono de ajustes de la integración.

En Canvas

Úsalo cuando el proceso sea determinista: por ejemplo listar tablas → describir → consultar → ramificar → insertar o actualizar, con validaciones explícitas entre nodos.

Arrastra Supabase al Canvas

En el panel lateral, abre Marketplace y arrastra Supabase al flujo.

Selecciona la tool

Con el nodo seleccionado, en Tools elige la acción (por ejemplo Tabla de consultas o Insertar Fila).

Configura el cuerpo y la memoria

Completa el JSON en el editor del nodo y Guardar respuesta en memoria cuando el siguiente paso dependa del resultado.

Conecta el flujo

Enlaza Finalizó la tarea y Hubo un error con la lógica de negocio o mensajes al usuario.

Cada nodo ejecuta una sola tool; el orden del Canvas define tu proceso.

Ejemplo orientativo para Insertar Fila (ajusta nombres de columnas y memoria a tu flujo):

{
  "table_name": "leads",
  "data": {
    "name": "{{$memory.nombre}}",
    "email": "{{$memory.correo}}",
    "source": "whatsapp"
  }
}

Casos de uso

Captación de leads y registros directamente en tu base

Cuando un prospecto, solicitud o evento relevante ocurre en la conversación, el flujo lo persiste en Supabase al instante. No hay API intermedia ni integración adicional: los datos van directo a tus tablas.Ejemplo concreto: un SaaS que capta leads por WhatsApp. El prospecto se identifica y muestra interés. El flujo valida los datos mínimos e inserta una fila en la tabla leads con nombre, email y canal de origen. El equipo comercial lo encuentra en su dashboard al momento.Ideal para: productos digitales, startups y equipos que usan Supabase como base principal y no quieren duplicar datos en otro sistema.

Conversaciones personalizadas con datos del usuario

En lugar de pedir información que ya existe, el flujo consulta Supabase antes de responder. Si el usuario ya tiene pedidos, un plan activo o un proceso en curso, el agente lo sabe antes de hablar.Ejemplo concreto: un e-commerce con soporte por WhatsApp. El cliente pregunta “¿dónde está mi pedido?”. El flujo consulta la tabla orders filtrando por email, encuentra el pedido más reciente y responde con estado, fecha estimada y número de seguimiento. El cliente no tuvo que dar ningún dato que ya estaba en la base.Ideal para: SaaS, e-commerce, onboarding y cualquier flujo donde el contexto del usuario mejora la calidad de la respuesta.

Cambios de estado operativo desde la conversación

Cuando el usuario confirma una acción — aceptar una propuesta, completar un paso de onboarding, aprobar un ticket — el flujo actualiza la columna correspondiente en Supabase. El estado del sistema refleja lo que realmente pasó.Ejemplo concreto: una plataforma de logística con confirmación por WhatsApp. El repartidor confirma la entrega. El flujo actualiza el campo status del pedido a “entregado” en Supabase. El dashboard del operador y las notificaciones automáticas se actualizan al instante.Ideal para: operaciones, fulfillment, customer success y procesos internos con estados transaccionales.

Lógica de negocio centralizada con funciones RPC

Para cálculos, validaciones complejas o transacciones que involucran varias tablas, la lógica debe vivir en PostgreSQL, no en el flujo. El flujo llama a la función RPC y usa el resultado para responder, decidir o continuar.Ejemplo concreto: una fintech que calcula elegibilidad crediticia. El flujo llama a get_credit_score con el ID del usuario. PostgreSQL ejecuta la lógica (consulta historial, calcula score, verifica restricciones) y devuelve el resultado. El agente responde al usuario con la decisión, sin exponer la lógica en el flujo.Ideal para: fintech, scoring, pricing, validaciones complejas y productos con lógica fuerte en PostgreSQL.

Integraciones que combinan bien con Supabase

Slack

Cada vez que un registro crítico se crea o cambia de estado en Supabase, el flujo puede notificar al canal correspondiente en Slack. El equipo se entera del evento sin monitorear la base.Flujo combinado: nuevo lead insertado en Supabase → alerta a #ventas en Slack con nombre y canal de origen.Documentación de Slack

Gmail

Después de insertar o actualizar un registro en Supabase, el flujo puede enviar un correo transaccional al usuario: confirmación de registro, cambio de estado, próximos pasos. Los datos del correo salen directamente de la fila que acabas de escribir.Flujo combinado: pedido actualizado a “enviado” en Supabase → correo al cliente con número de seguimiento.Documentación de Gmail

Google Sheets

Para reporting, revisión manual o compartir datos con stakeholders que no tienen acceso a Supabase, el flujo puede exportar consultas a una hoja compartida sin exponer la base directamente.Flujo combinado: consultar métricas de la semana en Supabase → actualizar hoja de indicadores en Sheets.Documentación de Google Sheets

HubSpot

Cuando Supabase guarda la operación del producto (actividad, uso, onboarding) y HubSpot gestiona el ciclo comercial, el flujo puede pasar hitos del backend al CRM para que ventas o customer success trabaje con contexto real.Flujo combinado: usuario completa onboarding en Supabase → actualizar contacto en HubSpot con fecha de activación y plan.Documentación de HubSpot

Integraciones

Catálogo de integraciones disponibles en el Marketplace.

Cómo usar integraciones en Brain

Flujo general para instalar y usar integraciones en Brain Studio.

Empezando

Desarrollador

Jelou CLI

Mensajería Outbound

Gestión

Marketplace

Canales

Configuración

Facturación

Qué habilita Supabase

Instalación

Requisitos previos

Cómo obtener credenciales

Cómo conectarla

Tools disponibles

Cómo usar en Brain

En AI Agent

En Canvas

Casos de uso

Integraciones que combinan bien con Supabase

Artículos relacionados

Integraciones

Cómo usar integraciones en Brain

​Qué habilita Supabase

​Instalación

​Requisitos previos

​Cómo obtener credenciales

​Cómo conectarla

​Tools disponibles

​Cómo usar en Brain

​En AI Agent

​En Canvas

​Casos de uso

​Integraciones que combinan bien con Supabase

​Artículos relacionados

Integraciones

Cómo usar integraciones en Brain

Qué habilita Supabase

Instalación

Requisitos previos

Cómo obtener credenciales

Cómo conectarla

Tools disponibles

Cómo usar en Brain

En AI Agent

En Canvas

Casos de uso

Integraciones que combinan bien con Supabase

Artículos relacionados