Appearance
Каскады
Каскады находятся в разделе Коммуникации → Сервисные сообщения → Каскады.
Каскад доставляет одно сообщение через несколько каналов по очереди: если сообщение не удалось отправить или оно не доставлено за заданное время, каскад переходит к следующему каналу. Так можно начинать с самого дешевого канала и переходить к дорогим только при необходимости.
Например, для кода подтверждения:
- Если у клиента есть приложение и он подписан на пуши — отправить mobile push.
- Если пуш не доставлен за 20 секунд — отправить письмо.
- Если по письму пришел отказ — отправить SMS.
Своего сообщения у каскада нет: каждый шаг-сообщение — это отдельная канальная сервисная рассылка со своим шаблоном. Каскад вызывается через API так же, как канальная рассылка, — по своему коду. Описание API для разработчиков — в разделе Каскады.
Создание каскада
- Создайте и запустите канальные рассылки для каждого канала каскада.
- В разделе Каскады нажмите «Новый каскад».
- Заполните поля и нажмите «Сохранить». ЛК сразу откроет редактор дерева правил.
- Соберите дерево правил и сохраните его.
- На карточке каскада проверьте его тестовым запуском.
- Нажмите «Запустить».
| Поле | Описание |
|---|---|
| Название | Название каскада в списке. До 255 символов |
| Папка | Папка в списке каскадов. Необязательно |
| Уникальный код кампании | Код, по которому каскад запускается через API. Латиница в нижнем регистре, цифры, дефис и подчеркивание. Если оставить пустым, код сгенерируется сам. После создания не меняется |
Запуск и остановка
- Каскад без шагов запустить нельзя: сначала соберите дерево правил.
- Запустить каскад можно, только если все рассылки в его правилах запущены.
- Пока каскад запущен, его рассылки нельзя остановить или архивировать.
- Кнопки на карточке: «Правила», «Настройки», «Запустить», «Остановить», «В архив», «Восстановить». Правила архивного каскада менять нельзя: сначала восстановите его.
Если отметить у канальной рассылки «Только в составе каскада», ее нельзя будет вызвать по ее коду напрямую — только как шаг каскада. Так, например, SMS с кодом входа не уйдет в обход более дешевых каналов.
Карточка каскада
| Блок | Что показывает |
|---|---|
| Код рассылки | Код для вызова через API |
| Отправка | Через какой API отправляется каскад |
| Правила каскада | Дерево шагов в виде таблицы и предупреждения, если в правилах есть что проверить |
| Воронка по шагам | Статистика за 1, 7 или 30 дней |
| Пример запроса | Готовый запрос к API: идентификаторы получателя по каналам шагов и переменные из шаблонов всех рассылок каскада |
| Тестовый запуск | Форма теста и журнал тестовых запусков |
| Состав каскада | Рассылки каскада по каналам с их статусами |
Воронка по шагам
Для каждого шага-сообщения: Отправлено, Доставлено, Отказ. Рядом — Завершено прогонов, Медиана до доставки и итоги прогонов:
| Итог | Что значит |
|---|---|
| доставлено | Сообщение доставлено в одном из каналов |
| каналы исчерпаны | Все шаги пройдены, но сообщение не доставлено |
| нет доступных каналов | У клиента не нашлось ни одного подходящего канала |
| отменено | Каскад отменили запросом к API |
| ошибка | Каскад завершился с ошибкой |
Блок Канал доставки показывает, через какой канал сообщения доходили до клиентов.
Тестовый запуск
Тестовый запуск проходит все шаги каскада на указанный контакт. Сообщения уходят как тестовые, а ожидания сокращаются до 5 секунд.
- Укажите контакты получателя: Email, Телефон, External ID, Telegram ID, MAX ID — хотя бы один.
- При необходимости заполните Переменные (JSON).
- Нажмите «Запустить тест».
В журнале видны статус каждого запуска, итог, канал доставки и путь по шагам. Журнал обновляется при перезагрузке страницы.
Каскады старого формата
Каскад, созданный в старом ЛК, хранит список рассылок по каналам и обязательные каналы. Такой каскад отправляется только через старый API. Чтобы отправлять его через новый API, проверять доставку и отменять каскад, нажмите на карточке «Перевести в дерево правил»: каскад перейдет на дерево с той же логикой. Перевод можно сделать и в редакторе правил — он сохранится вместе с правилами.