Acción: Saltar a acción¶

Esta acción te permite ejecutar cualquier otra acción del botón o comando donde la acción es creada, sin importar su posición. Además, puedes programar la ejecución para que ocurra inmediatamente o en un momento específico en el futuro.

¿Qué puedes hacer con esta acción?¶

Ejecutar otras acciones: Ejecuta otras acciones dentro del propio botón o comando donde la acción fue creada, incluso si está aislada por un separador.
Programa la ejecución: Haz que otras acciones se ejecuten en un momento específico en el futuro, desde segundos hasta días o años; o en una fecha específica.

¿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 → 🔀 Saltar a acción.
Pulsa en Configurar 🛠 para configurar esta acción.

2. Configurar las opciones¶

➡️ `Establecer acción`¶

Indica la acción a la que deseas saltar usando su ID de acción (esa acción será ejecutada).
Puedes elegir entre continuar con las acciones siguientes de la acción a la que saltaste o detener la ejecución después del salto.

Puedes usar expresiones para elegir dinámicamente a qué acción saltar.

➡️ `Programar ejecución` (opcional)¶

Define si la acción debe ejecutarse más tarde:

Por cuenta regresiva (días, horas, minutos o segundos).
En una fecha específica:
- Puedes usar fechas y horas literales. Por ejemplo:
```
31-12-2024 23-59-59
```
- Puedes usar funciones. Por ejemplo, para ejecutar un día después:
```
{time_add(date_now(), 1, "days")}
```

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?¶

Cancelar ejecución programada¶

Puedes cancelar la ejecución programada si obtienes el cancel_id que devuelve esta acción:

#IDAcción.cancel_id#

Y luego lo envías en la acción Cancelar programado.

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

Ejemplo práctico: Crear un recordatorio¶

Crearemos un comando /recordatorio que programe un recordatorio para enviarte un mensaje después de un tiempo indicado.

Ejemplo de uso del comando:

/recordatorio "Llamar a mamá" 10

Parámetro 1: Mensaje que recibirás cuando termine la cuenta regresiva. Es un texto, por tanto va entre comillas.
Parámetro 2: Cuenta regresiva en minutos hasta que recibas el mensaje. Es un número, no lleva comillas.

¿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 transcurrir los 10 minutos recibirás el mensaje:

Llamar a mamá

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 /recordatorio.
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: Saltar a acción¶

Pulsa en 🎯 Nueva acción → 🔀 Saltar a acción.
Por ahora no hacemos nada aquí (la configuraremos más adelante).

c) Acción 3: Enviar mensaje (Confirmar programación al usuario)¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.
Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa el mensaje que informará al usuario que su recordatorio fue programado:
```
✅ Tu recordatorio fue programado y lo recibirás en {#IDAcciónRecParam.param2#} minutos.
```
Reemplaza IDAcciónRecParam por el ID de la acción de Recibir parámetros que copiaste antes (acción 1).
Regresa al menú de acciones y activa la acción pulsando en ✅ Activar.

d) Agregar un Separador¶

Pulsa en Nuevo separador 📍 para agregar un separador y crear un nuevo bloque de acciones. Mira qué son los separadores.

e) Acción 4: Enviar mensaje (Enviar recordatorio)¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.
Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa lo siguiente:
```
¡Recordatorio!

{#IDAcciónRecParam.param1#}
```
Reemplaza IDAcciónRecParam por el ID de la acción de Recibir parámetros que copiaste antes (acción 1).
Regresa al menú de acciones y activa la acción pulsando en ✅ Activar.
Copia el ID de esta acción, lo necesitarás en el siguiente paso.

f) Configurar la acción de Saltar a acción¶

Regresa a la acción de Saltar a acción (acción 2) y pulsa en Configurar 🛠.
Pulsa en 🆔 Establecer acción 🆔 y pega el ID de la acción que enviará el recordatorio (Enviar mensaje, acción 4).
Pulsa en 🕒 Programar ejecución 🕒 → 📅 Establecer fecha 📅 para establecer la programación basada en una fecha específica, y guarda lo siguiente:
```
{time_add(date_now(), #IDAcciónRecParam.param2#, "minutes")}
```
Nota 1: Reemplaza IDAcciónRecParam por el ID de la acción de Recibir parámetros (acción 1).

Nota 2: Hemos usado time_add() para agregar tiempo a date_now(), que es la fecha y hora actual, ambas son funciones que puedes ver aquí.
Regresa al menú de acciones y activa la acción pulsando en ✅ Activar.

Resultado final¶

El usuario envía el comando:

/recordatorio "Ya va a comenzar la peli" 60

El bot responde:

✅ Tu recordatorio fue programado y lo recibirás en 60 minutos.

Después de 60 minutos, el bot le envía el mensaje:
```
¡Recordatorio!

Ya va a comenzar la peli
```

Así quedaron las acciones¶

VisualMaker action jump to action example

Notas importantes¶

Cuando programas el salto a otra acción (para ejecutarse más tarde):

El bot seguirá ejecutando las acciones que están después de Saltar a acción.
Cuando NO programas el salto a otra acción (se ejecuta de inmediato):

El bot salta directamente a la acción seleccionada y no ejecuta las acciones que están después de Saltar a acción.