Skip to content

Каскады ​

Каскады находятся в разделе Коммуникации → Сервисные сообщения → Каскады.

Каскад доставляет одно сообщение через несколько каналов по очереди: если сообщение не удалось отправить или оно не доставлено за заданное время, каскад переходит к следующему каналу. Так можно начинать с самого дешевого канала и переходить к дорогим только при необходимости.

Например, для кода подтверждения:

  1. Если у клиента есть приложение и он подписан на пуши — отправить mobile push.
  2. Если пуш не доставлен за 20 секунд — отправить письмо.
  3. Если по письму пришел отказ — отправить SMS.

Своего сообщения у каскада нет: каждый шаг-сообщение — это отдельная канальная сервисная рассылка со своим шаблоном. Каскад вызывается через API так же, как канальная рассылка, — по своему коду. Описание API для разработчиков — в разделе Каскады.

Создание каскада ​

  1. Создайте и запустите канальные рассылки для каждого канала каскада.
  2. В разделе Каскады нажмите «Новый каскад».
  3. Заполните поля и нажмите «Сохранить». ЛК сразу откроет редактор дерева правил.
  4. Соберите дерево правил и сохраните его.
  5. На карточке каскада проверьте его тестовым запуском.
  6. Нажмите «Запустить».
ПолеОписание
НазваниеНазвание каскада в списке. До 255 символов
ПапкаПапка в списке каскадов. Необязательно
Уникальный код кампанииКод, по которому каскад запускается через API. Латиница в нижнем регистре, цифры, дефис и подчеркивание. Если оставить пустым, код сгенерируется сам. После создания не меняется

Запуск и остановка ​

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

Если отметить у канальной рассылки «Только в составе каскада», ее нельзя будет вызвать по ее коду напрямую — только как шаг каскада. Так, например, SMS с кодом входа не уйдет в обход более дешевых каналов.

Карточка каскада ​

БлокЧто показывает
Код рассылкиКод для вызова через API
ОтправкаЧерез какой API отправляется каскад
Правила каскадаДерево шагов в виде таблицы и предупреждения, если в правилах есть что проверить
Воронка по шагамСтатистика за 1, 7 или 30 дней
Пример запросаГотовый запрос к API: идентификаторы получателя по каналам шагов и переменные из шаблонов всех рассылок каскада
Тестовый запускФорма теста и журнал тестовых запусков
Состав каскадаРассылки каскада по каналам с их статусами

Воронка по шагам ​

Для каждого шага-сообщения: Отправлено, Доставлено, Отказ. Рядом — Завершено прогонов, Медиана до доставки и итоги прогонов:

ИтогЧто значит
доставленоСообщение доставлено в одном из каналов
каналы исчерпаныВсе шаги пройдены, но сообщение не доставлено
нет доступных каналовУ клиента не нашлось ни одного подходящего канала
отмененоКаскад отменили запросом к API
ошибкаКаскад завершился с ошибкой

Блок Канал доставки показывает, через какой канал сообщения доходили до клиентов.

Тестовый запуск ​

Тестовый запуск проходит все шаги каскада на указанный контакт. Сообщения уходят как тестовые, а ожидания сокращаются до 5 секунд.

  1. Укажите контакты получателя: Email, Телефон, External ID, Telegram ID, MAX ID — хотя бы один.
  2. При необходимости заполните Переменные (JSON).
  3. Нажмите «Запустить тест».

В журнале видны статус каждого запуска, итог, канал доставки и путь по шагам. Журнал обновляется при перезагрузке страницы.

Каскады старого формата ​

Каскад, созданный в старом ЛК, хранит список рассылок по каналам и обязательные каналы. Такой каскад отправляется только через старый API. Чтобы отправлять его через новый API, проверять доставку и отменять каскад, нажмите на карточке «Перевести в дерево правил»: каскад перейдет на дерево с той же логикой. Перевод можно сделать и в редакторе правил — он сохранится вместе с правилами.