Supabase

Supabase conecta tu flujo con la base de datos de tu proyecto de Supabase. Con él puedes añadir registros a una tabla, consultarlos con filtros, modificarlos, eliminarlos y ejecutar las funciones que hayas creado en tu base de datos.

Es útil cuando tu aplicación guarda sus datos en Supabase y quieres que un flujo los lea o los actualice: registrar los datos de un formulario, consultar el estado de un pedido o lanzar un cálculo que ya tienes programado como función.

Cuándo usarlo

• Quieres guardar en una tabla cada contacto que llega por el formulario de tu web.
• Un agente de IA atiende a clientes y necesita consultar sus datos en tu base de datos.
• Quieres marcar como atendidas las solicitudes que un flujo ha procesado.
• Quieres borrar cada noche los registros temporales que ya no sirven.
• Tienes una función en Supabase que calcula un informe y quieres ejecutarla desde un flujo.

Configuración

Necesitas una credencial Supabase API con la dirección de tu proyecto (Supabase URL) y su clave secreta de servicio (service role). Las dos están en los ajustes de tu proyecto de Supabase, en el apartado de la API. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Supabase API de tu proyecto.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, Insert.
Table Name (obligatorio)	Solo en Insert, Get, Update y Delete. La tabla con la que trabajar. La lista se carga al elegir la credencial.
Function (obligatorio)	Solo en Custom API Call. La función de tu base de datos que quieres ejecutar. La lista se carga al elegir la credencial.
Limit	Solo en Get. Cuántos registros traer como máximo, hasta 1000. Por defecto, 100.
Select Filter Type	Solo en Get, Update y Delete. Cómo escribes el filtro que elige los registros: String (en una línea de texto) o Build Manually (condición a condición). Por defecto, String.
Filter String	Con String. El filtro en una línea, por ejemplo estado = activo, edad > 44 o email = like.%@empresa.com. Admite los signos =, >, <, >=, <= y !=. Obligatorio en Update y Delete; en Get, si lo dejas vacío se traen registros sin filtrar.
Filters	Con Build Manually. Cuántas condiciones quieres crear. En Update y Delete aparece como Select Condition. Por cada condición aparecen Field Name (la columna), Condition (eq igual, neq distinto, gt mayor, lt menor, gte mayor o igual, lte menor o igual, like e ilike contiene el texto, o sigue tu patrón si el valor lleva % (por ejemplo %@empresa.com; ilike sin distinguir mayúsculas), is y in uno de varios valores) y Field Value (el valor).
Field to Send (obligatorio)	Solo en Update. Cuántas columnas quieres cambiar. Por cada una aparecen Column Name (la columna) y Field Value (el valor nuevo).

Al elegir una tabla en Insert, aparece un campo por cada columna, con su nombre y su tipo de dato, por ejemplo email (text). Rellena los que quieras guardar; los que dejes vacíos no se envían y las columnas que se numeran solas se rellenan automáticamente.

Al elegir una función en Custom API Call, aparece un campo por cada dato que la función necesita, con su nombre y su tipo.

Operaciones

Operación	Qué hace
Insert	Añade un registro a la tabla con los valores de los campos de columna.
Get	Trae los registros de la tabla que cumplen el filtro. Si no hay ninguno, la ejecución da un error.
Update	Cambia las columnas elegidas en los registros que cumplen el filtro.
Delete	Elimina los registros que cumplen el filtro. Si no se elimina ninguno, la ejecución da un error.
Custom API Call	Ejecuta una función de tu base de datos con los datos que indiques y devuelve su resultado.

Resultado

La salida Data devuelve los registros con los que has trabajado, con sus columnas: los añadidos en Insert, los encontrados en Get, los modificados en Update y los eliminados en Delete. En Custom API Call devuelve lo que responda la función.

Puedes conectar el resultado a un agente, a una hoja de cálculo o a un correo. El componente también se puede conectar a un Agente como herramienta, para que el agente consulte o guarde datos cuando lo necesite. Ver Tool Mode.

Ejemplo

Una academia guarda en Supabase las solicitudes de información de su web.

1. El formulario de la web llega al flujo con el nombre, el correo y el curso que interesa.
2. Añade Supabase con la operación Insert y la credencial Supabase API de la academia.
3. En Table Name elige la tabla solicitudes.
4. Conecta el nombre, el correo y el curso a sus campos de columna, por ejemplo nombre (text), email (text) y curso (text).
5. Más adelante, otro flujo con la operación Get y el filtro estado = pendiente trae las solicitudes que faltan por atender.

Buenas prácticas

• Prueba antes el filtro de Update y Delete con la operación Get: así compruebas qué registros se van a cambiar o eliminar.
• La clave de servicio da acceso completo a tu base de datos. Guárdala solo en la credencial y no la compartas.