Admin Guide

Сообщения

Сообщение — это push-уведомление, отправленное группе пользователей. В разделе «Сообщения» создаются кампании: разовые и запланированные рассылки с гибкими настройками аудитории и содержимого.

Статусы сообщений

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

draft
→
scheduled
→
sending
→
sent
→
cancelled
draft
Черновик

Сообщение сохранено, но не отправлено. Сохраняется как исторический артефакт при некоторых сценариях.

scheduled
Запланировано

Сообщение ожидает наступления указанного времени. Автоматически переходит в sending, когда воркер опрашивает очередь (каждые 15 секунд).

sending
Отправляется

Воркер активно рассылает уведомления. Аудитория разбивается на пакеты по 500 подписчиков.

sent
Отправлено

Все пакеты обработаны. Доставка завершена — доступна аналитика.

cancelled
Отменено

Сообщение было отменено вручную до начала или во время отправки.

Создание сообщения

Нажмите «Создать сообщение» в toolbar. Форма состоит из трёх блоков.

Блок 1: Аудитория

Определяет, кто получит уведомление.

Отправить всем

Уведомление получат все активные подписчики приложения (все браузеры с разрешением). Используйте для важных общих анонсов.

По сегментам

Выберите один или несколько Include-сегментов (кто получит) и, при необходимости, Exclude-сегменты (кого исключить). Аудитория = объединение Include минус пересечение с Exclude.

💡
Один и тот же сегмент нельзя добавить одновременно в Include и Exclude — система покажет ошибку валидации.

Блок 2: Содержимое уведомления

Выберите источник контента: вручную или из шаблона.

ПолеОбязательноеОписание
ЗаголовокДаЗаголовок уведомления. Рекомендуется до 60 символов — длинные заголовки обрезаются браузером.
ТекстДаТело уведомления. До 120–200 символов в зависимости от платформы.
URLНетСтраница, которая откроется при клике на уведомление. Если не указан — откроется главная страница приложения.
ИзображениеНетURL изображения, отображаемого в уведомлении (большое фото). Поддерживается в Chrome и Edge на десктопе. Рекомендуемый размер: 1080×565.
КнопкиНетДо 2 кнопок действий под уведомлением (текст до 40 символов + ссылка). Персональные переменные работают в обоих полях. Отображаются в Chrome, Edge и Android; Safari и Firefox показывают уведомление без них.
ТегНетКатегория сообщения (slug, например orders или promo). Пользователю не показывается — используется для фильтрации ленты сообщений, истории сообщений пользователя и счётчиков непрочитанных.
ℹ️
Используйте Тег, чтобы разделять сообщения по типам. Тогда сайт сможет показывать в центре уведомлений только новости о заказах или отдельно считать непрочитанные акции: лента и история сообщений в REST API, Bitrix-модуль и метод Web SDK getUnreadCount(tag) принимают фильтр по тегу.

Из шаблона

Переключите источник на «Из шаблона» и выберите нужный шаблон из списка. Поля Заголовок, Текст, URL, Изображение, Кнопки и Тег заполнятся автоматически из шаблона и будут недоступны для редактирования. Для изменения контента — создайте новый шаблон или отредактируйте существующий.

Шаблонные переменные

Поля заголовка, текста, URL, изображения и кнопок поддерживают персональные переменные. Воркер подставляет их для каждого получателя в момент отправки — каждый пользователь может получить свою ссылку или текст. Поле Тег не обрабатывается.

ПеременнаяЧто подставляетсяГде применять
{{ tag.KEY }}Значение тега KEY получателя — своё для каждого пользователяЗаголовок, текст, URL, изображение, кнопки
{{ user.externalId }}External ID получателя (ID пользователя в вашей системе)Заголовок, текст, URL, изображение, кнопки
{{ tag.KEY | default: "…" }}Текст по умолчанию, если тег (или External ID) пустЗаголовок, текст, URL, изображение, кнопки
text
// URL — a personal link for each recipient:
https://example.com/account/{{ user.externalId }}/orders

// URL — a tag value with a fallback when the tag is empty:
https://example.com{{ tag.dropped_view_product_url | default: "/catalog" }}

// Title — personalized greeting:
{{ tag.first_name | default: "Hi" }}, your cart is waiting
💡
Переменные кампании {{ title }}, {{ sendDate }}, {{ messageId }} подставляются только в настройках UTM (Настройки → Конфигурация → UTM), а не в полях сообщения. Используйте их там, чтобы добавить заголовок кампании, дату отправки или ID сообщения в UTM-параметры всех ссылок.

Персональные переменные из тегов пользователя

Самая полезная переменная — индивидуальный тег пользователя, то есть значение, которое хранится в профиле каждого конкретного подписчика. Она работает в URL и других перечисленных выше полях. Синтаксис:

{{ tag.KEY }}— подставляет значение тега KEY для каждого получателя индивидуально

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

Пример: брошенный просмотр товара

1
На сайте: устанавливаем тег пользователю

Когда пользователь просматривает товар, ваш сайт записывает тег. В Пользователи → карточка пользователя → Теги вы увидите:

js
// Tag is set automatically by your site
// when the user views a product page.
//
// In Users → user profile → Tags you will see:
//
//   Key                          Value
//   dropped_view_product_url     /products/iphone-15-pro
//   last_category                electronics
2
В шаблоне сообщения: используем тег в URL

В поле «Click URL» шаблона указываем переменную:

text
// "Click URL" field in the message template:
https://example.com{{ tag.dropped_view_product_url }}
3
При отправке: каждый получает свою ссылку

Воркер подставляет значение тега для каждого пользователя:

text
// User user-42 (tag = "/products/iphone-15-pro"):
→  https://example.com/products/iphone-15-pro

// User user-99 (tag = "/products/samsung-s24"):
→  https://example.com/products/samsung-s24

// User user-01 (tag not set):
→  https://example.com  ← empty string instead of variable
⚠️
Если тег не установлен у пользователя — переменная заменяется пустой строкой. URL вида https://example.com будет работать как ссылка на главную. Лучше заранее сегментировать аудиторию: отправляйте кампанию только тем, у кого тег dropped_view_product_url существует. Для этого в сегменте добавьте правило «Тег "dropped_view_product_url" существует».

Где настраиваются теги пользователей

Теги хранятся в профиле каждого пользователя и управляются из раздела Пользователи:

1
Перейдите в Пользователи и найдите нужного по External ID.
2
Откройте карточку пользователя — блок «Теги» отображает все установленные теги с их ключами и значениями.
3
Доступные действия:
  • Добавить тег — кнопка «+» в заголовке блока → укажите ключ и значение.
  • Редактировать — кнопка «⋮» напротив тега → «Редактировать» → измените ключ или значение → Сохранить.
  • Удалить — кнопка «⋮» → «Удалить».
ℹ️
Теги устанавливаются автоматически вашим сайтом в момент события (просмотр товара, добавление в корзину и т.д.). Ручное управление в админке полезно для отладки, корректировки значений или добавления тестовых тегов перед запуском кампании.

Блок 3: Режим отправки

Отправить сейчас

Сообщение немедленно ставится в очередь и начинает доставляться активным подписчикам. Статус сразу становится sending.

Запланировать

Укажите дату и время в будущем. Сообщение получает статус scheduled и будет отправлено автоматически в указанный момент. Запланированное сообщение можно отменить пока оно не перешло в sending.

Предпросмотр

В форме создания отображается живой предпросмотр уведомления — как оно будет выглядеть на устройстве пользователя (с заголовком, текстом и URL). Проверьте его перед отправкой.

Аналитика сообщений

На детальной странице каждого отправленного сообщения доступна воронка доставки:

Sent

Количество подписчиков, которым была предпринята попытка доставки.

Delivered

Уведомление показано на устройстве — это подтвердил service worker или мобильное приложение.

Clicked

Пользователь нажал на уведомление.

Failed

Доставка не удалась (истёкший endpoint, сетевая ошибка).

CTR

Clicked ÷ Delivered × 100%. Показатель вовлечённости аудитории.

ℹ️
CTR (Click Through Rate) = Clicked ÷ Delivered × 100%. Хороший показатель для web push — 5–15% в зависимости от тематики.

Отмена запланированного сообщения

Откройте детальную страницу сообщения в статусе scheduled и нажмите «Отменить». После перехода в статус sending отмена невозможна — доставка уже началась.

Связи с другими разделами

← Сегменты

Создайте сегменты заранее, чтобы использовать их в поле «По сегментам».

← Шаблоны

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

← Настройки → UTM

Если включены UTM-параметры, они автоматически добавляются к URL всех отправляемых уведомлений из этого приложения.