Якщо сценарій не працює

Якщо у вас виникли проблеми з функціонуванням сценарію, перевірте типові проблеми його налаштування.

Сценарій не запускається

1. Перевірте статус потрібного сценарію у списку. Перейдіть до розділу Тригери → Сценарії.

Статус сценарію має бути активний (біля назви відображається індикатор зеленого кольору).

Якщо він неактивний, натисніть кнопку Активувати.

2. Перевірте подію, яка запускає сценарій. Якщо сценарій має запускатися подією, переданою через API, переконайтеся, що її передано, і виберіть її у випадному списку в Налаштуваннях запуску.

3. Перевірте, чи були зареєстровані в системі запуски сценарію. Перегляньте статистику щодо сценаріїв.

Якщо усі значення в статистиці дорівнюють нулю, це означає, що сценарій ніколи не запускався.

4. Переконайтеся, що є тип події, який має запускати сценарій. Для перегляду перейдіть до розділу Тригери → Історія подій.

5. Перевірте, чи пов'язані між собою подія та кнопка, якщо подія запускається натисканням кнопки у повідомленні.

6. Переконайтеся, що події у конфігурації тригера та у повідомленні відповідають одна одній.

Подія надійшла, але сценарій не запустився

Найчастіша причина — подія надійшла раніше, ніж у системі було створено контакт. Подія не знаходить контакт, для якого запускати сценарій, тому запуск не відбувається.

Надсилайте подію після того, як переконаєтеся, що контакт створено, або додайте невелику паузу між створенням контакту й надсиланням події. Створення та збагачення контакту виконуються асинхронно, тож одразу після запиту на створення контакт може бути ще недоступний.

📘

Зверніть увагу

Окремого системного попередження про те, що запуск сценарію заблокований через досягнутий ліміт контактів в акаунті або групі, немає. Лист про наближення бази до ліміту тарифу надходить окремо — про нього в поширених питаннях про білінг. Щоб помітити саме зупинку відправок, налаштуйте контроль тригерів на повідомлення з міткою цього сценарію: сповіщення надійде, коли вони перестануть надходити у звичному темпі.

Сценарій за групою чи сегментом запускається не одразу

Сценарії, які запускаються за групою або сегментом, обробляються пакетно — не частіше ніж раз на годину. Контакт, який щойно потрапив до групи, отримає повідомлення не миттєво.

Подієві тригери працюють інакше: сценарій, що запускається подією, стартує одразу після надходження події.

Не плутайте це з перерахунком складу групи — оновленням переліку контактів, які відповідають умовам групи. За замовчуванням він виконується щодня о 3-4 годині ранку, і його час налаштовується окремо. Детальніше >

Подія зареєстрована, але сценарій не запустився

Якщо подію видно в розділі Автоматизація → Історія подій, а повідомлення так і не надійшло, перевірте, чи існував контакт на момент надходження події. Запуск записується й без контакта, але блоки, яким він потрібен, працювати не можуть: блок відправлення з порожніми полями Email і Contact ID завершується помилкою Empty contact media.

Та сама помилка виникає, коли подія, яка запустила сценарій, не несе ідентифікатора контакта в params. Значення keyValue контакт не ідентифікує, тому передавайте в params externalCustomerId, email або phone.

Щоб цього не сталося:

• Надсилайте подію лише після того, як запит на створення контакта повернув успішну відповідь.
• Або додайте невелику паузу між створенням контакта й надсиланням події.

Інша помилка, Contact not found by externalCustomerId, виникає, коли подія несе зовнішній ID, якого на момент її надходження немає в жодного контакта. Тоді в контексті сценарію контакта немає, і контакт, який дістане цей зовнішній ID пізніше, наприклад, із замовлення, його туди вже не додасть. Поставте перед блоком відправлення таймер і блок отримання контакта, щоб на момент надсилання контакт був знайдений.

Як часто запускаються сценарії за групою

Сценарії за подією стартують, щойно подію зареєстровано. Сценарії за групою запускаються пачками раз на годину, тож контакт, який щойно потрапив до групи, може чекати на запуск до години.

Це інший механізм, ніж перерахунок групи, який визначає склад умовної групи й виконується щодня з 3-ї до 4-ї години. Тобто контакт спочатку має потрапити до групи під час перерахунку, а сценарій запуститься для нього вже наступним щогодинним запуском. Докладніше — Регулярний сценарій для групи.

Сценарій читає ще не оновлені дані контакта

Створення контакта й збагачення його даних відбуваються асинхронно. Якщо сценарій перевіряє поле контакта або входження до групи одразу після блока Старт, перевірка може виконатися раніше, ніж дані контакта запишуться, і сценарій піде не тією гілкою.

Додайте одразу після блока Старт невеликий таймер або блок отримання контакта. Тоді дані контакта встигають оновитися, і умова перевіряється за актуальними значеннями.

Сценарій запускається, але працює некоректно

1. Перевірте налаштування блоків сценарію.

Увійдіть до сценарію, клікайте кожен блок і перевіряйте його налаштування:

• Чи вибрано повідомлення у блоці Повідомлення?

• Чи вказано правильну змінну в Розширених параметрах?

Вона має збігатися зі змінною, яку ви передаєте у параметрах події. 

Для перевірки змінної у параметрах події, перейдіть до розділу Тригери → Історія подій і виберіть потрібний тип події. 

2. Перевірте правильність побудови сценарію. Усі блоки мають бути пов'язані один з одним.

3. Якщо усі налаштування коректні, але деякі користувачі не отримують повідомлення відповідно до сценарію, перевірте контактну інформацію цих користувачів. Можливо, вони відписалися, були додані до чорного списку, перевищили ліміт надсилання тощо. 

Цю інформацію ви знайдете в розділі Розсилки → Одиночні. Введіть ідентифікатор контакту в рядок пошуку і перегляньте деталі помилок доставлення. 

Також ви можете переглянути контактну інформацію у розділі Контакти → Всі контакти.

Сценарій одразу після старту бачить неоновлені дані контакту

Якщо перший блок після Старту перевіряє поля контакту, ці поля можуть бути ще не заповнені: подія і оновлення контакту обробляються паралельно. Додайте після блока Старт короткий таймер або блок отримання контакту — це прибирає гонку між подією й оновленням контакту.

Умова зупинки за входженням до групи повертає помилку для контакта, якого в системі ще немає: без контакта перевірку виконати нема на чому. Саме повідомлення при цьому надсилається, бо контакт створює блок відправлення, тож така помилка в історії запусків не означає, що розсилка не відбулася.

Історія запусків зберігається сім днів

Деталі запуску доступні сім днів, давніший запуск подивитися вже не можна. Додавання контакта до групи й вилучення з неї не логуються: якщо контакт у групі, з історії не видно, чи потрапив він туди сценарієм, через API, імпортом файлу чи вручну.

Лист зі сценарію надходить із затримкою

Помітна затримка між спрацюванням тригера й отриманням листа може виникати не лише на боці поштового сервера одержувача, а й усередині платформи — поки повідомлення стоїть у черзі на відправлення. У розібраному випадку повідомлення було створено й передано в інфраструктуру відправлення приблизно через вісім хвилин після спрацювання тригера, а інфраструктура відправлення прийняла його одразу.

Це пояснення одного конкретного випадку, а не гарантований рівень сервісу: показники p50/p95 для приймання подій, внутрішньої черги чи прийняття листа поштовим сервером одержувача не публікуються.

Щоб розібрати конкретну затримку, надішліть до служби підтримки доставлений файл .eml із повними заголовками Received. Статус одиночного повідомлення також можна перевірити через API.

Це основні налаштування, які вам слід перевірити, якщо у вас виникли проблеми. Якщо після перевірки проблеми залишилися, зверніться до нашої служби технічної підтримки [email protected].