Acción: Evaluador¶

La acción Evaluador sirve para evaluar una expresión y guardar el resultado, el cual puede ser usado en acciones posteriores. Es una herramienta flexible que permite realizar operaciones matemáticas, unir textos, usar valores de variables y mucho más. La clave de su uso radica en la reutilización de resultados.

¿Cómo funciona esta acción?¶

Define una expresión para evaluar: Escribe una fórmula o cálculo que el bot debe evaluar.
Usa el resultado: Una vez evaluada la expresión, el resultado se guarda y puedes usarlo en acciones posteriores, tantas veces como quieras.

¿Cómo configurar la acción?¶

1. Crear la acción:¶

Ve a tu bot y pulsa en 🛠 Editar para entrar en el modo editor.
Selecciona el botón o comando donde deseas agregar la acción, o crea uno nuevo.
Pulsa en Acciones 🌟 → 🎯 Nueva acción → 👁 Evaluador.
Pulsa en Configurar 🛠 para configurar esta acción.

2. Configurar las opciones:¶

➡️ `Establecer expresión`¶

Escribe la expresión que deseas evaluar, la expresión debe ir entre llaves { }. Puedes usar variables e ID de acciones. Por ejemplo:

Matemáticas: {5 + 3} → Retorna 8.
Unir textos: {"Hola, " + first_name} → Combina "Hola, " con el nombre del usuario, retorna algo como "Hola, Juan"
Usar datos previos: {#IDAcciónPrevia.param1# * 2} → Multimplicará por dos el valor del parámetro capturado en una acción anterior.
Usar funciones: {random(1, 10)} → Retorna un número aleatorio entre 1 y 10.

➡️ `Eliminar guardada` (opcional)¶

Elimina la expresión previamente guardada.

3. Activar la acción¶

Pulsa ✅ Activar para activar esta acción y que quede funcional.

¿Qué devuelve esta acción a través de su ID?¶

La acción devuelve el resultado de la evaluación. Accede al resultado con:

#IDAcción.data#

Reemplaza IDAcción por el ID de esta acción (Evaluador).

Ejemplo práctico: Calcular el descuento de un producto¶

Supón que tienes un comando llamado /calcular_precio que calcula el precio final de un producto tras aplicar un descuento.

Ejemplo de uso del comando:

/calcular_precio 100 20

Parámetro 1: Precio original del producto.
Parámetro 2: Porcentaje de descuento.

¿Qué son los parámetros y cómo obtenerlos?

Para aprender qué son los parámetros y cómo obtenerlos mira la acción Recibir parámetros.

Al realizar el cálculo deberá devolver:

✅ El precio final es: 80

Usaremos esta acción para hacer el cálculo.

1. Crea el comando¶

Entra al modo editor pulsando 🛠 Editar en tu bot.
Crea un nuevo comando pulsando en ✳️ Nuevo botón | comando y nómbralo /calcular_precio.
Pulsa en Acciones 🌟 para entrar al menú de acciones del comando.

2. Configura las acciones¶

a) Acción 1: Recibir parámetros¶

Pulsa en 🎯 Nueva acción → 🖥 Recibir parámetros.
Esta acción no requiere configuración, simplemente actívala pulsando en ✅ Activar.
Copia el ID de esta acción, lo necesitarás en un momento.

b) Acción 2: Evaluador¶

Pulsa en 🎯 Nueva acción → 👁 Evaluador.
Pulsa en Configurar 🛠 → 🪧 Establecer expresión 🪧 e ingresa la expresión para calcular el precio final:
```
{#IDAcción.param1# * (1 - (#IDAcción.param2# / 100))}
```
- #IDAcción.param1#: Precio original.
- #IDAcción.param2#: Porcentaje de descuento.
Reemplaza IDAcción con el ID de la acción Recibir parámetros que copiaste antes (acción 1).
Formula para calcular descuento

Hemos usado la formula matemática típica para calcular descuentos de productos:
```
precio_final = precio_original * (1 - porcentaje_descuento / 100)
```
Regresa al menú de acciones y activa la acción pulsando en ✅ Activar.
Copia el ID de esta acción, lo necesitarás en un momento.

c) Acción 3: Enviar mensaje¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.
Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa el mensaje para mostrar el precio final:
```
✅ El precio final es: {#IDAcciónEvaluador.data#}
```
Reemplaza IDAcciónEvaluador con el ID de la acción Evaluador que acabas de copiar (acción 2).
Regresa al menú de acciones y activa la acción pulsando en ✅ Activar.

Resultado final¶

Cuando envíes el comando:

/calcular_precio 100 20

La acción Recibir parámetros captura:
- Precio original: 100.
- Descuento: 20.
La acción Evaluador calcula el precio final:
```
100 * (1 - (20 / 100)) = 80
```
La acción Enviar mensaje te responde:
```
✅ El precio final es: 80
```

Así quedaron las acciones¶

VisualMaker action evaluator example

Notas importantes¶

Combinación de datos: Puedes mezclar números, textos, variables, funciones y resultados de acciones previas.
Reutilización del resultado: Guarda el valor evaluado y úsalo en tantas acciones posteriores como necesites.