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

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

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

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

За 30 секунд:

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

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

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

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

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

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

Шаги

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Почему нельзя рассылать в 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
Не получилось? → Канал не работает