> ## Documentation Index > Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt > Use this file to discover all available pages before exploring further. # Рассылки > Массовые рассылки: боты, контент, аудитория и расписание, медиа и альбомы, переменные, статусы и статистика. Рассылка отправляет одно сообщение сразу группе подписчиков: вручную в момент запуска или по расписанию. Рассылка создаётся из воркспейса, и в ней можно выбрать одного или нескольких ботов этого воркспейса. У каждого бота своя аудитория и своя доставка. Рассылка идёт в рамках лимитов Telegram, но на максимальной допустимой скорости. Если отправка прервётся, она продолжится сама, и никто не получит одно и то же сообщение дважды. Раздел «Рассылки» → кнопка «Новая рассылка». Отметьте одного или нескольких ботов внутри воркспейса. Здесь же можно задать название рассылки: оно видно только вам и админам, подписчики его не увидят. Текст с форматированием, медиа и альбомы, inline-кнопки. В тексте работают переменные вида `{{ first_name }}`. Перед запуском можно отправить тестовое сообщение себе или любому подписчику. Все активные подписчики бота или выборка по фильтру: сохранённому или собранному на месте. Сразу или на конкретную дату и время. До запуска рассылка хранится черновиком и автосохраняется. ## Мастер рассылки Мастер построен на четырёх шагах: «Боты», «Контент», «Аудитория», «Расписание». Наверху виден трекер шагов, снизу кнопки «Назад» и «Далее». На последнем шаге вместо «Далее» будет «Создать и отправить» (при отправке сейчас) или «Запланировать» (при отправке на дату). Мастер открывается кнопкой «Новая рассылка» в разделе «Рассылки» на уровне воркспейса, боты берутся из этого воркспейса. На шаге «Боты» отметьте одного или нескольких, чекбокс на строке воркспейса выделяет сразу всех его ботов. При выборе нескольких ботов одно и то же сообщение уходит подписчикам каждого из них. Каждый бот отправляет самостоятельно, поэтому счётчики (получатели, доставлено, ошибки) считаются отдельно по каждому боту и суммируются в карточке рассылки. На один бот в один момент идёт только одна рассылка. Если бот уже что-то отправляет, новая рассылка на этот бот встанет в очередь и начнётся, когда бот освободится. Так платформа сама держит темп в рамках лимитов Telegram, вручную выставлять задержки не нужно. При редактировании рассылки, начатой на конкретном боте, бот уже зафиксирован, и шаг «Боты» пропускается: мастер открывается сразу на «Контенте». ## Аудитория На шаге «Аудитория» два варианта: * **Все активные подписчики**: отправка всем, кто не заблокировал бота. * **Фильтр**: выборка подписчиков по полям. Можно выбрать сохранённый фильтр или собрать условия прямо в мастере. Фильтры привязаны к конкретному боту, поэтому выбор по фильтру доступен, только когда выбран ровно один бот. При нескольких ботах остаётся вариант «Все активные подписчики». Сохранённые фильтры создаются и переиспользуются в разделе [Фильтры](/ru/filters), а собрать условия на месте помогает тот же конструктор фильтра, что и в [Мессенджере](/ru/messenger). Из аудитории всегда исключаются подписчики, заблокировавшие бота, и заблокированные администратором. Число получателей считается в момент запуска рассылки, а не заранее. За время между тем, как вы собрали рассылку, и стартом кто-то мог подписаться, отписаться или заблокировать бота, поэтому итог иногда немного отличается от ожидаемого. ## Текст и переменные Текст сообщения поддерживает форматирование: жирный, курсив, подчёркнутый, зачёркнутый, спойлер, цитата, код, ссылки, списки. Форматирование сохраняется при вставке из другого источника. ### Переменные Переменная в тексте заменяется на данные конкретного подписчика в момент отправки. Клик по метке переменной в редакторе копирует токен, останется вставить его в текст. Токены переменных всегда на английском и пишутся как есть, переводить или менять их нельзя. Системные переменные: | Переменная | Что подставляется | | --------------------- | ------------------------ | | `{{ first_name }}` | Имя | | `{{ last_name }}` | Фамилия | | `{{ full_name }}` | Имя и фамилия | | `{{ username }}` | @username | | `{{ telegram_id }}` | Telegram ID | | `{{ user_id }}` | Внутренний ID подписчика | | `{{ created_at }}` | Дата подписки | | `{{ date_of_birth }}` | Дата рождения | | `{{ tag }}` | Тег подписчика | | `{{ click_id }}` | Click ID подписчика | Переменные события заполняются после первого постбека по подписчику и подставляют данные последнего события. Это фиксированный набор из шести полей: | Переменная | Что подставляется | | ------------------------- | --------------------------------- | | `{{ event.payout }}` | Сумма события | | `{{ event.currency }}` | Валюта | | `{{ event.trader_id }}` | Идентификатор аккаунта у партнёра | | `{{ event.device_type }}` | Устройство | | `{{ event.os_version }}` | ОС | | `{{ event.link_type }}` | Тип ссылки | Кроме системных, у бота есть кастомные переменные с вашими значениями. Они разные у разных ботов, поэтому подсказка с кастомными переменными доступна, когда выбран один бот. Полный список и управление переменными в разделе [Переменные](/ru/variables). Если у подписчика поле пустое (например, не указано имя), переменная заменится на пустую строку. Подписчик никогда не увидит сырой `{{ first_name }}` в тексте. ### Расширенное форматирование Расширенное форматирование доступно именно в рассылках: заголовки, таблицы, списки, sub/sup и до 32 768 символов в одном сообщении. В конструкторе и диалогах остаётся базовое форматирование. Режим включается для длинных текстовых сообщений и работает только без медиа. Редактор предупредит, если текст превысит лимит Telegram для обычного сообщения или для подписи к медиа. ## Медиа и альбомы К сообщению можно приложить фото, видео, аудио, голосовое или видеосообщение. Ограничения на размер файла: фото до 10 МБ, видео и аудио до 50 МБ. Несколько файлов собираются в альбом по правилам Telegram: * **Фото и видео** группируются в один альбом (от 2 до 10 файлов, микс фото и видео допустим). * **Аудио** собирается в альбом только с аудио, без фото и видео. * **Голосовое и видеосообщение** всегда отправляются отдельными сообщениями. Тип загруженного файла платформа определяет сама, но видео и видеосообщение по формату неразличимы, поэтому для них есть явный выбор подтипа. Если приложена одна картинка или видео, текст уходит подписью к медиа. Если в альбоме несколько файлов или есть голосовое, текст и кнопки могут отправиться отдельным сообщением рядом с медиа. При выборе нескольких ботов одно и то же медиа доставляется через каждого бота своей копией. Загружать файл вручную для каждого бота не нужно, платформа сама подготовит его под каждого. ## Кнопки Под сообщением можно добавить inline-кнопки. Первое поле кнопки это текст на ней, второе поле это действие. Тип действия выбирается переключателем: * **URL**: открывает ссылку. Ссылку можно писать без `https://` или как `@username`, она дополнится автоматически. * **Callback**: ловится блоком сценария в [Конструкторе](/ru/constructor) (до 64 байт). * **Скопировать**: копирует заданный текст в буфер обмена подписчика одним тапом. Удобно для промокодов. Кнопке можно задать стиль оформления (обычная, primary, success, danger). В тексте кнопок тоже работают переменные. ## Тестовая отправка На шаге «Контент» есть кнопка «Отправить тестовое». Она отправляет сообщение в текущем виде выбранному подписчику или вам, с уже подставленными переменными, чтобы увидеть реальный результат до массового запуска. При нескольких ботах сначала выбирается бот для теста, затем получатель. Рядом всегда виден превью-пузырь в стиле Telegram, который показывает сообщение так, как его получит подписчик. ## Расписание и отложенная отправка На шаге «Расписание» два режима: * **Сейчас**: рассылка запускается сразу после подтверждения. * **Запланировать**: выбираете дату и время, рассылка стартует в этот момент. Время в прошлом задать нельзя. Запланированную рассылку видно в списке со статусом «Запланирована» и датой старта, а в превью подписью «Запланировано на ≈ время». До старта её можно отредактировать, а через меню карточки запустить раньше срока действием «Запустить сейчас» или отменить. ## Черновики Пока рассылка не запущена, она автоматически сохраняется черновиком. Если закрыть мастер с несохранёнными правками, платформа предложит сохранить черновик, а при возврате к нему можно продолжить с того же места или начать заново. Черновик без названия называется по первым словам сообщения, а если текста ещё нет, получает имя вида «Рассылка от ДД.ММ ЧЧ:мм». Готовый черновик можно продублировать через меню карточки действием «Дублировать»: создастся копия-черновик с тем же содержимым и составом ботов, но без расписания. Черновик, у которого не хватает данных для запуска (не выбран ни один бот или пустое сообщение), не отправится. Мастер подскажет, какие поля нужно заполнить. ## Статусы и статистика Список рассылок фильтруется по статусу: «Все», «Черновики», «Запланированные», «Отправляются», «Отправленные», «Отменённые». Статусы самой рассылки: | Статус | Значение | | ------------- | ---------------------------------------------- | | Черновик | ещё не запущена, автосохраняется | | Запланирована | ждёт назначенного времени | | Отправляется | идёт доставка | | Завершена | доставлена всей аудитории | | Частично | у части ботов завершилась, у части были ошибки | | Отменена | остановлена вручную | | Ошибка | доставка не удалась | По ходу и после отправки в карточке и в превью видна статистика: «Получатели», «Доставлено», «Нет чата», «Заблокировали», «Ошибка». Счётчики обновляются в реальном времени. У черновика статистики нет, вместо неё показывается «Сохранено ... назад». Статус **«Нет чата»** означает, что у бота нет личного чата с этими подписчиками. Telegram не даёт писать первым, пока подписчик сам не напишет боту (частый случай: человек зашёл по инвайт-ссылке и не ответил). Такие подписчики не считаются заблокировавшими и станут доступны для рассылки, как только напишут боту. Про инвайт-ссылки смотрите [Трекер](/ru/tracker). ## Лимит истории рассылок На каждого бота хранится история из последних 100 рассылок (черновики в лимит не входят). Когда рассылок становится больше, самые старые уже завершённые рассылки автоматически удаляются, чтобы не копить лишнее. Вместе со старой рассылкой удаляются и её сообщения в переписках подписчиков. Если нужно сохранить содержание рассылки надолго, держите её текст отдельно. ## Права и баланс Запуск рассылки доступен ролям manager и выше на соответствующих ботах. Роль operator рассылки не запускает. Перед запуском платформа проверяет баланс компании. Если средств не хватает на рассылку по текущей аудитории, запуск не пройдёт. Пополнение и тарификация в разделе [Биллинг](/ru/billing). ## Автоматические сообщения по событию Раздел «Рассылки» отвечает за разовые и запланированные отправки вашим подписчикам. Если нужно, чтобы сообщение уходило автоматически в ответ на действие подписчика (подписался, нажал кнопку, пришёл постбек по событию), это настраивается сценарием в [Конструкторе](/ru/constructor): там живут приветственные цепочки, догоняющие сообщения и воронки по триггерам. За живой диалог, который сам продолжает переписку, отвечает блок [ИИ-оператора](/ru/ai-operator). Автоматические цепочки и воронки по триггерам: приветствия, догоняющие сообщения, реакции на события. Диалоги с подписчиками. В меню бота этот раздел называется «Сообщения». Сохранённые выборки подписчиков, которые задают аудиторию рассылки. Баланс и тарификация отправленных сообщений.