# Чат-бот для личного аккаунта Telegram

## Важно знать

При использовании аккаунта могут применяться ограничения, зависящие от сценария использования. Точные данные недоступны, но приблизительные значения лимитов можно найти в открытых источниках.

{% hint style="warning" %}
ОГРАНИЧЕНИЯ И РЕКОМЕНДАЦИИ

1. При первой синхронизации на новом аккаунте Telegram (только что зарегистрированном) можно добавить любое количество контактов.
2. Для существующих аккаунтов действует лимит в 200 контактов.
3. Для нового аккаунта, в который ранее уже добавлялись контакты, лимит составляет 200.
4. Если вы превысите лимит в 200 контактов, вы всё равно сможете добавлять вручную до 15 контактов в день.
5. Чтобы избежать дальнейших ограничений, добавляйте контакты постепенно в течение дня. Слишком большое количество за один раз (например, 15 за 5–10 минут) приведёт к более строгим дневным лимитам: 5 контактов на следующий день, а в итоге — всего 1 контакт в день, если будет также превышен нижний лимит.
6. Если вы добавите 15 контактов в течение дня, на следующий день никаких лимитов установлено не будет.
7. Дневной лимит — 40 сообщений в разные чаты, после чего ваш аккаунт будет временно ограничен.
   {% endhint %}

<details>

<summary>ПОДРОБНЕЕ ОБ ОГРАНИЧЕНИЯХ</summary>

### Контакты

Чтобы отправить сообщение на номер телефона, сначала нужно добавить его в список контактов Telegram.

**Синхронизация списка контактов:**

a) Для недавно созданного аккаунта с номером, который никогда не использовался в Telegram, при первой синхронизации контактов нет ограничений на импорт.

b) Для номеров телефонов, ранее зарегистрированных в Telegram, первоначальный импорт контактов ограничен 200 контактами. Этот лимит также применяется к новым номерам, если выполняется повторная синхронизация.

c) После достижения лимита в 200 записей новые контакты нужно добавлять *вручную*.

#### Ручное создание контактов

Слишком быстрое добавление слишком большого количества контактов (например, 15 за минуту) снизит ваш лимит до 5 контактов на следующий день.

Если в тот же день быстро добавить ещё 5 контактов, лимит будет дополнительно снижен до 1 в день. Однако равномерное распределение добавлений (например, 15 в течение дня) сохраняет полный лимит на следующий день.

Ограничение не сбрасывается со временем.

Согласно Telegram:

> &#x20;*«Чтобы защитить наших пользователей от спама и злоупотреблений, мы внедрили меры, ограничивающие количество контактов, которые можно импортировать за один раз. Если вы превысите эти лимиты, ваш аккаунт будет ограничен в дальнейшем импорте контактов. В таком случае вы сможете вручную добавлять до пяти новых номеров в день. Любые дополнительные контакты, добавленные сверх этого лимита, не будут распознаваться как пользователи Telegram — даже если они уже есть на платформе.»*

{% hint style="success" %}
**Совет:** Распределяйте добавление контактов на весь день, чтобы избежать ограничений.
{% endhint %}

### Лимиты на добавление по username

Если у пользователя есть username, его не нужно сохранять в контакты — вы можете написать ему напрямую. Однако поиск таких пользователей ограничен примерно 200 запросами в день.

### Спам запрещён

Telegram может временно или навсегда заблокировать аккаунт за чрезмерную рассылку сообщений или отправку сообщений слишком большому количеству чатов одновременно.

{% hint style="warning" %}
Временные ограничения длятся минуты, часы или дни, а постоянная блокировка навсегда лишает доступа к аккаунту. Такое наказание обычно применяется за серьёзные нарушения, включая массовый спам, мошенничество, распространение запрещённого контента или повторные жалобы пользователей.
{% endhint %}

1. Вы можете отправлять до 40 сообщений в разные чаты в день, после чего будет активирована временная блокировка.
2. Повторные нарушения лимита на отправку сообщений приводят к постепенно увеличивающимся блокировкам — от минут и часов до дней или недель, с возможным переходом к постоянной блокировке аккаунта.
3. Если вы отправляете одинаковые сообщения подряд без пауз, блокировка может быть наложена уже после нескольких попыток.
4. Контент, распознанный как спам, может привести к немедленной и постоянной блокировке.
5. Если на ваши сообщения поступают жалобы (репорты) от других пользователей, блокировка также неизбежна.

</details>

## Начало работы

Чтобы подключить аккаунт, сначала получите api\_id и api\_hash. Перейдите на [https://my.telegram.org](https://my.telegram.org/) и войдите в свой аккаунт.

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

После входа перейдите в **«API development tools»** .

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

Затем заполните поля:

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

1. Текст **«App title»** поле должно быть заполнено без пробелов и любых символов, только буквами (без подчёркиваний, запятых и т. д.).
2. Текст **«Short name»** поле должно быть заполнено без пробелов и любых символов, только буквами и цифрами (без подчёркиваний, запятых, точек, тире, дефисов и т. д.).
3. Текст **«URL»** поле — это действительная ссылка на ваш сайт.
4. Выберите **«WEB»** в поле **«Platform».**
5. Описание должно быть на **латиница**.

Затем нажмите **Создать приложение**.&#x20;

Текст `[object Object]` ошибка на [**my.telegram.org**](https://my.telegram.org/) означает, что есть недопустимые данные. Убедитесь, что все поля заполнены корректно и что ваши **'app title'** и **'short name'** ещё не заняты.

Если вы всё заполнили правильно, вы увидите следующие данные:

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

## Подключение аккаунта

Выберите «Telegram Account» в разделе «Messengers», затем введите свой номер телефона и полученные данные (api\_id и api\_hash).

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

Нажмите **«Get code»**:

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

На ваш аккаунт Telegram будет отправлен код подтверждения. Введите его:

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

Если на вашем аккаунте включена двухфакторная аутентификация (2FA), вам также нужно будет ввести пароль.

## Групповые чаты

Чтобы бот мог отвечать в групповых чатах, установите переменную клиента answer\_on\_group\_chat = "1". По умолчанию эта функция отключена.

## Архив чатов

Архивированные чаты исключаются из обработки.

## Начало чата по номеру телефона

Чтобы начать диалог с новым клиентом, перейдите в **«Клиенты»** раздел и нажмите **«Write in Telegram».**

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

Введите номер телефона и имя клиента в появившемся окне и подтвердите, нажав **"Добавить"**.

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

Если новый клиент настроил параметры конфиденциальности Telegram так, чтобы его можно было находить по номеру телефона, будет создана новая запись клиента.

## Импорт клиентов из файла

Вы можете импортировать клиентов из файла. Для этого нажмите **Загрузить список клиентов** в поле **Мессенджеры** разделе нужного бота.

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

После завершения импорта будут созданы профили клиентов для тех, кого можно добавить в контакты по номеру телефона.

{% hint style="danger" %}
ОБРАТИТЕ ВНИМАНИЕ!

Учитывайте ограничения Telegram на создание контактов аккаунта. Подробнее см. в [Важно знать ](#important-to-know).&#x20;
{% endhint %}

## Методы калькулятора

create\_telegram\_client(phone, name, group) - добавляет указанный номер в контакты аккаунта Telegram и создаёт соответствующего клиента в MaviBot.

phone - телефон клиента

name - имя клиента

group - ID целевого пользователя бота для привязки бота.

{% hint style="success" %}
Калькулятор также поддерживает общие/универсальные методы.
{% 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/ru/chatbot/messendzhery/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.