Importante saber
Se pueden aplicar restricciones basadas en el escenario de uso al utilizar una cuenta. No se dispone de datos exactos, pero se pueden encontrar valores límite aproximados en fuentes abiertas.
LIMITACIONES Y RECOMENDACIONES
- Puedes agregar cualquier cantidad de contactos durante la primera sincronización en una cuenta nueva de Telegram (recién registrada).
- Las cuentas existentes tienen un límite de 200 contactos.
- Para una cuenta nueva donde ya se hayan agregado contactos antes, el límite es de 200.
- Si superas el límite de 200 contactos, aún puedes agregar hasta 15 contactos manualmente por día.
- Para evitar restricciones adicionales, agrega contactos gradualmente a lo largo del día. Agregar demasiados a la vez (por ejemplo, 15 en 5-10 minutos) activará límites diarios más estrictos: 5 contactos al día siguiente y, eventualmente, solo 1 contacto por día si también se supera el límite inferior.
- Si agregas 15 contactos a lo largo del día, no se establecerán límites al día siguiente.
- El límite diario es de 40 mensajes a diferentes chats, después de lo cual tu cuenta será restringida temporalmente.
Contactos
Para enviar un mensaje a un número de teléfono, primero debes agregarlo a tu lista de contactos de Telegram.
Sincronización de la lista de contactos:
a) Para una cuenta recién creada con un número nunca usado en Telegram, la primera sincronización de contactos no tiene límites de importación.
b) Para números de teléfono previamente registrados en Telegram, la importación inicial de contactos está limitada a 200 contactos. Este límite también se aplica a números nuevos si se realiza una resincronización.
c) Una vez que se ha alcanzado el límite de 200 entradas, los nuevos contactos deben agregarse manualmente.
Creación manual de contactos
Agregar demasiados contactos demasiado rápido (por ejemplo, 15 en un minuto) reducirá tu límite a 5 contactos al día siguiente.
Agregar 5 contactos más rápidamente el mismo día reducirá aún más el límite a 1 por día. Sin embargo, distribuir las adiciones de manera uniforme (por ejemplo, 15 a lo largo del día) preserva el límite completo para el día siguiente.
La restricción no se restablece con el tiempo.
Según Telegram:
«Para proteger a nuestros usuarios del spam y el abuso, hemos implementado salvaguardas que limitan la cantidad de contactos que se pueden importar a la vez. Si superas estos límites, tu cuenta será restringida para importar más contactos. En tales casos, podrás agregar manualmente hasta cinco números nuevos por día. Cualquier contacto adicional agregado más allá de este límite no será reconocido como usuario de Telegram, incluso si ya está en la plataforma.»
Consejo: Distribuye las adiciones de contactos a lo largo de un día completo para evitar restricciones.
Límites de adición de nombre de usuario
Si un usuario tiene un nombre de usuario, no es necesario guardarlo en tus contactos; puedes enviarle un mensaje directamente. Sin embargo, la búsqueda de dichos usuarios está limitada a aproximadamente 200 solicitudes por día.
No se permite spam
Telegram emitirá una prohibición temporal o permanente de la cuenta por enviar mensajes excesivos o enviar mensajes a demasiados chats a la vez.
Mientras que las restricciones temporales duran minutos, horas o días, una prohibición permanente revoca el acceso a la cuenta de forma indefinida. Esta penalización generalmente se reserva para infracciones graves, que incluyen spam masivo, fraude, compartir contenido prohibido o informes repetidos de usuarios.
- Puedes enviar hasta 40 mensajes a diferentes chats por día, después de lo cual se activará un bloqueo temporal.
- Las violaciones repetidas del límite de mensajes resultan en bloqueos progresivamente más largos, que van desde minutos y horas hasta días o semanas, pudiendo escalar a una prohibición permanente de la cuenta.
- Si envías mensajes idénticos seguidos sin pausas, se puede imponer un bloqueo después de solo unos pocos intentos.
- El contenido identificado como spam puede resultar en una prohibición inmediata y permanente.
- Si tus mensajes reciben quejas (informes) de otros usuarios, un bloqueo también es inevitable.
Primeros pasos
Para conectar tu cuenta, primero obtén tu api_id y api_hash. Ve a https://my.telegram.org e inicia sesión en tu cuenta.

Después de iniciar sesión, ve a la sección "API development tools".

Luego completa los campos:

- El campo "App title" debe completarse sin espacios ni símbolos, usando solo letras (sin guiones bajos, comas, etc.).
- El campo "Short name" debe completarse sin espacios ni símbolos, usando solo letras y números (sin guiones bajos, comas, puntos, guiones, etc.).
- El campo "URL" es un enlace válido a tu sitio web.
- Elige "WEB" en "Platform".
- La descripción debe estar en latín.
Luego haz clic en Create application.
El error [object Object] en my.telegram.org significa que hay datos no válidos. Asegúrate de que todos los campos sean correctos y que tu 'app title' y 'short name' no estén ya en uso.
Si has completado todo correctamente, verás los siguientes datos:

Conexión de la cuenta
Selecciona "Telegram Account" en la sección "Messengers", luego ingresa tu número de teléfono y las credenciales obtenidas (api_id y api_hash).

Haz clic en "Get code":

Se enviará un código de verificación a tu cuenta de Telegram. Introdúcelo:

Si la autenticación de dos factores (2FA) está habilitada en tu cuenta, también deberás ingresar tu contraseña.
Chats grupales
Para permitir que el bot responda en chats grupales, establece la variable de cliente answer_on_group_chat = "1". Por defecto, esta función está deshabilitada.
Archivo de chat
Los chats archivados están excluidos del procesamiento.
Iniciar un chat usando un número de teléfono
Para iniciar un diálogo con un nuevo cliente, ve a la sección "Clients" y haz clic en "Write in Telegram".

Ingresa el número de teléfono y el nombre del cliente en la ventana mostrada, y confirma haciendo clic en "Add".

Si el nuevo cliente ha configurado su privacidad de Telegram para permitir la búsqueda por número de teléfono, se generará un nuevo registro de cliente.
Importación de clientes desde archivo
Puedes importar clientes desde un archivo. Para hacerlo, haz clic en Upload a list of clients en la sección Messengers del bot deseado.

Una vez finalizada la importación, se generarán perfiles de cliente para aquellos que puedan agregarse a los contactos según su número de teléfono.
¡TEN EN CUENTA!
Considera las restricciones para la creación de contactos en la cuenta de Telegram. Obtén más información en la sección Importante saber.
Métodos de la calculadora
create_telegram_client(phone, name, group) - agrega el número especificado a los contactos en la cuenta de Telegram y crea un cliente correspondiente en MaviBot.
phone - teléfono del cliente
name - nombre del cliente
group - ID de usuario del bot objetivo para la vinculación del bot.
La calculadora también admite métodos comunes/generales.


