Saltar a contenido

Acción: información de chat

Usa esta acción para obtener información de cualquier chat de Telegram, ya sea usuario, bot, canal o grupo, a través de su ID de Telegram o su @nombre_de_usuario. Los datos devueltos acerca del chat analizado pueden ser obtenidos a través del #ID# de esta acción, y ser usados en acciones posteriores.

Opciones de la acción:

  • Establecer chat: El ID de Telegram o el @nombre_de_usuario de cualquier chat de Telegram, si es un usuario, no es necesario que esté unido a tu bot.

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

  • id: ID del chat.
  • type: Tipo de chat, puede ser user, bot, channel o group.
  • is_verified: Solo grupos, canales y bots. Devuelve True si el chat ha sido verificado por Telegram. En caso contrario devuelve False.
  • is_restricted: Solo grupos, canales y bots. Devuelve True si el chat ha sido restringido, en caso contrario devuelve False. Consulta restrictions para obtener más detalles.
  • is_scam: Devuelve True si el chat ha sido etiquetado como estafa, en caso contrario devuelve False.
  • is_fake: Devuelve True si el chat ha sido etiquetado como suplantación de identidad, en caso contrario devuelve False.
  • is_support: Solo usuarios y bots. Devuelve True si el chat es parte del equipo de soporte de Telegram, en caso contrario devuelve False.
  • title: Solo grupos y canales. Devuelve su nombre.
  • username: Devuelve el nombre de usuario de usuarios, bots, grupos y canales, si está disponible.
  • first_name: Solo usuarios y bots. Devuelve su nombre.
  • last_name: Solo usuarios. Devuelve su apellido.
  • photo: Devuelve el file_id de la foto de perfil, si existe.
  • bio: La biografía del usuario.
  • description: La descripción del grupo o canal.
  • has_protected_content: Devuelve True si los mensajes del chat no se pueden reenviar a otros chats, en caso contrario devuelve False.
  • invite_link: Enlace de invitación del grupo o canal.
  • pinned_message: Mensaje fijado del grupo, canal, o chat propio.
  • sticker_set_name: Nombre del conjunto de stickers del grupo.
  • can_set_sticker_set: Devuelve True si el bot puede cambiar el conjunto de stickers del grupo, en caso contrario devuelve False.
  • members_count: Cantidad de miembros del grupo o canal.
  • restrictions: Motivos por los que el chat podría no estar disponible para algunos usuarios, separados por comas. Este campo solo está disponible solo en caso de que is_restricted sea True.
  • linked_chat: El grupo vinculado (en caso de canales) o el canal vinculado (en caso de grupos).
  • available_reactions: Reacciones disponibles en el chat, separadas por comas.
  • permissions.can_send_messages: Devuelve True si el bot tiene permitido enviar mensajes de texto, contactos, ubicaciones y lugares, en caso contrario devuelve False.
  • permissions.can_send_media_messages: Devuelve True si el bot 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 bot 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 bot tiene permiso para enviar encuestas. Incluye can_send_messages. En caso contrario devuelve False.
  • permissions.can_add_web_page_previews: Devuelve True si el bot 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 bot puede cambiar el título del chat, la foto y otras configuraciones. Se ignora en supergrupos públicos. En caso contrario devuelve False.
  • permissions.can_invite_users: Devuelve True si el bot puede invitar a nuevos usuarios al chat, en caso contrario devuelve False.
  • permissions.can_pin_messages: Devuelve True si el bot puede anclar mensajes. Se ignora en grupos públicos. En caso contrario devuelve False.
  • user.id: Solo usuarios unidos al bot. Devuelve su ID.
  • user.first_name: Solo usuarios unidos al bot. Devuelve su nombre.
  • user.last_name: Solo usuarios unidos al bot. Devuelve su apellido.
  • user.username: Solo usuarios unidos al bot. Devuelve su nombre de usuario.
  • user.language_code: Solo usuarios unidos al bot. Devuelve su código de idioma, en formato ISO 639-1.
  • user.ref_link: Solo usuarios unidos al bot. Devuelve su enlace de referidos.
  • user.ref_by: Solo usuarios unidos al bot. ID de la persona que refirió al usuario (referente), si no tiene, devolverá None.
  • user.ref_count: Solo usuarios unidos al bot. Devuelve la cantidad de referidos atraídos a través de su enlace de referidos.
  • user.ref_list: Solo usuarios unidos al bot. Listado de todos los referidos del usuario, en formato de cursor, utiliza la función loop() para mostrarlos.
  • user.is_new: Solo usuarios unidos al bot. Devuelve True si el usuario es nuevo en el bot, o False si no lo es. Un usuario es nuevo si no ha pasado por todas las acciones que tenga /start, una vez llegue al menú principal, is_new pasará a ser False.
  • user.is_active: Solo usuarios unidos al bot. Devuelve True si el usuario está activo en el bot, o False si no lo está. Un usuario es activo si no ha eliminado el bot.
  • user.is_banned: Solo usuarios unidos al bot. Devuelve True si el usuario está baneado en el bot, o False si no lo está.
  • user.is_admin: Solo usuarios unidos al bot. Devuelve True si el usuario es administrador del bot, o False si no lo es.
  • user.date_joined: Solo usuarios unidos al bot. Fecha en la que se unió el usuario al bot, utiliza la función date_format() para representarla a tu gusto.
  • user.last_seen: Solo usuarios unidos al bot. Fecha donde se vió por última vez al usuario en el bot, utiliza la función date_format() para representarla a tu gusto.
  • user.variables.(nombre_variable): Solo usuarios unidos al bot. Reemplaza (nombre_variable) por la variable del usuario que se desea visualizar.