Acción: Ejecutar botón¶

Esta acción te permite ejecutar cualquier botón o comando del bot automáticamente, sin necesidad de pulsarlo manualmente. Puedes usarla para automatizar procesos y pasar parámetros personalizados, además puedes programar su ejecución para el futuro.

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

Automatizar comandos o botones: Ejecuta cualquier botón o comando del bot de forma automática, incluso si está oculto.
Pasar parámetros: Envía información al botón o comando ejecutado, como números, textos, fechas o datos dinámicos.
Programar la ejecución: Define cuándo se ejecutará, ya sea de inmediato, después de un tiempo o en una fecha específica.

¿Cómo configurar la acción?¶

1. Crear la acción¶

Ve al editor de tu bot pulsando 🛠 Editar.
Selecciona el botón o comando donde deseas agregar esta acción, o crea uno nuevo.
Pulsa en Acciones 🌟 → 🎯 Nueva acción → ↪️ Ejecutar botón.
Pulsa en Configurar 🛠 para configurar la acción.

2. Configurar las opciones¶

➡️ `Establecer botón`¶

Indica el botón o comando a ejecutar. Si es un comando, debe comenzar con / o ! (por ejemplo: /start).

➡️ `Parámetros` (opcional)¶

Especifica los datos que se enviarán al botón o comando. Separa los valores por espacio. Ejemplo:

12345 "Hola VM" "10-11-2023" #jG8K3.text# "{username}"

Tipos de datos

Para textos, fechas y expresiones usa comillas " ".
Para números, boleanos, e ID de acciones no uses comillas.

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

Define si la ejecución debe ocurrir 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 (Ejecutar botón).

Ejemplo práctico: Crear un recordatorio mediante un cuestionario¶

En este ejemplo, el bot hará dos preguntas al usuario:

¿Qué mensaje desea programar?
¿En cuántos minutos quiere recibir el recordatorio?

Después, el bot enviará automáticamente estos datos al comando /recordatorio que creamos en el ejemplo práctico de la acción Saltar a acción, el cual programará el recordatorio para el usuario.

1. Crear el botón `Recordatorio`¶

Entra al editor del bot pulsando 🛠 Editar.
Crea un nuevo botón pulsando en ✳️ Nuevo botón | comando y nómbralo Recordatorio.
Pulsa en Acciones 🌟 para configurar las acciones del botón.

2. Configurar las acciones¶

a) Acción 1: Enviar mensaje (preguntar el mensaje)¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.

Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa:

¿Qué mensaje desea programar?

Envía /cancelar para cancelar.

Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

b) Acción 2: Esperar respuesta¶

Pulsa en 🎯 Nueva acción → ⏳ Esperar respuesta.
Pulsa en Configurar 🛠:
- Validación: Selecciona únicamente texto.
- Mensaje de error:
```
Por favor, escribe un mensaje válido.
```
- Textos para cancelar:
```
/cancelar
```
- Mostrar mensaje al cancelar:
```
La operación ha sido cancelada.
```
Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

c) Acción 3: Enviar mensaje (Preguntar el tiempo)¶

Pulsa en 🎯 Nueva acción → ✉️ Enviar mensaje.

Pulsa en Configurar 🛠 → 💬 Establecer mensaje 💬 e ingresa:

¿En cuántos minutos quiere recibir el recordatorio?

Envía /cancelar para cancelar.

Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

d) Acción 4: Esperar respuesta¶

Pulsa en 🎯 Nueva acción → ⏳ Esperar respuesta.
Pulsa en Configurar 🛠:
- Validación: Selecciona únicamente número.
- Mensaje de error:
```
Por favor, escribe un número válido.
```
- Textos para cancelar:
```
/cancelar
```
- Mostrar mensaje al cancelar:
```
La operación ha sido cancelada.
```
Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

e) Acción 5: Ejecutar botón¶

Pulsa en 🎯 Nueva acción → ↪️ Ejecutar botón.
Pulsa en Configurar 🛠:
- Establecer botón:
```
/recordatorio
```
- Parámetros:
```
#IDAcciónEspRespMensaje.text# #IDAcciónEspRespTiempo.text#
```
  Nota 1: Reemplaza IDAcciónEspRespMensaje por el ID de la acción de Esperar respuesta que espera por el mensaje (acción 2)
  
  Nota 2: Reemplaza IDAcciónEspRespTiempo por el ID de la acción de Esperar respuesta que espera por el tiempo (acción 4)
Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

Resultado final¶

El usuario pulsa el botón Recordatorio.
El bot realiza el cuestionario:
- Bot: ¿Qué mensaje desea programar?
- Usuario: Llamar a mamá.
- Bot: ¿En cuántos minutos quiere recibir el recordatorio?
- Usuario: 15
El bot ejecuta el comando /recordatorio con los parámetros:
- Parámetro 1: Llamar a mamá.
- Parámetro 2: 15

El comando /recordatorio procesa los datos y responde:

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

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

Llamar a mamá.
```

Así quedaron las acciones¶

Nota importante¶

El comando /recordatorio debe estar configurado previamente, se enseñó a crearlo en el ejemplo práctico de la acción anterior.