Variables y datos

Una variable guarda un dato para usarlo después. La creas al guardar algo y la usas escribiendo su nombre entre dobles llaves: {{nombre}}.

#Quién crea variables

• Extraer datos y Rastrear páginas guardan lo que leen (un valor, una lista de filas).
• Guardar un valor guarda el valor que escribas.
• Vigilar un valor, Petición HTTP, Cookie (al leer) y Esperar una petición de red pueden guardar su resultado.
• Ejecutar una macro guarda si la macro llegó al final (true) o falló (false).
• Leer datos, Calcular, Fechas y horas y Memoria (al leer, contar o añadir a una lista) guardan su resultado.
• Los bucles crean la variable de cada vuelta.
• Los datos que pide la automatización (sección Datos que pide) se convierten en variables.

#Dónde se usan

En casi cualquier texto de un paso: lo que se escribe, una dirección, un mensaje, el asunto de un email… Al escribir, el campo te ofrece las variables disponibles.

Ejemplos:

• Mensaje: El precio ahora es {{precio}} €
• Dirección: https://tienda.com/buscar?q={{producto}}
• Dentro de un objeto: {{respuesta.data.id}}

#Variables que siempre existen

#Secretos guardados

Las claves de API y los tokens no se escriben en la automatización: se guardan una vez como secretos y se usan por su nombre.

1. En Conexiones, sección Secretos guardados, escribe un nombre en mayúsculas (por ejemplo API_KEY), pega el valor y escribe los dominios permitidos, uno por línea (por ejemplo api.openai.com).
2. En el paso, escribe {{secret.API_KEY}} o elígelo en el menú de variables del campo.

Ejemplos:

• Cabecera Authorization: Bearer {{secret.API_KEY}}
• Dirección: https://api.ejemplo.com/datos?token={{secret.TOKEN}}
• Dirección de Notificar por webhook: https://hooks.slack.com/services/{{secret.SLACK_PATH}}, con la parte final de la dirección de Slack como secreto y hooks.slack.com como dominio.

Solo funcionan en la dirección, las cabeceras y el cuerpo de una Petición HTTP y en la dirección de Notificar por webhook, y nunca en el dominio de la dirección. En cualquier otro campo quedan vacíos y el editor te lo marca: un secreto nunca se escribe en una página ni se guarda en una variable.

#Dominios permitidos

Cada secreto solo se envía a sus dominios. Un dominio incluye sus subdominios: openai.com vale para api.openai.com, pero no para notopenai.com. Si una petición va a cualquier otro sitio, el paso falla sin enviar el secreto y el aviso dice qué secreto y qué dominio fueron. Por lo mismo, una petición que lleva secretos no sigue redirecciones a otra dirección, y no se aceptan dominios tan amplios como com o github.io.

Así, una automatización importada o instalada del marketplace que use {{secret.API_KEY}} no puede mandar tu clave a un servidor que tú no elegiste. Puedes cambiar los dominios con Editar dominios sin volver a escribir el valor. Los secretos guardados antes de que existieran los dominios no se envían a ningún sitio hasta que les añadas al menos uno.

Si la extensión no tiene sesión iniciada, falta un secreto con ese nombre o el dominio no está permitido, el paso falla con un aviso que te dice qué hacer.

#Limpiar valores

Al extraer o guardar puedes aplicar limpiezas: quitar espacios, mayúsculas o minúsculas, convertir a número (con coma o punto decimal), leer una fecha, reemplazar texto o quedarte con una parte usando una expresión regular.

#Leer datos

Leer datos guarda en una variable una lista de filas que luego recorres con Para cada elemento (cada fila es {{elemento.columna}}). Puede leerlas de:

• Un enlace de Google Sheets: comparte la hoja como «Cualquier persona con el enlace» y pega su enlace. Lee la pestaña que muestra el enlace (la de #gid=…).
• Una dirección web que devuelva un archivo CSV o JSON. El formato se detecta solo o lo eliges tú.
• Datos escritos o de un archivo: pega CSV o JSON, o pulsa Cargar archivo para leer un .csv o .json de tu equipo. El archivo se lee en tu navegador y se guarda dentro de la automatización (hasta 100.000 caracteres); no se sube a ningún sitio.

En el CSV, la primera fila son los títulos de las columnas; se aceptan comas, punto y coma o tabuladores, y celdas entre comillas. Un JSON debe ser una lista de objetos (o un solo objeto). Si los datos no se pueden leer, el paso falla y te dice por qué.

#Memoria entre ejecuciones

Memoria guarda valores que siguen ahí la próxima vez que se ejecuta la automatización, en este navegador. Cada valor tiene una clave (como precio_anterior, o visto_{{id}} con variables). Puedes:

• Guardar un valor o leerlo en una variable (queda vacía si no hay nada guardado).
• Sumar a un contador: suma 1, -1 o una variable, empezando en 0.
• Añadir a una lista: guarda hasta 500 elementos; al llenarse quita los más antiguos.
• Borrar una clave o toda la memoria.

Por ejemplo, para avisar solo cuando cambia un precio: lee precio_anterior, compáralo con un Si y, al final, guarda el precio nuevo. Cada automatización guarda hasta 100 claves.

#Calcular

Calcular resuelve una expresión y guarda el número: {{precio}} * 1,21, ({{a}} + {{b}}) / 2 o round({{total}} / 3; 2).

• Operadores: + - * / % (resto) y ^ (potencia), con paréntesis.
• Funciones: round(x; decimales), floor, ceil, abs, min y max.
• Los números pueden llevar coma o punto: con los dos, el último marca los decimales (1.234,56); con uno solo, ese marca los decimales (12,5, 3.5).
• Si usas funciones y números con coma decimal, separa los argumentos con punto y coma: round(2,5; 0).

Una división entre cero o una expresión mal escrita hacen fallar el paso.

#Fechas y horas

Fechas y horas guarda una fecha o un dato sobre fechas:

• La fecha y hora actuales.
• Leer una fecha de un texto: 05/10/2026, 2026-10-05 14:30, una marca de tiempo… eligiendo el orden de día, mes y año.
• Sumar o restar tiempo: minutos, horas, días, semanas, meses o años. Sumar un mes al 31 de enero da el último día de febrero.
• Tiempo entre dos fechas, en unidades completas.
• Dar formato: ISO, fecha, hora, fecha y hora, o un patrón propio como DD/MM/YYYY HH:mm ([texto] entre corchetes se escribe tal cual).

Las fechas se guardan como 2026-10-05T14:30:00, que cualquier otro campo de fecha vuelve a leer. Si dejas la fecha vacía, se usa el momento en que se ejecuta el paso.