Automatizaciones
Datos entre pasos
Cómo las variables llevan datos del disparador y de pasos anteriores a cualquier bloque, y cómo elegirlas de forma segura
Las variables funcionan como los campos de combinación de correspondencia en una carta: escribes {{trigger.name}} en la configuración de un bloque, y cuando ocurre la ejecución, Nirvai lo reemplaza con el valor real — el nombre real del cliente del evento real. Así fluyen los datos por tu automatización: cada bloque puede mirar hacia atrás y usar lo que vino antes.
Las tres familias de variables
| Variable | Alcanza | Ejemplo |
|---|---|---|
{{trigger...}} | Los datos que iniciaron la ejecución — el negocio, el pedido, tu entrada manual | {{trigger.dealname}}, {{trigger[0].amount}} |
{{steps.N.output...}} | Lo que produjo el paso número N | {{steps.3.output.summary}} |
{{item...}} | Dentro de For Each / Loop: el elemento que se está procesando en este momento | {{item.email}} |
Úsalas en cualquier lugar donde escribas un valor: instrucciones de agentes, campos de herramientas, campos de bases de datos y todos los constructores de reglas.
Un elemento o varios
La salida de un paso es una lista de elementos. Cuando un paso produjo exactamente un elemento, puedes omitir la posición: {{steps.1.output.field}}. Cuando produjo varios, indica cuál: {{steps.1.output[0].field}} es el primero. Los archivos funcionan igual, y sus detalles están un nivel más abajo — {{steps.1.output[0].file.name}} (ver Archivos en automatizaciones).
El selector de variables
No tienes que memorizar rutas — cada campo que acepta variables tiene un selector que muestra lo que está disponible de pasos anteriores, insertado como píldoras ordenadas. Cada sugerencia lleva una etiqueta de confianza:
| Etiqueta | Significado |
|---|---|
| Estructura verificada | El paso que la produce promete que este campo existe (una salida estructurada de agente) — la opción más segura |
| De tu prueba | Vista en la muestra que capturaste al probar el disparador |
| Visto en la última ejecución | Existía la última vez que se ejecutó esta automatización |
| Sin etiqueta | La escribiste a mano — permitido, pero nada garantiza que exista |
Pruébalo aquí — haz clic en una sugerencia para insertarla en el campo Asunto como una píldora:
{{trigger.dealname}}El selector advierte pero nunca bloquea — siempre puedes escribir una ruta que sabes que va a llegar. Las etiquetas solo te dicen qué tan seguro está Nirvai de que estará ahí.
Cuando una variable sale vacía
Si una {{variable}} no encuentra nada al momento de ejecutar, la ejecución no se rompe — pero los bloques de herramientas y de bases de datos lo reportan claramente en los resultados de la ejecución ("N valores no resolvieron a nada"), y los campos que resolvieron vacíos se dejan fuera de las escrituras en la base de datos. Si la salida de un paso se ve en blanco, esta advertencia es lo primero que hay que revisar.
Una regla para la salida libre de agentes
Un paso de agente estructurado expone sus campos individuales. Un paso de agente de formato libre expone solo su respuesta completa ({{steps.N.output}}) — porque nada garantiza qué campos contiene una respuesta escrita libremente. ¿Quieres campos? Dale a ese paso una salida estructurada.
Errores comunes
| Error | Mejor enfoque |
|---|---|
| Adivinar los nombres de los campos a mano | Prueba primero el disparador (Escuchar) — así el selector muestra los campos reales de un evento real. |
Leer {{steps.2.output.score}} de un agente de formato libre | Haz que el paso 2 sea estructurado, con score como campo prometido. |
Usar {{item...}} fuera de un For Each / Loop | Solo existe dentro de esos bloques; en otros lugares usa {{trigger...}} o {{steps...}}. |
Qué sigue
Pasa documentos e imágenes de paso en paso en Archivos en automatizaciones, o mira tus variables rellenadas con valores reales en Pruebas y ejecuciones.