Важно знать

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

ОГРАНИЧЕНИЯ И РЕКОМЕНДАЦИИ

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

Контакты

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

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

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

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

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

Создание контакта вручную

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

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

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

Согласно Telegram:

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

Совет: Распределяйте добавление контактов на весь день, чтобы избежать ограничений.

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

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

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

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

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

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

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

Чтобы подключить свой аккаунт, сначала получите api_id и api_hash. Перейдите на https://my.telegram.org и войдите в свой аккаунт.

После входа перейдите в раздел "API development tools".

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

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

Затем нажмите Create application.

Ошибка [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". По умолчанию эта функция отключена.

Архив чатов

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

Начало чата с использованием номера телефона

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

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

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

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

Вы можете импортировать клиентов из файла. Для этого нажмите Upload a list of clients в разделе Messengers нужного бота.

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

ОБРАТИТЕ ВНИМАНИЕ!

Учитывайте ограничения на создание контактов для аккаунта Telegram. Подробнее в разделе Важно знать.

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

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

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

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

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

Калькулятор также поддерживает общие/основные методы.