База знаний GetMyBot

Рассылки

Как отправить новость или напоминание группе клиентов: выбрать сообщение, каналы и аудиторию, проверить отправку и посмотреть результат.

На этой странице

Рассылка отправляет одно подготовленное сообщение многим людям. Например, приглашение на занятие всем с меткой «Интересуется курсом». Сначала выберите текст, аудиторию и каналы, затем проверьте получателей и запустите отправку.

В GetMyBot есть два способа:

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

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

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

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

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

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

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

Аудитория и эксперимент. Либо все подписчики бота, либо один готовый сегмент, либо аудитория 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, и рассылка переживает перезапуск: она выполняется постранично и продолжает с сохранённого места.

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

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

Что дальше