Bloques de lógica y acción
Estas son las máquinas de tu línea de montaje: ocho tipos de bloques que clasifican, enrutan, transforman y actúan sobre los datos siguiendo reglas exactas — y ninguno usa créditos jamás. Siempre que un trabajo no necesite criterio de verdad, uno de estos lo hace gratis.
La mayoría comparte el mismo constructor de reglas: eliges un valor (normalmente una {{variable}}), una operación (es igual a, contiene, mayor que…) y con qué compararlo — como configurar una regla en tu app de correo ("si el asunto contiene 'factura'…").
Explora la biblioteca — haz clic en un bloque para ver su panel de configuración real:
Condición — la bifurcación en el camino
Hace una pregunta de sí/no y toma uno de dos caminos.
| Ajuste | Ejemplo |
|---|---|
| Reglas | {{trigger.amount}} mayor que 1000 |
| Si es verdadero → | "Avisar al líder de ventas" |
| Si es falso → | "Guardar para el resumen semanal" |
Filtro — el colador
Toma una lista de elementos y conserva solo los que cumplen tus reglas. Si no sobrevive nada, esa rama de la ejecución simplemente termina — en silencio y sin costo.
| Ajuste | Ejemplo |
|---|---|
| Entrada | La lista del disparador o de un paso anterior |
| Reglas | {{item.status}} es igual a open y {{item.priority}} es igual a high |
Ejemplo: un disparador de app entrega 40 tickets actualizados; el filtro conserva los 3 que están abiertos y en prioridad alta, y solo esos continúan.
Selector — el clasificador de correo
Como una condición con más de dos casillas: la primera regla que coincide gana y envía la ejecución por su camino; un camino de respaldo atrapa todo lo demás. El uso clásico: justo después de un disparador de app Todos los eventos, clasificando cada tipo de evento hacia su propio camino.
| Ajuste | Ejemplo |
|---|---|
| Regla 1 | {{item.subscriptionType}} es igual a deal.creation → "Camino de negocio nuevo" |
| Regla 2 | {{item.subscriptionType}} es igual a contact.creation → "Camino de contacto nuevo" |
| Respaldo → | "Todo lo demás" |
Herramienta — pulsar un botón de una máquina
Ejecuta una de tus herramientas conectadas una sola vez — enviar un correo, publicar un mensaje en Slack, llamar a una dirección web — sin que ningún agente decida nada. Eliges la herramienta y rellenas sus campos, usando {{variables}} para las partes dinámicas.
| Ajuste | Ejemplo |
|---|---|
| Herramienta | Enviar correo (Outlook) |
| Campos | Para: ben@company.com · Asunto: Nuevo negocio: {{trigger.dealname}} |
Si una {{variable}} en un campo sale vacía en el momento de la ejecución, el paso te lo advierte bien claro en los resultados de la ejecución — nunca enviarás un correo en blanco sin enterarte.
Base de datos — el archivista
Lee, agrega, actualiza o elimina filas en una de tus propias Bases de datos de Nirvai. Las actualizaciones y eliminaciones siempre exigen reglas de coincidencia — un bloque nunca puede tocar todas las filas por accidente.
| Ajuste | Ejemplo |
|---|---|
| Base de datos | CRM › Leads |
| Acción | Insertar |
| Campos | name: {{trigger.name}} · source: HubSpot |
Las lecturas pueden coincidir, elegir columnas y limitar filas (hasta 500 por lectura).
Código — la calculadora de bolsillo
Ejecuta un fragmento corto de Python para transformaciones que las reglas no pueden expresar — reorganizar datos, calcular totales, dar formato a texto. Lee tus entradas, haz el cálculo y asigna el resultado a output:
total = sum(item["amount"] for item in items)
output = [{"deal_count": len(items), "total_amount": total}]
Bucle sobre elementos — hazlo con cada elemento de la caja
Repite sus bloques internos una vez por cada elemento de una lista, varios elementos a la vez. Dentro, {{item...}} se refiere al elemento que se está procesando en ese momento.
Ejemplo: por cada negocio que sobrevivió al filtro → buscar al responsable en una base de datos → enviarle un correo mediante un bloque de herramienta.
Bucle — repetir hasta terminar
Repite sus bloques internos un número de veces, o mientras/hasta que se cumpla una regla — para cosas como recorrer resultados por páginas, donde cada pasada depende de la anterior. {{loop.iteration}} les dice a los bloques internos qué pasada está corriendo. Un tope de seguridad (100 pasadas) garantiza que un bucle nunca puede correr para siempre; alcanzar el tope termina el bucle con normalidad y lo indica en los resultados.
Bucle sobre elementos y Bucle aceptan solo bloques gratuitos en su interior — eso es lo que garantiza que un bucle de mil elementos siga costando cero créditos. ¿Necesitas IA en cada elemento? Haz el recorrido mecánico gratis y luego entrega el resultado recopilado a un único paso de agente después del bucle.
Elegir el bloque correcto
| Quieres... | Usa |
|---|---|
| Tomar uno de dos caminos | Condición |
| Tomar uno entre muchos caminos | Selector |
| Descartar elementos que no importan | Filtro |
| Enviar / publicar / traer algo una vez | Herramienta |
| Guardar o consultar tus propios registros | Base de datos |
| Cálculos o transformaciones que las reglas no pueden hacer | Código |
| Repetir por cada elemento de una lista | Bucle sobre elementos |
| Repetir hasta que algo sea cierto | Bucle |
| Entender, escribir o juzgar | Un paso de IA — el que cuesta créditos |
Qué sigue
Aprende cómo las {{variables}} llevan datos a estos bloques en Datos entre pasos.