¿Qué son las variables nativas?¶

Las variables nativas son valores predefinidos que el bot ya tiene y que puedes usar sin necesidad de crearlas.
Estas variables se actualizan automáticamente y son útiles para obtener información sobre usuarios, el bot o el contexto de los mensajes.
No pueden ser creadas ni eliminadas.

Variables nativas de usuarios¶

id: ID único del usuario.
first_name: El primer nombre del usuario.
last_name: El apellido del usuario (si tiene).
username: El nombre de usuario de Telegram, sin @.
mention: Mención del usuario con un enlace a su perfil.
language_code: Idioma del usuario en código estándar ISO 639-1 (ejemplo: es para español).
ref_link: Enlace único de referidos del usuario.
ref_by: ID de la persona que refirió al usuario. Si no tiene referente, devuelve None.
ref_count: Cantidad de personas que el usuario ha referido directamente (nivel 1).
ref_count_all: Total de referidos en todos los niveles (1, 2, 3, etc.).
ref_count_(nivel): Cantidad de referidos en un nivel específico (por ejemplo: ref_count_2 para nivel 2).
ref_list: Lista de referidos del usuario. Usa la función loop() para mostrarlos.
date_joined: Fecha en que el usuario se unió al bot. Puedes formatearla con date_format().
last_seen: Última vez que el usuario interactuó con el bot. Formateable con date_format().
is_admin: Si el usuario es administrador del bot: True si es verdadero o False si no lo es.
is_new: Si el usuario es nuevo (no ha completado las acciones de /start): True si es verdadero o False si no lo es.
is_active: Si el usuario está activo el bot: True si es verdadero o False si no lo es.
is_banned: Si el usuario está baneado del bot: True si es verdadero o False si no lo es.
is_premium: Si el usuario tiene Telegram Premium: True si es verdadero o False si no lo es.

Variables nativas del bot¶

bot_name: Nombre del bot.
bot_username: Nombre de usuario del bot, sin @.
bot_top_ref: Lista de usuarios con más referidos. Usa loop() para mostrarlos.
total_users: Número total de usuarios que han iniciado el bot.
total_active_users: Total de usuarios activos que en el bot.
total_unregistered: Total de usuarios que iniciaron el bot pero no completaron la verificación creada por ti en /start.
total_banned: Total de usuarios baneados en el bot.
total_deposits: Total de depósitos realizados en el bot.
total_deposits_amount: Suma total en USD de los depósitos realizados.
total_withdrawals: Total de retiros realizados.
total_withdrawals_amount: Suma total en USD de los retiros realizados.

Variables nativas de mensajes y chats¶

chat_type: Tipo de chat donde se envió el mensaje. Si fue enviado en el bot devolverá private, si fue enviado en un grupo devolverá group, y si fue enviado en un canal devolverá channel.
reply_to_message_id: Si el mensaje responde a otro, devuelve el ID del mensaje original.
reply_to_message.id: ID del remitente original del mensaje al que se responde.
reply_to_message.first_name: Nombre del remitente original.
reply_to_message.username: Nombre de usuario del remitente original, sin @.
reply_to_message.language_code: Idioma del remitente original en código ISO 639-1.
reply_to_message.is_bot: Si el remitente original es un bot: True si es verdadero o False si no lo es.
reply_to_message.is_premium: Si el remitente original tiene Telegram Premium: True si es verdadero o False si no lo es.

¿Cómo usar las variables nativas?¶

Al igual que las variables, la variables nativas pueden ser usadas en mensajes, en acciones, y en cualquier lugar donde las expresiones puedan ser usadas. Solo necesitas usarlas entre llaves {} en los mensajes que envíes.

Ejemplo 1:

Mensaje:

Hola {first_name}, bienvenido a {bot_name}.

Resultado:
```
Hola Juan, bienvenido a MiBot.
```

Ejemplo 2:

Mensaje:
```
Has referido a {ref_count} personas.
```
Resultado:
```
Has referido a 10 personas.
```

Ejemplo 3:

Mensaje:
```
Tu enlace de referidos es {ref_link}
```

Resultado:

Tu enlace de referidos es https://t.me/MiBot?start=123456789