PostgreSQL New Row
PostgreSQL New Row es un componente de inicio: pone en marcha el flujo cuando aparecen filas nuevas en una tabla de tu base de datos PostgreSQL (también Supabase o Neon), por ejemplo un pedido, un ticket de soporte o un alta de cliente. No hace falta crear triggers ni webhooks en la base de datos: una vez activado, NappAI consulta la tabla cada cierto tiempo, en modo de solo lectura, y ejecuta el flujo con las filas añadidas desde la consulta anterior.
Cuándo usarlo
- Cada ticket nuevo de la tabla de soporte debe clasificarse con un agente y avisar al equipo.
- Cada pedido que tu tienda guarda en PostgreSQL debe enviarse a otro sistema o a una hoja de cálculo.
- Quieres reaccionar a las altas de clientes de una aplicación propia sin tocar su código.
Configuración
Necesitas una credencial Postgres SQL con permiso de lectura sobre la tabla y su esquema. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Postgres SQL de tu base de datos. |
| Table (obligatorio) | La tabla que se vigila, por ejemplo pedidos. |
| Cursor Column (obligatorio) | Una columna cuyo valor solo crece: un id de tipo serial o identity, o una fecha de alta como creado_en. NappAI recuerda el último valor visto y en cada consulta pide los mayores. Por defecto, id. |
| Filter | Una condición opcional para vigilar solo algunas filas, con la misma forma que el filtro del componente Postgres: estado = 'pendiente' AND total > 100. Los textos van entre comillas simples; admite IS NULL, IS NOT NULL y LIKE 'A%', pero no paréntesis ni SQL libre. |
| Data | Sirve para probar el componente: pega aquí un ejemplo de lo que llega y ejecuta el flujo para ver el resultado. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Schema | El esquema donde está la tabla. Por defecto, public. |
| Max Rows per Run | Cuántas filas como máximo llegan en cada ejecución (1–500, por defecto 50). Las demás llegan en las consultas siguientes. |
| Process Existing Rows | Si lo activas, también se procesan las filas que ya había en la tabla al activar el disparador. Desactivado (por defecto), solo las que se añadan desde entonces. |
| Check Every (seconds) | Cada cuántos segundos se consulta la tabla (de 60 a 86.400; por defecto 60). |
Activar el disparador
- Despliega una versión del flujo. Ver Versiones y publicación.
- En el componente, debajo de sus campos, pulsa Activar. Se abre la ventana Acceso a API en la pestaña Disparadores de elementos nuevos.
- Pulsa Activar. NappAI se conecta a la base de datos, comprueba que la tabla, la columna y el filtro existen y anota el último valor actual. Si algo no cuadra, el aviso dice qué.
- La pestaña muestra si el disparador está Escuchando, el último valor visto, la última consulta y, si las hay, las consultas fallidas seguidas con su motivo. Si cambias la tabla, la columna o el filtro del componente, aparece como Desincronizado: pulsa Actualizar. Para dejar de escuchar, pulsa Desactivar.
Resultado
La salida Data devuelve un elemento por cada fila nueva, con sus columnas como campos ({id}, {asunto}, {cliente_email}…). Las fechas llegan en formato ISO. Todas las filas nuevas de una consulta llegan en una sola ejecución, como una lista, y los componentes siguientes las procesan una a una.
Ejemplo
Un equipo de soporte quiere que cada ticket nuevo se clasifique solo.
- Añade PostgreSQL New Row con la credencial de la base de datos, Table en
tickets_soporte, Cursor Column enidy Filter enestado = 'abierto'. - Conecta Data a un agente que lea
{asunto}y{mensaje}y proponga una categoría, y este a un componente Postgres que la guarde. - Despliega el flujo y actívalo desde el componente.
Buenas prácticas
- Usa como cursor el
idserialoidentitysiempre que exista: es el más fiable. Una columna de fecha de modificación (actualizado_en) también vale, pero entonces el flujo salta también cuando se edita una fila. - Varias filas con la misma fecha no se pierden ni se repiten: NappAI recuerda cuáles de ese instante ya entregó.
- Una columna que no crece (un UUID aleatorio, un nombre) no sirve como cursor y se rechaza al activar.
- Si la base de datos no responde, el disparador espera cada vez más entre intentos (hasta una hora) y lo muestra en la pestaña.
Seguridad
- La transacción se abre en solo lectura y con un tiempo máximo por consulta (
statement_timeout): el disparador no puede modificar la base de datos. - El filtro no se pega en la consulta: se interpreta y cada valor viaja aparte, así que no admite inyección de SQL.
- Usa una credencial con un usuario que solo tenga permiso de lectura sobre las tablas que vigilas.
Componentes relacionados
- MySQL New Row: lo mismo para MySQL.
- Postgres: lee y escribe filas de PostgreSQL.
- RSS New Item y HTTP New Item: elementos nuevos de un feed o de una API.