Рассылка Telegram-бота: подписчики, отправка и учёт ошибок

Что нужно для работающей рассылки

Нужны зарегистрированный бот, обработчик Bot API и база получателей, с которыми бот может взаимодействовать. Для уведомлений храните chat_id, основание подписки, её тему и возможность отключения. Токен, полученный у BotFather, сам по себе не создаёт очередь сообщений.

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

Схема реализации

1. Создайте бота через BotFather и сохраните токен в настройках своего сервера.
2. Подключите получение обновлений одним способом: webhook или long polling.
3. Добавьте действия подписки и отказа. Сохраняйте chat_id из события, а не номер телефона из таблицы.
4. Подготовьте отдельную запись кампании и список подходящих подписчиков.
5. Отправляйте сообщения с учётом ответов API. Сохраняйте результат для каждой записи, чтобы после сбоя не отправить всем повторно.
6. Показывайте в отчёте отправленные сообщения, отказы, ожидания и ещё не обработанные записи.

Ошибка не равна отсутствию подписчика

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

Пример учёта: 100 подписчиков, пять отключили уведомления до запуска. В задачу попадают 95. После выполнения сумма успешных, ошибочных и незавершённых записей должна объяснять эти 95. Числа учебные.

Можно ли сделать бесплатно

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

Telecobra имеет собственные сценарии работы с аккаунтами. Для них используйте настройку кампании. Эта статья не выдаёт модуль пользовательских аккаунтов за готовый Bot API-бот.

Чек-лист перед запуском

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

Источники и документация

• Telegram: FAQ о ботах
• Telegram Bot API

Продолжить по теме

• Бот-рассылки против каналов →
• Автоответчик Telegram Business, бот и AI: как выбрать и настроить →