Документация › Инструменты бота › Рассылки

Рассылки по базе контактов

Появилась акция или новость? Отправь сообщение сразу всей своей базе в Telegram, с сегментами, отложенным запуском и кнопками.

⏱ 7 мин · 👤 для владельца и админа · 🟢 live

За 30 секунд:
Раздел «Рассылки» в меню проекта: массовое сообщение по своим контактам.
Только Telegram. WhatsApp недоступен намеренно: массовая отправка грозит баном номера.
Сегментируй по статусу лида, тегу или рекламной кампании; перед отправкой видно охват (сколько получателей).
Можно отложить на будущее время и прикрепить кнопки (ответ/ссылка).
Кто написал «стоп», исключается автоматически. Отправка идёт постепенно (бережно к анти-бану).

Раздел «Рассылки»: массовая отправка по сегментам с отложенным запуском

Зачем это нужно

Дожимы напоминают о себе одному клиенту по таймеру. А рассылка это когда нужно сказать всем сразу: «в субботу скидка 20%», «открылся новый филиал», «записи на январь открыты». Раньше для этого пришлось бы вручную писать каждому, теперь это одно сообщение и пара кликов.

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

Что понадобится

☐ Подключённый Telegram-канал (рассылки работают только по нему).
☐ Роль владелец или админ проекта (раздел доступен только им).
☐ Желательно, настроенные теги, чтобы точно выбрать, кому слать.

Шаги

1. Открой раздел «Рассылки»

В меню проекта нажми «Рассылки». Создай новую это кнопка вверху.

2. Выбери, кому отправить (сегмент)

Сузь аудиторию любым из фильтров (или оставь пустым, уйдёт всей базе Telegram):

Статус лида: например только «горячие» или «потенциальные».
Тег: например «постоянный клиент» или «был на пробном».
Рекламная кампания: только тем, кто пришёл по конкретной рекламной ссылке.

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

3. Напиши сообщение и (по желанию) добавь кнопки

Введи текст. Можно прикрепить до 8 кнопок:

Кнопка-ответ: клиент жмёт, бот получает её как сообщение и продолжает диалог.
Кнопка-ссылка: открывает URL (только http/https).

4. Отправь сейчас или запланируй

Сейчас: рассылка уходит в очередь и начинает рассылаться постепенно.
На потом: укажи дату и время; рассылка будет ждать в статусе «запланирована» и стартует сама в нужный момент.

Проверь, что работает

Статус рассылки меняется: черновик → запланирована → в очереди → отправляется → отправлено. В списке видно счётчики (сколько ушло). Запущенную рассылку можно отменить, пока она в очереди или ещё идёт.

Частые ошибки

Симптом	Причина	Что нажать
Нет канала для рассылки	Не подключён Telegram	Подключить Telegram
Охват = 0	Слишком узкий сегмент или нет Telegram-контактов	Ослабь фильтр (убери тег/статус)
Хочу слать в WhatsApp	Намеренно недоступно (риск бана номера)	Используй Telegram

Вопросы, которые обычно возникают

Почему нельзя рассылать в WhatsApp?
Массовая отправка с подключённого номера WhatsApp: самый быстрый путь к его блокировке. Поэтому рассылки ограничены Telegram на уровне системы, а не спрятаны в интерфейсе.

А если человек просил больше не писать?
Контакты, которые написали «стоп» (отписались), исключаются из любой рассылки автоматически: отправлять им повторно нельзя.

Это то же самое, что дожимы?
Нет. Дожимы: авто-напоминания одному клиенту по таймеру после его действия. Рассылка: разовое сообщение сразу многим.

Под капотом (для разработчиков и любопытных)

Таблица project_broadcasts: scheduled_at (NULL = сейчас), buttons JSONB, статусы draft → scheduled → queued → sending → sent / failed / canceled.
API проекта: GET (список + ?count=1 превью охвата), POST (создать, снимок сегмента в строки-получатели, статус queued), PATCH {action:"cancel"}. Гейт: owner/admin.
Telegram-only хардлимит на слое данных: фильтр сегмента всегда добавляет .like("chat_id", "tg_%") и .eq("broadcast_opt_out", false). Поле channel сегмента: вестигиальное, WhatsApp исключён намеренно (ban-risk).
Сегмент: lead_status (.eq), tag (.contains tags), campaign (.filter full_data->source_detail->>campaign). Один и тот же фильтр применяется и к превью-COUNT, и к материализации, не могут разойтись.
Кнопки санитизируются как inline-кнопки бота: ≤8, label ≤64, url-кнопки только http(s).
Отправка paced воркером drip-tick (бережно к анти-бану); он же промоутит scheduled → queued по наступлению scheduled_at.

Простыми словами

Это как разослать одно объявление сразу всем своим клиентам в Telegram, но аккуратно: можно выбрать, кому именно (например только постоянным), приложить кнопку «Записаться», запустить сейчас или поставить на завтра. Тем, кто просил не беспокоить, ничего не уйдёт. В WhatsApp так нельзя: за массовую рассылку номер банят.

Дальше: → Лиды
Связано: Дожимы · Теги · Telegram
Не получилось? → Канал не работает