Appearance
Дерево правил каскада
Редактор открывается на карточке каскада кнопкой «Правила»: Коммуникации → Сервисные сообщения → Каскады → каскад → Правила.
Дерево правил задает, в каком порядке каскад перебирает каналы. Каскад запускается на входе «API-вызов» и проходит шаги по дереву. Пустой выход шага завершает каскад.
Как собрать дерево
- Нажмите «+» под входом «API-вызов» и выберите первый шаг — обычно Проверка или Сообщение.
- Настройте шаг в панели справа.
- Добавляйте следующие шаги кнопкой «+» под выходами шагов.
- Дождитесь сообщения «Правила в порядке» и нажмите «Сохранить правила».
Ошибки подсвечиваются на схеме, сохранить дерево с ошибкой нельзя. Ветку можно скопировать и вставить в другое место, шаги — соединять и отсоединять. Уже запущенные прогоны исполняют ту версию дерева, с которой стартовали.
Шаги
| Шаг | Что делает | Выходы |
|---|---|---|
| Проверка | Проверяет, есть ли у клиента контакт в канале и подписка на канал | да / нет |
| Сообщение | Отправляет канальную сервисную рассылку | отправлено / не отправлено |
| Проверка доставки | Ждет подтверждения доставки сообщения одного из предыдущих шагов | доставлено / не доставлено |
| Пауза | Ждет заданное время перед следующим шагом | дальше |
Проверка
В проверке задаются условия Есть контакт или Подписан для выбранного канала. В поле Условия выполняются выберите все или хотя бы одно. В одной проверке — не больше 5 условий: для остальных добавьте следующий шаг-проверку.
Сообщение
Выберите Рассылку — запущенную канальную сервисную рассылку. Каскад в каскад добавить нельзя. Если у клиента нет контакта, он отписан или отправка завершилась ошибкой, срабатывает выход не отправлено.
Проверка доставки
| Поле | Описание |
|---|---|
| Сообщение какого шага проверять | Шаг-сообщение, который идет раньше этой проверки на каждом пути |
| Когда считать доставленным | Режим проверки, см. таблицу ниже |
| Ожидание, секунд | Сколько ждать подтверждения от отправки сообщения. От 5 секунд до 24 часов |
| Режим | Когда сообщение считается доставленным |
|---|---|
| Принято провайдером | Как только провайдер принял сообщение. Ожидания нет |
| Нет отказа | По событию доставки или если до конца ожидания не пришел отказ |
| Доставка подтверждена | Только по событию доставки. Если его нет, по истечении ожидания — не доставлено |
| Открыто или клик | Только по открытию или клику |
Открытие и клик считаются доставкой в любом режиме. Проверка срабатывает досрочно, как только пришло событие доставки или отказа.
Режимы по умолчанию: для email — Нет отказа, для пушей, SMS и WhatsApp — Доставка подтверждена, для Telegram и MAX — Принято провайдером. Не все режимы подходят каждому каналу: например, у Telegram и MAX есть только Принято провайдером и Открыто или клик.
Ограничения
- Не больше 30 шагов в дереве. Циклы не допускаются.
- Одна и та же рассылка не может повторяться на одном пути.
- Пауза — от 1 секунды до 24 часов. Суммарное ожидание на одном пути — не больше 24 часов.
- Если каскад запущен, все рассылки в его шагах тоже должны быть запущены.
Предупреждения редактора
Редактор подсказывает типичные ошибки:
- Прием письма почтовым сервером не значит, что письмо дошло. Для писем выберите Нет отказа или Открыто или клик.
- Провайдер не присылает статусы доставки. Если SMS- или WhatsApp-шлюз не присылает статусы, режим Доставка подтверждена всегда закончится по таймауту, и следующий канал получит дубль.
- После SMS идут другие сообщения. SMS обычно самый дорогой канал и ставится последним.
Подробный формат дерева и рекомендации для кодов подтверждения — в разделе Каскады для разработчиков.