Рассылки

В GetMyBot есть два способа разослать сообщение подписчикам, и они работают одновременно:

• Раздел «Рассылки» (/app/broadcasts): полноценный редактор: один документ контента, выбор каналов, аудитория по сегменту, расписание, проверка перед отправкой и отчёт по каналам. Это основной способ.
• Кнопка «Рассылка» у реакции: быстрая отправка готовой реакции всем активным подписчикам, без черновика и без предварительной проверки. Способ остался и никуда не денется.

Обоим нужны тариф с функцией рассылок и право бота «Реакции». Без функции в тарифе создание рассылки отвечает ошибкой оплаты, без права раздел показывает пустой экран с подсказкой.

Редактор рассылки

Раздел Рассылки в левом меню. Кнопка Создать рассылку открывает редактор из четырёх блоков.

Название и каналы. Название до 160 символов и один или несколько каналов: Telegram, VK, WhatsApp, Веб-чат, Email. Мессенджеры и веб-чат можно комбинировать в одной рассылке, email: нельзя: у письма отдельный вид контента, а рассылка хранит ровно одну ссылку на документ. Поэтому выбор Email снимает остальные каналы, а выбор любого другого канала снимает Email.

Контент. Выбирается опубликованная версия контента подходящего вида: для email: документ вида «письмо», для остальных каналов: документ вида «сообщение». Рассылка запоминает идентификатор документа вместе с номером версии, поэтому последующая публикация того же документа не изменит уже созданную рассылку. Прямо отсюда можно создать новый контент или редактируемую копию текущего: после сохранения копия публикуется и подставляется в рассылку. Рассылка умеет все блоки конструктора, включая голосовые, GIF, видеокружки и карусели (в VK карусель уйдёт серией сообщений).

Тут же работает предпросмотр по каждому выбранному каналу. Если выбрать получателя для теста, предпросмотр подставит его данные, а кнопка Отправить тест отправит контент этому одному подтверждённому контакту. Тест идёт по тому же пути с квотами и лимитами, что и тестовая отправка из Студии контента: строки получателей рассылки он не трогает, произвольный адрес ввести нельзя, а слишком частые тесты отклоняются.

Аудитория и эксперимент. Либо все подписчики бота, либо один готовый сегмент, либо аудитория bot_chats – чаты и каналы бота: группы, супергруппы и каналы, куда бот добавлен (реестр пополняется автоматически, когда бота добавляют в чат или делают администратором). Для чатов можно отметить конкретные чаты галочками; без отметок рассылка уйдёт во все чаты, где у бота есть право писать. Такая аудитория работает только с каналом Telegram: при её выборе остальные каналы снимаются. Чаты, где бот удалён или не может писать, и незнакомые id попадают в исключённые с причиной (bot_left, cannot_post, chat_unknown). Персонализация по подписчику ({{profile.*}}, {{event.*}}) в чатах не подставляется. Необязательно можно привязать запущенный A/B-эксперимент.

Расписание. Часовой пояс рассылки, интерпретация времени, время отправки и скорость.

• Время отправки необязательно: пустое поле означает «отправить сразу после подтверждения».
• По времени бота: один и тот же абсолютный момент для всех, посчитанный в часовом поясе рассылки.
• По местному времени получателя: то же время на часах у каждого получателя. Если у человека нет часового пояса, пояс не распознан или такого времени в его поясе в этот день не существует, он получит сообщение по времени рассылки. Это отличие от email-рассылок, где такой получатель исключается.
• Время, которого не существует из-за перевода часов, редактор не принимает и пишет об этом под полем.
• Сообщений в минуту: от 1 до 10 000. Отправка растягивается пачками этого размера: первым 60 (при значении 60) назначается стартовое время, следующим 60: минутой позже и так далее.

Если для бота включены платные рассылки и среди каналов есть Telegram, появляется переключатель платной рассылки за звёзды Telegram и отдельная галочка подтверждения: без неё черновик не сохранится. Если переключатель платных рассылок у бота выключат уже после создания черновика, отправка не сорвётся: она просто уйдёт как бесплатная.

Проверка перед отправкой

Кнопка Проверить получателей ничего не отправляет. Она собирает аудиторию по текущему черновику, каналам и правилам согласий и отвечает, сколько человек получит рассылку по каждому каналу, сколько исключено и почему, а также какие в контенте ошибки и предупреждения.

Причины исключения:

• no_identity: у подписчика нет контакта в этом канале;
• unverified: контакт не подтверждён;
• blocked: подписчик заблокирован;
• channel_disabled: канал у бота не подключён или выключен;
• email_unsubscribed, email_bounced, email_complained, email_no_consent: состояние почтового согласия не «подписан»;
• wa_window_closed: в WhatsApp от человека не было входящего сообщения последние 24 часа, поэтому свободное сообщение отправить нельзя.

Запуск блокируют ошибки:

• content_not_published: выбранной версии контента нет или она не опубликована;
• audience_not_ready: сегмента нет или он ещё не пересчитан;
• experiment_not_ready: привязанный эксперимент не запущен либо распределяет не по подписчикам;
• empty_audience: рассылку не получит никто;
• ошибки валидации контента по каждому каналу: в поле указано content:<канал>, например content:wa.

Предупреждения контента показываются рядом и запуск не блокируют. Кнопка запуска включается только при нуле ошибок и хотя бы одном получателе.

Запуск и управление

Запустить можно только черновик, и только из блока проверки: кнопка называется Отправить сейчас или Запланировать, в зависимости от того, задано ли время отправки. Запуск требует явного подтверждения и ревизии, которая сейчас на экране.

В этот момент рассылка материализуется одной транзакцией: версия контента, каналы, аудитория, эксперимент и расписание фиксируются, каждому подходящему получателю создаётся сообщение в очереди с рассчитанным временем, а каждому исключённому: строка с причиной, но без сообщения. Поэтому исключённого потом невозможно спутать с неудачной отправкой.

После запуска рассылка неизменяема: редактор открывается только для чтения и предлагает создать новую рассылку, если нужно что-то поменять.

Статусы: Черновик, Запланирована, Отправляется, На паузе, Завершена, Отменена, Не удалась, В архиве. Из каких статусов доступны действия:

• Поставить на паузу: из «Запланирована» или «Отправляется». Сообщения, ещё не взятые в работу, перестают выдаваться; те, что уже отправляются, дойдут.
• Продолжить: из «На паузе», обратно в «Отправляется».
• Отменить: из «Черновик», «Запланирована», «Отправляется» или «На паузе». Всё, что ещё не ушло, помечается отменённым.
• В архив: из «Завершена», «Отменена» или «Не удалась». Архивные рассылки видно по переключателю Показывать архивные рассылки.

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

Отчёт и получатели

Клик по рассылке в списке открывает результаты. По каждому каналу показываются: В очереди, Отправлено, Доставлено, Ошибки, Исключены. Пока рассылка запланирована, отправляется или стоит на паузе, отчёт обновляется сам раз в 15 секунд.

Для рассылки по чатам и каналам бота отчёт дополнительно показывает таблицу По чатам: каждый чат с названием, статусом доставки (в очереди, отправлено, ошибка, отменён) или причиной исключения. Счётчики канала Telegram считают чаты, а не подписчиков. Пауза, возобновление, отмена и ограничение «сообщений в минуту» работают так же, как для рассылок по подписчикам.

Счётчик Доставлено на этом уровне остаётся нулевым: платформа знает, что сообщение отправлено в канал, но подтверждения доставки в этот отчёт не собирает. Для почты подробная картина: открытия, переходы, возвраты, жалобы: есть в email-рассылках.

Заблокировали после рассылки – число получателей, которые заблокировали бота в течение 24 часов после доставки именно этой рассылки (блокировка засчитывается последней доставленной рассылке в этом окне). Считаются события блокировки, а не уникальные подписчики. Список таких людей: экран «Люди» → чип Заблокировали → «Выгрузить CSV» (колонка blocked_at).

Кнопка Получатели открывает постраничный список, который показывает только канал, статус (Ожидает, Исключён, В очереди, Отправляется, Отправлено, Ошибка, Отменён) и причину исключения. Отдельной колонки с получателем нет.

Одно ограничение стоит держать в голове: если контент для одного получателя разворачивается в несколько сообщений, рассылка отправит только первое. Рассылка ведёт одну строку получателя на пару «получатель и канал».

Рассылка реакции из списка реакций

Старый способ работает как раньше. В списке Реакции у каждой реакции есть кнопка с иконкой отправки и подсказкой «Разослать реакцию подписчикам». Нажатие сразу ставит рассылку в очередь: черновика, проверки перед отправкой и отчёта по каналам здесь нет. В диалоге можно включить платную рассылку за звёзды, если она разрешена для бота. Кнопка Рассылка на экране Обзор ведёт в тот же список реакций.

Такая рассылка идёт всем активным подписчикам бота. Сузить её по меткам можно только программно: параметром labels в запросе к API (см. REST API и токены); в интерфейсе выбора меток нет.

Статусы у неё свои и более короткие: ожидает, выполняется, готово, отменена, плюс признак паузы. Пауза, продолжение и отмена доступны по API, и рассылка переживает перезапуск: она выполняется постранично и продолжает с сохранённого места.

Рассылка по расписанию

Реакция с триггером «По расписанию (даты)» срабатывает в заданные моменты и рассылается активным подписчикам автоматически. Так делаются регулярные дайджесты и напоминания без ручного запуска. Повторный запуск после сбоя может продублировать сообщение части подписчиков: для запланированных объявлений редкий дубль считается меньшим злом, чем молча потерянная отправка.

Что дальше

• Студия контента: подготовка и публикация контента рассылки.
• Люди (CRM): метки и сегменты для аудитории.
• Email-рассылки: отдельный сценарий для почты с трекингом и отписками.
• Реакции: основы: подготовка реакции для быстрой рассылки.
• Триггеры: триггер «По расписанию».
• REST API и токены: маршруты рассылок и их scope.