Рассылки
Рассылка отправляет сообщения от вашего Telegram-бота выбранному сегменту клиентов.
Где открыть: #/broadcasts — Продажи.
Порядок работы
- Создайте текст.
- выберите аудиторию.
- проверьте предпросмотр.
- отправьте тест себе.
- назначьте время или запустите отправку.
Проверка доставки
Проверьте текст, ссылки, кнопки и выбранный сегмент на тестовой отправке. После запуска смотрите доставленные сообщения и ошибки. Если отправка остановилась, проверьте sn-worker и доступ к Telegram. Не перезапускайте рассылку новой копией до проверки уже обработанной очереди.
Проверка результата
Запущенная отправка обращается к реальным людям. Отмена останавливает оставшуюся очередь, но не удаляет уже доставленные сообщения. Telegram не сообщает факт прочтения боту.
Связанные инструкции
Первый запуск · troubleshooting
Служба рассылок и ошибки
Отправка выполняется службой sn-worker отдельным циклом. В панели виден её последний сигнал; перед запуском проверяются готовность службы и наличие токена бота. Результаты обновляются каждые 10 секунд.
Неверная HTML-разметка, неподходящая ссылка кнопки и неверный токен останавливают рассылку с текстом ошибки. Откройте рассылку и проверьте причину; для исправленного сообщения создайте копию. Ошибка одного задания не блокирует другие. Блокировка бота или удалённый чат учитываются как ошибки конкретных получателей. Ограничение Telegram retry_after переносит повтор на указанное время; временные сбои повторяются не более восьми раз на получателя.
Отправить тест доставляет сохранённые фото, текст и кнопку на указанный Telegram ID. Получатель должен запустить бота. Плейсхолдер имени использует имя администратора, тариф и срок в тесте обозначены «—». Тест не запускает рассылку аудитории.
У Telegram нет ключа идемпотентности для sendMessage и sendPhoto: при потере ответа после доставки повтор может дать дубль. Уже подтверждённые отправки не повторяются. Во время диагностики не создавайте повторную копию отправляющегося задания.
Фото в рассылке
В новой рассылке нажмите Прикрепить фото и выберите JPG, PNG или WebP с устройства. Появится предпросмотр; рядом можно заменить или удалить фото. Нажмите Сохранить черновик, чтобы сохранить изменения. Копия рассылки сохраняет фото исходной версии.
Можно отправить одно фото с подписью и кнопкой или только фото. Подпись ограничена 1024 символами, сообщение без фото — 4096. Счётчик учитывает введённую HTML-разметку; оставляйте запас для подстановок имени, тарифа и срока. Если текст длиннее лимита, сократите его или удалите фото. Тестовая отправка использует сохранённые фото, подпись и кнопку; несохранённые изменения не отправляются.
Файл: до 10 МБ и 16 Мп, сумма ширины и высоты до 10000 пикселей, соотношение сторон до 20:1. API проверяет содержимое, декодирует изображение, убирает метаданные и сохраняет его как JPEG или PNG. Предпросмотр доступен только авторизованным сотрудникам с правом чтения рассылок. Фото хранятся в PostgreSQL, включаются в резервную копию базы и сохраняются при make update; отдельный каталог или публичная ссылка не нужны. Несохранённые загрузки старше суток очищаются при следующей загрузке того же сотрудника.
Проверка: сохраните черновик, откройте его снова, убедитесь, что фото видно, затем отправьте тест на свой Telegram ID. В Telegram должны прийти фото, подпись и настроенная кнопка одним сообщением. Ограничения Telegram: sendPhoto.