Рассылку клиентам лучше запускать как отдельную кампанию с очередью получателей, а не длинным циклом внутри кнопки «Отправить». До рабочего запуска испытайте остановку и отписку на собственных тестовых аккаунтах. Список контактов из CRM сам по себе не означает, что этим людям можно отправлять сообщения через бота.

Согласуйте состав аудитории, основание отправки и простой способ прекратить такие сообщения. Ниже разбирается техническая организация разрешённой рассылки; юридические требования и основание обработки данных нужно определить отдельно для вашего случая. Не импортируйте случайные chat_id из чужих списков.

Кампания и получатель — разные записи

Условная модель, не схема конкретного сервиса:
campaign: draft -> approved -> running -> paused -> completed
recipient: pending -> sending -> accepted
other results: opted_out / failed / uncertain

Зафиксируйте версию текста, автора утверждения и правило выборки. Для каждого получателя храните состояние задания и номер попытки. Уникальность пары «кампания — получатель» защищает от двойного добавления при повторном импорте. Состояние accepted означает принятие запроса API по успешному ответу; это не доказательство прочтения клиентом.

Получателей можно сформировать заранее, но актуальное разрешение проверяют непосредственно перед отправкой. Иначе человек отпишется после создания очереди и всё равно получит отложенное сообщение. Пауза кампании также должна проверяться исполнителем, а не только выключать кнопку в админке. Уже принятые внешним API сообщения пауза не возвращает.

Темп задаётся ответами API

В Telegram FAQ описаны ограничения для отдельного чата и массовой отправки, превышение сопровождается ошибками 429. Не включайте платные рассылки как скрытое средство ускорения: это отдельное решение владельца. Лимиты проверены по официальному FAQ 11 октября 2026 года; скорость вашей очереди подбирают с учётом других сообщений того же бота.

ОтветДействие очередиЧего избегать
Успешный ответСохранить возвращённый результатПовтора уже завершённого задания
429 с retry_afterОтложить повтор на указанное ожиданиеНемедленного цикла повторов
Постоянный отказ получателяЗакрыть задание по классификации ошибкиБесконечной переотправки
Связь оборвалась без ответаПометить результат неопределённымУтверждения, что сообщение не отправлено

Bot API определяет retry_after как число секунд ожидания до повтора при ограничении частоты. Это конкретный сигнал для планировщика. Одновременно установите предел попыток и общей продолжительности кампании по своим требованиям. Не позволяйте одному отказу бесконечно задерживать всех остальных клиентов. Секретный токен из URL запроса не попадает в журнал ошибок.

Самая неудобная строка отчёта

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

Для рекламной кампании и критического изменения статуса решения могут различаться. Отчёт должен разделять «принято API», «отказано», «отписался», «ещё ждёт» и «результат неизвестен». Процент доставки, полученный простым вычитанием ошибок из списка, скрывает незавершённые задания. Показывайте состояние всей кампании и дату последнего обновления отчёта.

Репетиция на малой аудитории

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

Перед разработкой рассылки подготовьте разрешённую аудиторию, правила отписки, пример текста и решение о повторе после неизвестного ответа. Такой набор превращает «разослать всем» в контролируемый процесс. Запуск на клиентах допустим только после проверки остановки; удаление очереди не является способом отозвать уже отправленное сообщение.

Проверенные источники