Подключение личного аккаунта Telegram
Важно знать!
При использовании аккаунта действуют ограничения, которые зависят от сценария использования аккаунта. Точных данных нет, но в открытых источниках можно найти примерные значения лимитов.
КРАТКО ОБ ОГРАНИЧЕНИЯХ И РЕКОМЕНДАЦИЯХ!
При первой синхронизации в новом аккаунте Telegram (только что зарегистрированном) можно добавлять любое количество контактов;
Если аккаунт уже был ранее создан, то ограничение на добавление контактов — 200 контактов.
Если аккаунт новый и Вы ранее добавляли контакты, ограничение — 200 контактов.
Можно добавлять контакты вручную, если вы превысили лимит в 200 контактов, но добавлять вручную можно не более 15 в день.
Добавляйте вручную контакты постепенно (в течение всего дня). Если добавить сразу 15 контактов в 5-10 минут, в один час, то на следующий день сможете добавить только 5 контактов, далее превысив лимит в пять контактов, сможете добавить только один контакт в день.
Если добавлять 15 контактов в течение дня, то на следующий день лимитов не устанавливается.
В день можно отправить до 40 сообщений в разные чаты, затем включается временная блокировка.
ПОДРОБНЕЕ ОБ ОГРАНИЧЕНИЯХ
Контакты
Чтобы отправить сообщение по номеру телефона, нужно сначала сохранить его в список контактов Telegram:
Синхронизация со списком контактов:
а) Если аккаунт только что создан и номер ранее не был зарегистрирован в Telegram, при первой синхронизации можно импортировать любое количество контактов.
б) Если номер уже использовался при регистрации аккаунта в Telegram, то при первом импорте добавляется максимум 200 контактов. То же ограничение действует, если номер впервые был привязан к Telegram, но синхронизация выполняется повторно.
в) После достижения лимита в 200 записей новые контакты можно вносить только вручную.
Создание контактов вручную
При массовом добавлении за короткий промежуток времени (например, 15 номеров за минуту) на следующий день разрешено добавить не более 5 контактов.
Если в этот день быстро внести ещё 5, то в последующие дни лимит снизится до 1 контакта в день.При равномерном добавлении (например, 15 номеров за целый день) на следующий день доступен тот же объём.
Ограничение не обнуляется со временем.
Сам Telegram сообщает:
«У нас есть защитные меры, чтобы предотвратить импорт слишком большого количества контактов ... После того, как вы получите запрет на импорт контактов, вы можете добавить максимум пять новых номеров в день. Остальные контакты, которые вы добавляете, будут выглядеть так, будто они не используют Telegram, даже если используют».
Совет: лучше добавлять контакты постепенно в течение суток, чтобы избежать ограничения по лимитам.
Ограничения на добавление по username
Если у пользователя есть username, то сохранять его в контакты не нужно — можно писать напрямую. Но поиск таких пользователей ограничен примерно 200 запросами в сутки.
Недопустимость спама
За частую отправку сообщений или за отправку сообщений в большое количество диалогов обязательно от Telegram поступит временный или перманентный бан аккаунта.
В отличие от временного ограничения (на несколько минут, часов или дней), перманентный бан означает, что доступ к аккаунту будет закрыт навсегда. Обычно такая мера применяется за серьезные нарушения правил — массовый спам, мошенничество, рассылку запрещённого контента или многочисленные жалобы от пользователей.
В день можно отправить до 40 сообщений в разные чаты, затем включается временная блокировка.
При регулярном превышении лимита блокировки становятся более долгими: от минут до часов, дней и недель, вплоть до бессрочной блокировки.
При рассылке одинаковых сообщений подряд без пауз блокировка может наступить после нескольких отправок.
Если содержимое классифицируется как спам, блокировка может быть применена сразу и навсегда.
При жалобах на сообщения блокировка также неизбежна.
Ознакомиться со всеми возможными ограничениями вы можете в открытом источнике.
Подготовка к работе
Перед подключением аккаунта необходимо получить api_id и api_hash .
Для этого переходим на https://my.telegram.org и заходим в свой аккаунт.

После авторизации переходим в "API development tools":

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

Поле app title — заполняется без пробелов и каких-либо символов, только буквами (без подчеркивания, запятых и тд)
Поле short name — заполняется без пробелов и каких-либо символов, только буквы и цифры (без подчеркивания, запятых, точек, тире, дефисов и т.п.)
поле URL — действующая ссылка вашего сайта.
Platform — выберите WEB.
Description — описание (желательно, на латинице).
Затем нажмите Create application.
Если вы увидели следующее уведомление:

То вы заполнили какие-либо поля неверно либо названия в полях 'app title' и 'short name' уже заняты, необходимо выбрать другие наименования.
Если вы заполнили все верно, то увидите следующие данные:

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


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

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

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

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

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

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

После завершения импорта, будут созданы клиенты, добавление в контакты которых возможно по номеру телефона.
ОБРАЩАЕМ ВНИМАНИЕ!
Учитывайте ограничения для создания контактов для Телеграмм-аккаунта.
Подробнее в разделе "Важно знать!".
Методы калькулятора
create_telegram_client(phone, name, group) - добавляет указанный номер в контакты в Телеграм аккаунте и создает соответствующего клиента в Salebot
phone - телефон клиента
name - имя клиента
group - User id бота, к которому нужно привязать бота
Также работают общие методы для калькулятора.
Last updated