Saltar al contenido principal

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.

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

  1. Un proyecto de Supabase activo (hosted) con las tablas y funciones que vayas a usar.
  2. Los dos valores que pide el modal de Brain Studio, coherentes con ese proyecto:
    • Supabase url
    • Api Key
  3. 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.
1

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

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

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

Abrir el Marketplace

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

Buscar Supabase

Encuentra la integración y haz clic en Conectar.
3

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

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.
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:
{}
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"
}
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
}
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"
  }
}
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"
  }
}
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"
  }
}
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.
1

Abre el nodo AI Agent

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

Abre Herramientas

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

Agrega Supabase

Usa Agregar tool, busca Supabase y actívala.
4

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

Arrastra Supabase al Canvas

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

Selecciona la tool

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

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

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

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

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

​
Artículos relacionados

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.