Рассылку клиентам лучше запускать как отдельную кампанию с очередью получателей, а не длинным циклом внутри кнопки «Отправить». До рабочего запуска испытайте остановку и отписку на собственных тестовых аккаунтах. Список контактов из 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», «отказано», «отписался», «ещё ждёт» и «результат неизвестен». Процент доставки, полученный простым вычитанием ошибок из списка, скрывает незавершённые задания. Показывайте состояние всей кампании и дату последнего обновления отчёта.
Репетиция на малой аудитории
- Согласовать тестовый текст и отправить только собственным аккаунтам.
- Поставить кампанию на паузу: новые отправки прекращаются в пределах принятого протокола.
- Отписать одного получателя до его очереди: задание не отправляется.
- Повторить импорт: число уникальных заданий не растёт.
- Смоделировать неопределённый ответ и увидеть отдельную строку отчёта.
Перед разработкой рассылки подготовьте разрешённую аудиторию, правила отписки, пример текста и решение о повторе после неизвестного ответа. Такой набор превращает «разослать всем» в контролируемый процесс. Запуск на клиентах допустим только после проверки остановки; удаление очереди не является способом отозвать уже отправленное сообщение.