# Чатбот для особистого облікового запису 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 %}

### Обмеження на додавання за іменем користувача

Якщо користувач має ім’я користувача, вам не потрібно зберігати його в контактах — ви можете написати йому напряму. Однак пошук таких користувачів обмежено приблизно 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/1e30ea79bfae77936a3bafe62cb41b2c1c232cb3" alt=""><figcaption></figcaption></figure></div>

Після входу перейдіть до **"API development tools"** розділ.

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

Потім заповніть поля:

<div data-with-frame="true"><figure><img src="/files/8bec3579abec362652463442f6904dbed806095a" 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/9de2e1cc6d9a0572a335841b2ab8e3493b315a23" alt="" width="563"><figcaption></figcaption></figure></div>

## Підключення облікового запису

Оберіть "Telegram Account" у розділі "Messengers", потім введіть свій номер телефону та отримані облікові дані (api\_id і api\_hash).

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

Натисніть **"Get code"**:

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

Код підтвердження буде надіслано на ваш обліковий запис Telegram. Введіть його:

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

Якщо на вашому обліковому записі увімкнено двофакторну автентифікацію (2FA), вам також потрібно буде ввести пароль.

## Групові чати

Щоб дозволити боту відповідати в групових чатах, встановіть змінну клієнта answer\_on\_group\_chat = "1". За замовчуванням ця функція вимкнена.

## Архів чату

Заархівовані чати не беруться до обробки.

## Початок чату за номером телефону

Щоб почати діалог із новим клієнтом, перейдіть до **"Клієнти"** розділу та натисніть **"Write in Telegram".**

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

У вікні, що з’явиться, введіть номер телефону та ім’я клієнта, а потім підтвердьте, натиснувши **"Додати"**.

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

Якщо новий клієнт налаштував приватність Telegram так, щоб дозволити пошук за номером телефону, буде створено новий запис клієнта.

## Імпорт клієнтів із файла

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

<div data-with-frame="true"><figure><img src="/files/297c790cf4e334f73fa0ea431e3712abca4e5b29" 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/uk/chatbot/mesendzheri/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.