¿Cómo configuro el paso Definir variables?

¿Para qué sirve?

«Definir variables» escribe un valor en una o varias variables. Si das el nombre de una variable existente, su valor cambia. En pasos posteriores usas el valor como {name}.

Los visitantes no ven este paso y el avatar no dice nada; el agente sigue sin esperar al visitante.

Para añadirlo, haz clic en «Añadir paso» en la pestaña «Editor» y luego en «Definir variables» en la categoría «Lógica»; el paso se añade en el centro del lienzo. Sus ajustes están en la pestaña «Contenido» del panel que se abre a la derecha al hacer clic en el paso.

Este paso no tiene «Texto en pantalla»; en su lugar hay una «Nota del paso» al final del panel. La nota es solo para ti: los visitantes no la ven, y no se dice ni se traduce.

En los valores usas variables de pasos anteriores, como {city}. Para un campo dentro de una respuesta, añade su nombre tras un punto: {order.status}. El botón «Insertar variable» de los cuadros muestra las variables que puedes usar en ese punto. Una variable que aún no tiene valor cuenta como texto vacío.

Configurar el paso

1. Escribe el nombre de la variable en el primer cuadro de «Asignaciones». Una asignación nueva sugiere un nombre que el agente aún no usa; puedes cambiarlo.
2. Elige el tipo de valor en la lista de al lado e introduce el valor debajo.
3. Para otra variable, haz clic en «Añadir asignación»; quita las sobrantes con la cruz de la fila («Eliminar asignación»).

Tipos de valor

• «Texto»: el texto que escribes, que puede incluir variables ({first_name} {last_name}). Si lo dejas vacío, la variable se vacía.
• «Cálculo»: números, variables, + − × ÷ (o * y /) y paréntesis, por ejemplo, {total} * 1.2. La multiplicación y la división van primero. El resultado es un número con dos decimales como máximo (12.5).
• «Fecha»: suma una cantidad de tiempo a una fecha inicial; la unidad es días, semanas, meses o años. Si el cuadro inicial está vacío (muestra «Hoy»), se usa la fecha de hoy del visitante; una cantidad negativa retrocede en el tiempo. El resultado se ve como 05.10.2026. Una fecha que pasa del final del mes se mueve al último día del mes: sumar 1 mes al 31 de enero da el 28 (o 29) de febrero.
• «Resumen de lista»: convierte una lista en un solo valor. La operación es «Recuento», «Suma», «Media», «Mínimo», «Máximo» o «Unir»; Unir escribe los valores uno tras otro, separados por comas. Para todo salvo Recuento, introduce en el cuadro de al lado el campo del elemento que se usa (por ejemplo, price); sin campo, se usa el propio elemento. En una lista vacía, el recuento y la suma son 0 y los demás quedan vacíos.

Las asignaciones se ejecutan en orden; una posterior puede usar el valor escrito por una anterior. Un valor que no se puede calcular (una variable que no es un número, una división por cero, un inicio que no es una fecha) vacía la variable, para que el agente no siga con un valor antiguo o erróneo.

Ejemplo

Una inscripción a un evento tiene tres asignaciones: total («Cálculo») {guests} * 25; total_with_tax («Cálculo») {total} * 1.2; due_date («Fecha», inicio vacío, 7 días). Un paso Mensaje puede decir entonces «Tu total es {total_with_tax}; paga antes del {due_date}.»

A tener en cuenta

El editor te avisa cuando: no hay asignaciones, el nombre de una asignación no es válido, un valor «Cálculo» o «Resumen de lista» está vacío, o un cálculo tiene un error de escritura.

Los nombres de variables solo pueden usar las letras a–z, dígitos y guiones bajos (_); las letras con acento y los espacios desaparecen al escribir. «system» está reservado para las variables del sistema, así que elige otro nombre.

Los problemas no impiden guardar: el agente se guarda, pero el paso incompleto no funcionará como se espera en la conversación. Corrige los pasos marcados y prueba el agente con «Vista previa». Para encontrar los pasos marcados, consulta el editor de flujos.