For the complete documentation index, see llms.txt. This page is also available as Markdown.

Telegram бот для личных сообщений

Важно знать!

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

ПОДРОБНЕЕ ОБ ОГРАНИЧЕНИЯХ

Контакты

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

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

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

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

в) После достижения лимита в 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. Platform — выберите WEB.

  5. 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 бота, к которому нужно привязать клиента.

Последнее обновление