Як виправити проблеми з відображенням шаблонів у ланцюжку

Під час роботи з Automation інколи у ланцюжку відображається застарілий шаблон або не підставляються динамічні дані. Зазвичай це пов’язано з оновленням шаблонів або некоректним використанням змінних.

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

Зміст

Відправляється старий шаблон

У SendPulse шаблони листів і листи в автоворонці — це різні об’єкти, які не оновлюються автоматично. Тому важливо підтримувати актуальність шаблонів у ланцюжку.

Якщо ви змінюєте шаблон у розділі Email > Шаблони, листи, додані в ланцюжок автоворонки, не оновлюються та продовжують надсилатися без змін. Щоб уникнути цього, оновіть лист в ланцюжку.

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

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

Змінні з джерела контактів не підставляються

Змінні в листі отримують дані з джерел, пов’язаних із ланцюжком:

події, яка запускає ланцюжок;
контактів з адресної книги, якщо її вибрано.

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

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

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

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

`Date`	Надсилайте дати у форматах `YYYY-MM-DD` та `YYYY-MM-DD HH:MM:SS`. Значення в інших форматах, як-от `27.06.2026` чи `2026-01-05T11:57:45.471000`, не зберігаються.
`Number`	Надсилайте лише цифри. Якщо значення містить літери, пробіли або інші символи, воно не зберігається.
`String`	Значення мають бути коротшими за 255 символів. Довші значення обрізаються, тому довгі посилання можуть перестати працювати.
Назва змінної	Використовуйте базові латинські літери (a–z), а замість крапок — підкреслення. Літери з діакритичними знаками або з інших алфавітів створюють іншу змінну. Крапка сприймається як звернення до масиву.

Якщо змінити формат даних неможливо, видаліть змінну в налаштуваннях події та створіть змінну типу String з тією самою назвою.

Значення змінних події та CRM зберігаються в момент, коли контакт потрапляє в ланцюжок. Дані угоди чи контакту, які ви додали пізніше, не з’являться в листі. Щоб додати їх у лист, надішліть подію після того, як дані додано, або оновіть значення в ланцюжку за допомогою елемента Дія.

Шаблони WhatsApp в елементі Messaging app підтримують змінні лише в тексті шаблону. Для кнопок використовуйте статичні посилання, оскільки посилання кнопок не можуть містити змінних.

Якщо ім’я контакту в CRM не оновлюється, перевірте назву змінної. Змінні з назвами firstname, first_name, name, Nom, Nome, Nombre, Ad, ім'я або имя зберігаються в поле firstName. Змінні з назвами lastname або last_name зберігаються в поле прізвища. Якщо змінні мають інші назви, налаштуйте маппінг полів у дії Створити або оновити контакт чи Створити угоду.

Не додаються дані з масиву

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

Змінні містять item, наприклад, {{item.price}}.
Подія, яка запускає ланцюжок, передає ті самі дані, що використовуються в листі.
Додано всі обов’язкові атрибути тегів, наприклад, src для зображень і href для посилань.
Масив створено в структурі події як змінну типу Structure. Автоматично він не створюється.
Масив надсилається у квадратних дужках [ ], а не як окремий об’єкт.
Назва масиву має однаковий регістр літер у події та в шаблоні, наприклад, products, а не Products.
Кнопки та інші елементи, які мають відображатися лише один раз, розміщено після закривального тега циклу |[ endfor ]|. Усередині циклу вони повторюються для кожного елемента масиву.

Читайте докладніше: Як реалізувати передачу масиву даних.

Не відображаються зображення з даних події

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

Тег <img>. Змінна має бути в атрибуті src, наприклад, <img src="/{{item.product_img_url}}" alt="Product" width="125" height="125">. Тег не можна вкладати в інший тег <img>.
Довжину посилання. Посилання, довші за 255 символів, обрізаються й не працюють.
Формат посилання. Пробіли та спецсимволи мають бути закодовані, наприклад, %20 замість пробілу. Частина https:// має бути у значенні змінної, а не перед змінною в шаблоні.
Налаштування сервера або сервісу безпеки, як-от Cloudflare. Вони мають дозволяти SendPulse доступ до зображень.
Спосіб додавання тега. У блоковому конструкторі тег <img> має бути у вихідному коді (<>) елемента Текст.

Щоб переглянути всі дані, які отримала подія, відкрийте запис у Automation > Менеджер подій > Журнал. Прокрутіть вікно донизу, щоб побачити всі поля.

Читайте докладніше: Елемент Email в Automation 360, Як реалізувати передачу масиву даних.

Не додається інформація у вебхуці

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

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