Чатбот для особистого Telegram-акаунта
Важливо знати
Під час використання облікового запису можуть застосовуватися обмеження, залежно від сценарію використання. Точні дані відсутні, але приблизні значення лімітів можна знайти у відкритих джерелах.
ОБМЕЖЕННЯ ТА РЕКОМЕНДАЦІЇ
Під час першої синхронізації на новому обліковому записі Telegram (щойно зареєстрованому) можна додати будь-яку кількість контактів.
Існуючі облікові записи мають ліміт у 200 контактів.
Для нового облікового запису, у якому контакти вже додавалися раніше, ліміт становить 200.
Якщо ви перевищите ліміт у 200 контактів, ви все одно зможете додавати до 15 контактів вручну на день.
Щоб уникнути подальших обмежень, додавайте контакти поступово протягом дня. Надто велика кількість одразу (наприклад, 15 за 5–10 хвилин) спричинить жорсткіші добові ліміти: 5 контактів наступного дня, а зрештою лише 1 контакт на день, якщо нижчий ліміт також буде перевищено.
Якщо ви додасте 15 контактів протягом дня, наступного дня жодних лімітів встановлено не буде.
Добовий ліміт — 40 повідомлень у різні чати, після чого ваш обліковий запис буде тимчасово обмежено.
БІЛЬШЕ ПРО ОБМЕЖЕННЯ
Контакти
Щоб надіслати повідомлення на номер телефону, спочатку потрібно додати його до списку контактів Telegram.
Синхронізація списку контактів:
a) Для щойно створеного облікового запису з номером, який ніколи не використовувався в Telegram, перша синхронізація контактів не має обмежень на імпорт.
b) Для номерів телефону, раніше зареєстрованих у Telegram, початковий імпорт контактів обмежено 200 контактами. Це обмеження також застосовується до нових номерів, якщо виконується повторна синхронізація.
c) Після досягнення ліміту в 200 записів нові контакти потрібно додавати вручну.
Ручне створення контактів
Надто швидке додавання великої кількості контактів (наприклад, 15 за хвилину) зменшить ваш ліміт до 5 контактів наступного дня.
Додавання ще 5 контактів того ж дня знову швидко зменшить ліміт до 1 на день. Водночас рівномірний розподіл додавань (наприклад, 15 протягом дня) зберігає повний ліміт на наступний день.
Обмеження не скидається з часом.
За словами Telegram:
«Щоб захистити наших користувачів від спаму та зловживань, ми впровадили захисні механізми, які обмежують кількість контактів, що можуть бути імпортовані одночасно. Якщо ви перевищите ці ліміти, ваш обліковий запис буде обмежено в подальшому імпорті контактів. У таких випадках ви зможете вручну додавати до п’яти нових номерів на день. Будь-які додаткові контакти, додані понад цей ліміт, не будуть розпізнані як користувачі Telegram — навіть якщо вони вже є на платформі.»
Порада: Розподіляйте додавання контактів на весь день, щоб запобігти обмеженням.
Обмеження на додавання за іменем користувача
Якщо користувач має ім’я користувача, вам не потрібно зберігати його в контактах — ви можете написати йому напряму. Однак пошук таких користувачів обмежено приблизно 200 запитами на день.
Спам заборонено
Telegram накладатиме тимчасове або постійне блокування облікового запису за надмірну кількість повідомлень або надсилання повідомлень у надто багато чатів одночасно.
Тимчасові обмеження тривають хвилини, години або дні, тоді як постійне блокування позбавляє доступу до облікового запису на невизначений термін. Таке покарання зазвичай застосовується за серйозні порушення, зокрема масовий спам, шахрайство, поширення забороненого контенту або повторні скарги користувачів.
Ви можете надсилати до 40 повідомлень у різні чати на день, після чого буде активовано тимчасове блокування.
Повторні порушення ліміту на повідомлення призводять до дедалі довших блокувань — від хвилин і годин до днів або тижнів, що може зрештою призвести до постійного блокування облікового запису.
Якщо ви надсилаєте однакові повідомлення підряд без пауз, блокування може бути накладене вже після кількох спроб.
Контент, визначений як спам, може призвести до негайного й постійного блокування.
Якщо на ваші повідомлення надходять скарги (репорти) від інших користувачів, блокування також неминуче.
Початок роботи
Щоб підключити обліковий запис, спочатку отримайте свій api_id і api_hash. Перейдіть на https://my.telegram.org і увійдіть у свій обліковий запис.

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

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

Поле "App title" поле потрібно заповнити без пробілів і будь-яких символів, використовуючи лише літери (без підкреслень, ком, тощо).
Поле "Short name" поле потрібно заповнити без пробілів і будь-яких символів, використовуючи лише літери та цифри (без підкреслень, ком, крапок, тире, дефісів тощо).
Поле "URL" поле — це дійсне посилання на ваш вебсайт.
Оберіть "WEB" у полі "Platform".
Опис має бути Латиниця.
Потім натисніть Створити застосунок.
Поле [object Object] помилка на my.telegram.org означає, що є недійсні дані. Переконайтеся, що всі поля заповнено правильно і що ваші 'app title' та 'short name' ще не зайняті.
Якщо ви все заповнили правильно, ви побачите такі дані:

Підключення облікового запису
Оберіть "Telegram Account" у розділі "Messengers", потім введіть свій номер телефону та отримані облікові дані (api_id і api_hash).

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

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

Якщо на вашому обліковому записі увімкнено двофакторну автентифікацію (2FA), вам також потрібно буде ввести пароль.
Групові чати
Щоб дозволити боту відповідати в групових чатах, встановіть змінну клієнта answer_on_group_chat = "1". За замовчуванням ця функція вимкнена.
Архів чату
Заархівовані чати не беруться до обробки.
Початок чату за номером телефону
Щоб почати діалог із новим клієнтом, перейдіть до "Клієнти" розділу та натисніть "Write in Telegram".

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

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

Після завершення імпорту буде створено профілі клієнтів для тих, кого можна додати до контактів за номером телефону.
ЗВЕРНІТЬ УВАГУ!
Враховуйте обмеження Telegram щодо створення контактів у обліковому записі. Дізнайтеся більше в Важливо знати розділ.
Методи калькулятора
create_telegram_client(phone, name, group) - додає вказаний номер до контактів в обліковому записі Telegram і створює відповідного клієнта в MaviBot.
phone - телефон клієнта
name - ім’я клієнта
group - цільовий ID користувача бота для прив’язки бота.
Калькулятор також підтримує загальні/основні методи.
Last updated