Skip to content

Дерево правил каскада ​

Редактор открывается на карточке каскада кнопкой «Правила»: Коммуникации → Сервисные сообщения → Каскады → каскад → Правила.

Дерево правил задает, в каком порядке каскад перебирает каналы. Каскад запускается на входе «API-вызов» и проходит шаги по дереву. Пустой выход шага завершает каскад.

Как собрать дерево ​

  1. Нажмите «+» под входом «API-вызов» и выберите первый шаг — обычно Проверка или Сообщение.
  2. Настройте шаг в панели справа.
  3. Добавляйте следующие шаги кнопкой «+» под выходами шагов.
  4. Дождитесь сообщения «Правила в порядке» и нажмите «Сохранить правила».

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

Шаги ​

ШагЧто делаетВыходы
ПроверкаПроверяет, есть ли у клиента контакт в канале и подписка на каналда / нет
СообщениеОтправляет канальную сервисную рассылкуотправлено / не отправлено
Проверка доставкиЖдет подтверждения доставки сообщения одного из предыдущих шаговдоставлено / не доставлено
ПаузаЖдет заданное время перед следующим шагомдальше

Проверка ​

В проверке задаются условия Есть контакт или Подписан для выбранного канала. В поле Условия выполняются выберите все или хотя бы одно. В одной проверке — не больше 5 условий: для остальных добавьте следующий шаг-проверку.

Сообщение ​

Выберите Рассылку — запущенную канальную сервисную рассылку. Каскад в каскад добавить нельзя. Если у клиента нет контакта, он отписан или отправка завершилась ошибкой, срабатывает выход не отправлено.

Проверка доставки ​

ПолеОписание
Сообщение какого шага проверятьШаг-сообщение, который идет раньше этой проверки на каждом пути
Когда считать доставленнымРежим проверки, см. таблицу ниже
Ожидание, секундСколько ждать подтверждения от отправки сообщения. От 5 секунд до 24 часов
РежимКогда сообщение считается доставленным
Принято провайдеромКак только провайдер принял сообщение. Ожидания нет
Нет отказаПо событию доставки или если до конца ожидания не пришел отказ
Доставка подтвержденаТолько по событию доставки. Если его нет, по истечении ожидания — не доставлено
Открыто или кликТолько по открытию или клику

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

Режимы по умолчанию: для email — Нет отказа, для пушей, SMS и WhatsApp — Доставка подтверждена, для Telegram и MAX — Принято провайдером. Не все режимы подходят каждому каналу: например, у Telegram и MAX есть только Принято провайдером и Открыто или клик.

Ограничения ​

  • Не больше 30 шагов в дереве. Циклы не допускаются.
  • Одна и та же рассылка не может повторяться на одном пути.
  • Пауза — от 1 секунды до 24 часов. Суммарное ожидание на одном пути — не больше 24 часов.
  • Если каскад запущен, все рассылки в его шагах тоже должны быть запущены.

Предупреждения редактора ​

Редактор подсказывает типичные ошибки:

  • Прием письма почтовым сервером не значит, что письмо дошло. Для писем выберите Нет отказа или Открыто или клик.
  • Провайдер не присылает статусы доставки. Если SMS- или WhatsApp-шлюз не присылает статусы, режим Доставка подтверждена всегда закончится по таймауту, и следующий канал получит дубль.
  • После SMS идут другие сообщения. SMS обычно самый дорогой канал и ставится последним.

Подробный формат дерева и рекомендации для кодов подтверждения — в разделе Каскады для разработчиков.