# Chatbot para una cuenta personal de Telegram

## Importante saber

Se pueden aplicar restricciones basadas en el escenario de uso al utilizar una cuenta. No hay datos exactos disponibles, pero los valores aproximados de los límites se pueden encontrar en fuentes abiertas.

{% hint style="warning" %}
LIMITACIONES Y RECOMENDACIONES

1. Puedes añadir cualquier cantidad de contactos durante la primera sincronización en una nueva cuenta de Telegram (recién registrada).
2. Las cuentas existentes tienen un límite de 200 contactos.
3. Para una cuenta nueva en la que ya se han añadido contactos antes, el límite es de 200.
4. Si superas el límite de 200 contactos, aún puedes añadir hasta 15 contactos manualmente por día.
5. Para evitar más restricciones, añade contactos gradualmente a lo largo del día. Añadir demasiados de una vez (por ejemplo, 15 en 5-10 minutos) activará límites diarios más estrictos: 5 contactos al día siguiente y, finalmente, solo 1 contacto por día si también se supera el límite inferior.
6. Si añades 15 contactos a lo largo del día, no se establecerán límites al día siguiente.
7. El límite diario es de 40 mensajes a chats diferentes, después de lo cual tu cuenta será restringida temporalmente.
   {% endhint %}

<details>

<summary>MÁS SOBRE LAS RESTRICCIONES</summary>

### Contactos

Para enviar un mensaje a un número de teléfono, primero debes añadirlo a tu lista de contactos de Telegram.

**Sincronización de la lista de contactos:**

a) Para una cuenta creada recientemente con un número que nunca se ha 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 alcanzado el límite de 200 entradas, los nuevos contactos deben añadirse *manualmente*.

#### Creación manual de contactos

Añadir demasiados contactos demasiado rápido (por ejemplo, 15 en un minuto) reducirá tu límite a 5 contactos al día siguiente.

Añadir 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 forma uniforme (por ejemplo, 15 a lo largo del día) conserva el límite completo para el día siguiente.

La restricción no se restablece con el tiempo.

Según Telegram:

> &#x20;*«Para proteger a nuestros usuarios del spam y el abuso, hemos implementado medidas de seguridad que limitan la cantidad de contactos que se pueden importar a la vez. Si superas estos límites, tu cuenta tendrá restringida la importación adicional de contactos. En tales casos, podrás añadir manualmente hasta cinco números nuevos por día. Cualquier contacto adicional añadido por encima de este límite no será reconocido como usuario de Telegram, incluso si ya está en la plataforma.»*

{% hint style="success" %}
**Consejo:** Distribuye la adición de contactos a lo largo de todo el día para evitar restricciones.
{% endhint %}

### Límites para añadir nombres de usuario

Si un usuario tiene un nombre de usuario, no necesitas guardarlo en tus contactos: puedes enviarle un mensaje directamente. Sin embargo, la búsqueda de estos usuarios está limitada a aproximadamente 200 solicitudes por día.

### No se permite spam

Telegram aplicará una suspensión temporal o permanente de la cuenta por enviar demasiados mensajes o por enviar mensajes a demasiados chats a la vez.

{% hint style="warning" %}
Mientras que las restricciones temporales duran minutos, horas o días, una suspensión permanente revoca el acceso a la cuenta de forma indefinida. Esta penalización suele reservarse para infracciones graves, como spam masivo, fraude, compartir contenido prohibido o denuncias repetidas de usuarios.
{% endhint %}

1. Puedes enviar hasta 40 mensajes a chats diferentes por día, después de lo cual se activará un bloqueo temporal.
2. Las infracciones repetidas del límite de mensajes dan lugar a bloqueos progresivamente más largos, que van de minutos y horas a días o semanas, y pueden llegar incluso a una suspensión permanente de la cuenta.
3. Si envías mensajes idénticos seguidos sin pausas, se puede imponer un bloqueo tras solo unos pocos intentos.
4. El contenido identificado como spam puede dar lugar a una suspensión inmediata y permanente.
5. Si tus mensajes reciben quejas (reportes) de otros usuarios, también será inevitable un bloqueo.

</details>

## Primeros pasos

Para conectar tu cuenta, primero obtén tu api\_id y api\_hash. Ve a [https://my.telegram.org](https://my.telegram.org/) e inicia sesión en tu cuenta.

<div data-with-frame="true"><figure><img src="/files/8aeb801840684b7c52e5ae5eb7f89b31ac3bf12a" alt=""><figcaption></figcaption></figure></div>

Después de iniciar sesión, ve a **"Herramientas de desarrollo de API"** sección.

<div data-with-frame="true"><figure><img src="/files/3f840fb06a079a4612252a00e9f0bbada6bb30ca" alt=""><figcaption></figcaption></figure></div>

Luego completa los campos:

<div data-with-frame="true"><figure><img src="/files/b8e7d02062951f2b1bb77fd59bdeb6dbe5cac85e" alt=""><figcaption></figcaption></figure></div>

1. El **"Título de la aplicación"** el campo debe rellenarse sin espacios ni símbolos, usando solo letras (sin guiones bajos, comas, etc.).
2. El **"Nombre corto"** el campo debe rellenarse sin espacios ni símbolos, usando solo letras y números (sin guiones bajos, comas, puntos, guiones, guiones medios, etc.).
3. El **"URL"** el campo es un enlace válido a tu sitio web.
4. Elige **"WEB"** en el **"Plataforma".**
5. La descripción debe estar en **latín**.

Luego haz clic en **Crear aplicación**.&#x20;

El `[object Object]` error en [**my.telegram.org**](https://my.telegram.org/) significa que hay datos inválidos. Asegúrate de que todos los campos sean correctos y de que tu **"título de la aplicación"** y **"nombre corto"** no estén ya en uso.

Si has completado todo correctamente, verás los siguientes datos:

<div data-with-frame="true"><figure><img src="/files/29ba50f74c4d83abc64fdac2abc758fb4c064f76" alt="" width="563"><figcaption></figcaption></figure></div>

## Conexión de la cuenta

Selecciona "Cuenta de Telegram" en la sección "Mensajeros" y luego introduce tu número de teléfono y las credenciales obtenidas (api\_id y api\_hash).

<div data-with-frame="true"><figure><img src="/files/6fa9e4d6eaff70e7d5a3b47d02a49fbbf1dd3f62" alt=""><figcaption></figcaption></figure></div>

Haz clic en **"Obtener código"**:

<div data-with-frame="true"><figure><img src="/files/0bc37c0b1443a6aed0a2ca15a9184a2d2b45f52e" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/cb91574a7e6fcfed419b5e613b9e594d544c3935" alt=""><figcaption></figcaption></figure></div>

Si la autenticación de dos factores (2FA) está habilitada en tu cuenta, también deberás introducir tu contraseña.

## Chats de grupo

Para permitir que el bot responda en chats de grupo, establece la variable del cliente answer\_on\_group\_chat = "1". De forma predeterminada, esta función está deshabilitada.

## Archivo de chats

Los chats archivados se excluyen del procesamiento.

## Iniciar un chat usando un número de teléfono

Para iniciar un diálogo con un nuevo cliente, ve a la **"Clientes"** sección y haz clic en **"Escribir en Telegram".**

<div data-with-frame="true"><figure><img src="/files/cfc1fdbcf87950323b4cbe0fa05e3cb965e19d02" alt="" width="563"><figcaption></figcaption></figure></div>

Introduce el número de teléfono y el nombre del cliente en la ventana mostrada y confirma haciendo clic en **"Añadir"**.

<div data-with-frame="true"><figure><img src="/files/83445baef2fbf38c44b083cd3dfb5384274c1674" alt=""><figcaption></figcaption></figure></div>

Si el nuevo cliente ha configurado su privacidad de Telegram para permitir que se le descubra por número de teléfono, se generará un nuevo registro de cliente.

## Importación de clientes desde un archivo

Puedes importar clientes desde un archivo. Para ello, haz clic en **Subir una lista de clientes** en el **Mensajeros** sección del bot deseado.

<div data-with-frame="true"><figure><img src="/files/bd14f23d56696eab05e321a8234713a2bd901e21" alt=""><figcaption></figcaption></figure></div>

Una vez finalizada la importación, se generarán perfiles de cliente para aquellos que puedan añadirse a los contactos según su número de teléfono.

{% hint style="danger" %}
¡TEN EN CUENTA!

Ten en cuenta las restricciones para la creación de contactos en cuentas de Telegram. Obtén más información en los [Importante saber ](#important-to-know)sección.&#x20;
{% endhint %}

## Métodos de calculadora

create\_telegram\_client(phone, name, group) - añade el número especificado a los contactos de la cuenta de Telegram y crea un cliente correspondiente en MaviBot.

phone - teléfono del cliente

name - nombre del cliente

group - ID del usuario del bot de destino para el enlace del bot.

{% hint style="success" %}
La calculadora también admite métodos comunes/generales.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/chatbot/mensajeros/telegram/personal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.