Важно знать!

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

КРАТКО ОБ ОГРАНИЧЕНИЯХ И РЕКОМЕНДАЦИЯХ!

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

Подробнее об ограничениях

Контакты

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

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

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

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

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

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

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

Если в этот день быстро внести ещё 5 контактов, в дальнейшем лимит снизится до 1 контакта в день.

При равномерном добавлении (например, 15 номеров в течение всего дня) на следующий день можно снова добавить 15 контактов.

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

Сам Telegram сообщает:

«У нас есть защитные меры, чтобы предотвратить импорт слишком большого количества контактов. После того как вы получите запрет на импорт контактов, вы можете добавить максимум пять новых номеров в день. Остальные контакты будут отображаться так, будто они не используют Telegram, даже если используют.»

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

Ограничения на добавление по username

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

Поиск пользователей по username ограничен примерно 200 запросами в сутки.

Недопустимость спама

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

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

  1. В день можно отправить до 40 сообщений в разные чаты.
  2. При регулярном превышении лимита блокировки становятся всё более продолжительными: от минут до часов, дней и недель, вплоть до бессрочной блокировки.
  3. При отправке одинаковых сообщений подряд без пауз блокировка может наступить уже после нескольких сообщений.
  4. Если содержимое будет классифицировано как спам, блокировка может быть применена сразу.
  5. Жалобы пользователей также могут привести к блокировке.

Ознакомиться со всеми ограничениями можно в открытом источнике:

https://docs.google.com/spreadsheets/d/1-mpB7PuxlScIIejH793Yp1g8AIFseA_GlUwZva2Rvs/htmlview?lsrp=1

Подготовка к работе

Перед подключением аккаунта необходимо получить api_id и api_hash.

Перейдите на:

https://my.telegram.org/auth

и войдите в свой аккаунт.

После авторизации откройте раздел API development tools.

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

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

После заполнения нажмите Create application.

Если появится сообщение:

значит, некоторые поля заполнены неверно либо значения App title или Short name уже заняты.

При успешном создании приложения вы увидите:

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

В разделе Каналы выберите Telegram Account, укажите номер телефона, api_id и api_hash.

Нажмите Получить код.

Введите код, который придёт в Telegram.

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

После этого аккаунт будет подключён.

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

По умолчанию бот не отвечает на сообщения из групповых чатов.

Чтобы включить эту возможность, создайте переменную клиента:

  • answer_on_group_chat = 1

После этого бот будет отвечать в групповых чатах.

Архив чатов

Чаты, находящиеся в архиве, не обрабатываются.

Начало диалога по номеру телефона

В разделе Клиенты нажмите Написать в Telegram.

Введите номер телефона и имя клиента, затем нажмите Добавить.

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

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

В разделе Каналы выберите нужного бота и нажмите Загрузить список клиентов.

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

Важно!

Учитывайте ограничения на создание контактов для Telegram-аккаунта.

Подробнее см. в разделе «Важно знать!».

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

Добавить номер в контакты

create_telegram_client(phone, name, group)

Добавляет указанный номер в контакты Telegram-аккаунта и создаёт соответствующего клиента в Salebot.

Параметры:

  • phone — номер телефона клиента.
  • name — имя клиента.
  • group — User ID бота, к которому нужно привязать клиента.

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

Добавить аккаунт по username

create_telegram_client_by_username(username, name, group)

Добавляет пользователя по username в контакты Telegram и создаёт соответствующего клиента в Salebot.

Параметры:

  • username — username пользователя (@user).
  • name — имя клиента.
  • group — User ID бота, к которому необходимо привязать клиента.

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

В разделе "Каналы" выбираем Telegram Account, вводим телефон и полученные данные:

Нажимаем "получить код":

В Telegram аккаунт придет код подтверждения, вводим его:

Если в аккаунте подключена двухфакторная авторизация, необходимо также будет ввести пароль:

Аккаунт подключен

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

По умолчанию бот не отвечает на сообщения из групповых чатов. Чтобы включить эту возможность, в переменные клиента нужно добавить переменную answer_on_group_chat со значением "1". Тогда бот будет отвечать в этом чате.

Архив чатов

Чаты, добавленные в архив, не обрабатываются

Начало диалога по номеру телефона

Чтобы начать диалог с новым клиентом, в разделе Клиенты нажимаем "Написать в Telegram"

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

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

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

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

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

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

Учитывайте ограничения для создания контактов для Телеграмм-аккаунта.

Подробнее в разделе "Важно знать!".

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

Добавить номер в контакты

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

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

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

group - User id бота, к которому нужно привязать клиента.

Также работают общие методы для калькулятора.

Добавить аккаунт в контакты

create_telegram_client_by_username(username, name, group) - добавляет аккаунт с указанным юзернеймом в контакты в Телеграм-аккаунте и создает соответствующего клиента в Salebot

username - имя пользователя (@user)

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

group - User id бота, к которому нужно привязать клиента.