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
ogroup
. - is_verified: Solo grupos, canales y bots. Devuelve
True
si el chat ha sido verificado por Telegram. En caso contrario devuelveFalse
. - is_restricted: Solo grupos, canales y bots. Devuelve
True
si el chat ha sido restringido, en caso contrario devuelveFalse
. Consultarestrictions
para obtener más detalles. - is_scam: Devuelve
True
si el chat ha sido etiquetado como estafa, en caso contrario devuelveFalse
. - is_fake: Devuelve
True
si el chat ha sido etiquetado como suplantación de identidad, en caso contrario devuelveFalse
. - is_support: Solo usuarios y bots. Devuelve
True
si el chat es parte del equipo de soporte de Telegram, en caso contrario devuelveFalse
. - 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 devuelveFalse
. - 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 devuelveFalse
. - 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
seaTrue
. - 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 devuelveFalse
. - permissions.can_send_media_messages: Devuelve
True
si el bot tiene permitido enviar audios, documentos, fotos, videos, notas de video y notas de voz. Incluyecan_send_messages
. En caso contrario devuelveFalse
. - permissions.can_send_other_messages: Devuelve
True
si el bot puede enviar animaciones, juegos, stickers y utilizar bots inline. Incluyecan_send_media_messages
. En caso contrario devuelveFalse
. - permissions.can_send_polls: Devuelve
True
si el bot tiene permiso para enviar encuestas. Incluyecan_send_messages
. En caso contrario devuelveFalse
. - permissions.can_add_web_page_previews: Devuelve
True
si el bot puede agregar vistas previas de páginas web a sus mensajes. Incluyecan_send_media_messages
. En caso contrario devuelveFalse
. - 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 devuelveFalse
. - permissions.can_invite_users: Devuelve
True
si el bot puede invitar a nuevos usuarios al chat, en caso contrario devuelveFalse
. - permissions.can_pin_messages: Devuelve
True
si el bot puede anclar mensajes. Se ignora en grupos públicos. En caso contrario devuelveFalse
. - 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, oFalse
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 serFalse
. - user.is_active: Solo usuarios unidos al bot. Devuelve
True
si el usuario está activo en el bot, oFalse
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, oFalse
si no lo está. - user.is_admin: Solo usuarios unidos al bot. Devuelve
True
si el usuario es administrador del bot, oFalse
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.