Saltar a contenido

Acción: forzar unirse a chat

Usa esta acción para forzar a un usuario a unirse a uno o varios canales o grupos, el bot debe ser administrador del canal o grupo al cual se va a requerir la unión.

La cantidad de acciones de este tipo que puedes tener simultáneamente por bot, y los canales y grupos a los cuales requerir la unión por acción, dependen de tu suscripción actual en VisualMaker.

Opciones de la acción:

  • Establecer chats a unirse: Los canales o grupos a los cuales forzar el usuario a unirse, separados por coma.
  • Forzar a otro usuario (opcional): Usuario al cual cual forzar a unirse, de no especificarse, se forzará al usuario que ejecutó la acción.
  • Mensaje si no se unió (opcional): Mensaje a mostrar al usuario si no se unió a los canales o grupos requeridos, si no se establece se mostrará un mensaje predeterminado.

¿Qué devuelve la acción a través de su ID? (avanzado)

Al forzar al usuario a unirse a los chats, también se obtienen algunos datos que podrían ser de tu interés. Accede a ellos a través del número del chat, en el orden que fue guardado, con el formato #IDAcción.chat(num)#, reemplaza IDAcción por el ID de esta accion, y (num) por el número del chat a verificar, según el orden en el cual fue guardado, por ejemplo, si guardaste dos canales separados por coma: @channel_of_cats, @channel_of_dogs, accede al estado del usuario en @channel_of_cats a través de #IDAcción.chat1.status#, y de @channel_of_dogs a través de #IDAcción.chat2.status#. No olvides reemplazar IDAcción por el ID de esta acción.

Entendiendo lo anterior, hay mucha información que puedes obtener acerca de la suscripción del usuario en el chat.

Parámetros que pueden ser obtenidos

  • status: El estado del usuario en el chat verificado, puede ser member (miembro), administrator (administrador), owner (propietario), left (salió), banned (baneado), restricted (restringido).
  • joined_date: Fecha cuando el usuario se unió al chat.
  • invited_by: ID del usuario que invitó al usuario al chat, a través de un enlace de invitación.
  • promoted_by: Si el usuarios es administrador del chat, ID del administrador que lo promovió.
  • restricted_by: Si el usuario está restringido o baneado, ID del administrador que lo restringió o baneó.
  • until_date: Si el usuario está restringido o baneado, hasta qué fecha lo está.
  • can_be_edited: Devuelve True si se le permite editar los privilegios de administrador del usuario, en caso contrario devuelve False.
  • privileges: Sólo si el usuario es administrador o propietario. Acciones privilegiadas que el usuario, como administrador, puede realizar.
  • permissions: Sólo si el usuario está restringido o baneado. Acciones restringidas que el usuario, si no es administrador, puede realizar.

Obtener privilegios del usuario

  • privileges.can_manage_chat: Devuelve True si el usuario puede acceder al registro de eventos del chat, a las estadísticas del chat, a las estadísticas de mensajes en los canales, ver a los miembros del canal, ver a los administradores anónimos en los grupos e ignorar el modo lento. Incluye cualquier otro privilegio de administrador. En caso contrario devuelve False.
  • privileges.can_delete_messages: Devuelve True si el usuario puede eliminar mensajes de otros usuarios, en caso contrario devuelve False.
  • privileges.can_manage_video_chats: Sólo para grupos. Devuelve True, si el administrador puede administrar videochats (también conocidas como llamadas grupales), en caso contrario devuelve False.
  • privileges.can_restrict_members: Devuelve True si el usuario puede restringir, banear o desbanear a los miembros del chat, en caso contrario devuelve False.
  • privileges.can_promote_members: Devuelve True si el usuario puede agregar nuevos administradores con un subconjunto de sus propios privilegios o degradar administradores que haya promovido, directa o indirectamente (promovidos por administradores que fueron designados por el usuario), en caso contrario devuelve False.
  • privileges.can_change_info: Devuelve True si el usuario puede cambiar el título del chat, la foto y otras configuraciones, en caso contrario devuelve False.
  • privileges.can_post_messages: Solo para canales. Devuelve True si el usuario puede publicar mensajes en el canal, en caso contrario devuelve False.
  • privileges.can_edit_messages: Solo para canales. Devuelve True si el usuario puede editar mensajes de otros usuarios, en caso contrario devuelve False.
  • privileges.can_invite_users: Devuelve True si el usuario puede invitar a nuevos usuarios al chat, en caso contrario devuelve False.
  • privileges.can_pin_messages: Sólo grupos. Devuelve True si el usuario puede anclar mensajes, en caso contrario devuelve False.
  • privileges.is_anonymous: Devuelve True si el usuario está oculto en el chat, en caso contrario devuelve False.

Obtener permisos del usuario

  • permissions.can_send_messages: Devuelve True si el usuario tiene permitido enviar mensajes de texto, contactos, ubicaciones y lugares, en caso contrario devuelve False.
  • permissions.can_send_media_messages: Devuelve True si el usuario tiene permitido enviar audios, documentos, fotos, videos, notas de video y notas de voz. Incluye can_send_messages. En caso contrario devuelve False.
  • permissions.can_send_other_messages: Devuelve True si el usuario puede enviar animaciones, juegos, stickers y utilizar bots inline. Incluye can_send_media_messages. En caso contrario devuelve False.
  • permissions.can_send_polls: Devuelve True si el usuario tiene permiso para enviar encuestas. Incluye can_send_messages. En caso contrario devuelve False.
  • permissions.can_add_web_page_previews: Devuelve True si el usuario puede agregar vistas previas de páginas web a sus mensajes. Incluye can_send_media_messages. En caso contrario devuelve False.
  • permissions.can_change_info: Devuelve True si el usuario puede cambiar el título del chat, la foto y otras configuraciones. Se ignora en grupos públicos. En caso contrario devuelve False.
  • permissions.can_invite_users: Devuelve True si el usuario puede invitar a nuevos usuarios al chat, en caso contrario devuelve False.
  • permissions.can_pin_messages: Devuelve True si el usuario puede anclar mensajes. Se ignora en grupos públicos. En caso contrario devuelve False.
Guía

¿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í.