Acción: Difusión¶

Esta acción permite enviar mensajes masivos a todos los usuarios de tu bot, según las condiciones que establezcas.

Puedes personalizar los mensajes según el idioma u otras variables de cada usuario, y enviar diferentes mensajes dependiendo de si cumplen ciertas condiciones.

Si un usuario no cumple ninguna condición, no recibirá ningún mensaje, y se evaluará al siguiente usuario.

¿Cómo funciona esta acción?¶

Las condiciones de los mensajes se evalúan de arriba hacia abajo.
El primer mensaje cuya condición se cumpla para un usuario será enviado.
Si ninguna condición se cumple, ese usuario no recibirá ningún mensaje.
Puedes enviar mensajes a todos los usuarios o a un número de usuarios aleatorios, según lo configures.

Información importante

Costo: Cada vez que usas esta acción, consume 5 ejecuciones y recursos de difusión.
Recursos de difusión:
- Se renuevan cada mes según tu plan, estos pueden ser incrementados actualizando tu suscripción.
- En la suscripción premium tendrás recursos de difusión y ejecuciones ilimitadas, mira todas las ventajas de la suscripción premium aquí.
- Puedes comprar paquetes de difusión adicionales que no vencen. Ve a:
  
  VisualMaker → 🖥 Bots → 📜 Mis bots → (selecciona tu bot) → 📦 Paquetes extras → Difusión 📧
Velocidad de envío: Depende de tu suscripción contratada.
Cancelar difusión activa: Envía el comando /stop_broadcast

¿Cómo configurar la acción?¶

1. Crear la acción¶

Go to your bot and press 🛠 Edit to enter editor mode.
Selecciona el botón o comando donde deseas agregar esta acción, o crea uno nuevo.
Ve a Acciones 🌟 → 🎯 Nueva acción → 📧 Difusión.
Pulsa en Configurar 🛠 para configurarla.

2. Configurar las opciones¶

➡️ `Ver mensajes`¶

Aquí puedes ver, agregar y editar los mensajes que deseas enviar.
Configura una condición (en formato de expresión) para cada mensaje. Si se cumple, ese mensaje se enviará al usuario, si no se cumple, se evaluará la condición del siguiente mensaje. Si no estableces una condición, el mensaje se enviará siempre.

➡️ `Usuarios` (opcional)¶

Define la cantidad de usuarios aleatorios que recibirán la difusión.
Si no estableces una cantidad, el mensaje será enviado a todos los usuarios.
Puedes usar expresiones, variables o IDs de acciones para personalizar el número de usuarios.

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

No devuelve nada.

Ejemplo práctico: Difusión en español o inglés según el idioma del usuario¶

En este ejemplo usaremos la acción Difusión para enviar un mensaje en español a los usuarios que hablen español, el resto recibirán un mensaje en inglés.

1. Crear el botón `Difusión`¶

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

2. Configurar las acciones¶

a) Acción 1: Difusión¶

Pulsa en 🎯 Nueva acción y selecciona 📧 Difusión.
Pulsa en Configurar 🛠 → ✉️ Ver mensajes ✉️:
1. Pulsa en ➕ Nuevo mensaje ➕ para establecer el mensaje en español:
  - Pulsa en 🗒 Mensaje → 💬 Establecer mensaje 💬 e ingresa el mensaje a enviar:
```
Hola {first_name}, ¿cómo estás?
```
  - Pulsa en ↙️ Regresar ↘️ y luego en Condición 🕹 e ingresa la condición:
```
{language_code == "es"}
```
2. Pulsa en ➕ Nuevo mensaje ➕ para establecer el mensaje en inglés:
  - Pulsa en 🗒 Mensaje → 💬 Establecer mensaje 💬 e ingresa el mensaje a enviar:
```
Hello {first_name}, how are you?
```
  Nota 1: No es necesario establecer una condición aquí, así este mensaje se enviará a todos los usuarios que no hablen español.
  
  Nota 2: Tanto first_name como language_code son variables nativas, míralas todas aquí.
Regresa al menú de acciones y pulsa ✅ Activar para activar esta acción.

Resultado final¶

El usuario pulsa el botón Difusión y se ejecuta la acción de difusión.
El bot evalúa las condiciones de cada mensaje:
- Si el idioma del usuario es es, envía el mensaje en español.
- Si el idioma del usuario es cualquier otro, envía el mensaje en inglés.
El proceso continúa evaluando a los siguientes usuarios hasta completar la difusión.