Acción: Forzar unirse a chat¶

Esta acción permite forzar a los usuarios a unirse a uno o más canales o grupos antes de continuar con el flujo del bot. El bot debe ser administrador de los canales o grupos especificados.

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

Verificar la suscripción de un usuario: Determina si un usuario está unido a uno o más canales o grupos configurados previamente.
Bloquear el avance hasta que se una: Si el usuario no está suscrito a los canales o grupos requeridos, el bot mostrará un mensaje de advertencia (configurable) y no permitirá continuar hasta que cumpla.
Retorna el estado de la suscripción: La acción devuelve el estado del usuario en cada canal o grupo configurado.

¿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 → 👥 Forzar unirse a chat.
Pulsa en Configurar 🛠 para configurar esta acción.

2. Configurar las opciones¶

➡️ Establecer chats a unirse¶

Escribe los ID o @usernames de los canales o grupos a los que quieres que el usuario se una, separados por comas. Ejemplo:

@Canal1, @Grupo2

➡️ Mensaje principal (opcional)¶

Este mensaje explicará al usuario que debe unirse a los canales o grupos requeridos. Puedes incluir enlaces directos a los chats usando el formato:

{chat_link.n}

Reemplaza n con el número del canal o grupo según el orden en que lo agregaste. Ejemplo:

Por favor, únete a nuestros chats para continuar:
👉 Canal 1: {chat_link.1}
👉 Grupo 2: {chat_link.2}
Cuando te hayas unido, presiona el botón de verificar.

➡️ Mensaje si no se unió (opcional)¶

Mensaje mostrado si el usuario no se unió a los canales requeridos. Si no configuras este campo, se mostrará un mensaje predeterminado. Ejemplo:

Aún no te has unido a los canales requeridos. Por favor, únete para continuar.

➡️ Botón de verificar (opcional)¶

Agrega un botón inferior o inline que el usuario debe presionar para confirmar que se unió a los canales. Ejemplo:

Verificar unión

➡️ Forzar a otro usuario (opcional)¶

Si deseas forzar a otro usuario a unirse a los canales o grupos (en lugar del usuario actual), escribe su ID o nombre de usuario. Si dejas este campo vacío, se aplicará al usuario que ejecuta la acción.

3. Activar la acción¶

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

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

La acción devuelve el parámetro status, que indica el estado del usuario en cada chat configurado. Esto es solo para usos más avanzados donde se quiera obtener el estado dinámicamente y usarlo en otras acciones, por lo general no es necesario para verificar la suscripción del usuario.

Formato para obtener el estado¶

#IDAcción.chat(num).status#

IDAcción: El ID de la acción de Forzar unirse a chat (esta acción).
(num): El número del chat en el orden en que los agregaste.

Por ejemplo, si configuraste dos chats, @Canal1 y @Canal2, y quieres obtener el estado del usuario en @Canal2:

#IDAcción.chat2.status#

Valores posibles de `status`¶

member (miembro)
administrator (administrador)
owner (propietario)
left (salió)
banned (baneado)
restricted (restringido)

Ejemplo práctico¶

¿Necesitas un ejemplo? Tenemos una guía detallada en la cuál te enseñamos paso a paso a requerir a los usuarios que se unan a determinados canales al iniciar el bot, y solo después de unirse pueden continuar, para verla haz click aquí.