Важно знать!
При использовании аккаунта действуют ограничения, которые зависят от сценария использования аккаунта. Точных данных нет, но в открытых источниках можно найти примерные значения лимитов.
КРАТКО ОБ ОГРАНИЧЕНИЯХ И РЕКОМЕНДАЦИЯХ!
- При первой синхронизации в новом аккаунте 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 бота, к которому нужно привязать клиента.
Также работают общие методы для калькулятора.
Добавить аккаунт в контакты
create_telegram_client_by_username(username, name, group) - добавляет аккаунт с указанным юзернеймом в контакты в Телеграм-аккаунте и создает соответствующего клиента в Salebot
username - имя пользователя (@user)
name - имя клиента
group - User id бота, к которому нужно привязать клиента.