Як налаштувати відповідність змінних для події
Якщо дані, які ви передаєте через вебхук, містять зовнішні змінні або вкладену структуру, можна вставити приклад у форматі JSON і вручну налаштувати відповідність між полями вебхука та змінними події. Наприклад, щоб надіслати email, система має знати email — навіть якщо назва поля відрізняється або вкладена в обʼєкт.
У статті розглянемо, як налаштувати відповідність полів зі змінними.
Створіть подію та виберіть структуру даних
Перейдіть до розділу Automation > Менеджер подій і натисніть Додати нову подію (Add new event). Виберіть тип події.
Читайте також: Як створити подію.
У секції Структура даних (Data structure) виберіть тип структури Довільна (Custom).
Додайте структуру вхідних даних
Щоб налаштувати підставлення змінних, спочатку потрібно надати приклад структури даних, яку ваш вебхук буде передавати. Це дає змогу системі автоматично зчитати наявні змінні та запропонувати їх для зіставлення.
Натисніть Завантажити дані та виберіть, як ввести дані:
| Вставити код (Insert code) | Введіть або вставте вручну JSON-код у поле введення. Натисніть Завантажити. |
| Завантажити за посиланням (Import from a URL) | Вкажіть посилання на файл або URL-адресу запиту, звідки система зможе отримати JSON-дані автоматично. Натисніть Отримати та перегляньте структуру в полі нижче. |
Після успішного завантаження ви побачите позначку Дані отримано біля кнопки завантаження.
Налаштуйте відповідність змінних
Щоб синхронізувати дані з полів вебхука та змінні Automation у структурі події, налаштуйте відповідність у таких колонках.
| Поле вебхука (Webhook field) | Виберіть поле, яке підтягується з завантаженої структури даних. Ви можете розгорнути структуру даних та вибрати потрібне значення, якщо поле належить до іншого обʼєкта — для цього натисніть на стрілу та виберіть значення. |
| Змінна події (Event variable) | Введіть змінну Automation. Список стандартних змінних залежить від типу події. |
| Тип даних (Data type) | Рядок (String) — текстові значення до 255 знаків.
|
Для ідентифікації контакту, який проходить ланцюжок, обов'язково зіставити змінну email або phone. Також треба зіставити змінні, які використовуються для побудови логіки ланцюжка, наприклад, умов Фільтра.
Використовуйте не зіставлені змінні
Якщо ви не зіставили певні змінні з завантажених даних під час налаштування структури події, вони все одно залишаються доступними в Automation. Особливості таких змінних:
- доступні тільки в елементах, де є інформативні текстові поля (повідомлення, заголовки, назви тощо);
- автоматично додаються зі структури переданих даних;
- передаються у вигляді JSONPath;
- тип даних визначається системою як
Рядок(Srting).
Щоб передавати змінні JSONPath до ланцюжка, в налаштуваннях події активуйте опцію Передавати додаткові дані до ланцюжка (Transfer additional data to the flow).
Ви можете додавати змінні до ланцюжків, тригером для яких вибрана створена подія.
Елементи, що підтримують вставку змінних JSONPath:
| Елемент* | Де використовувати змінну |
| Тема, прехедер, тіло листа. | |
| SMS, Messenger, WhatsApp, Viber | Текст повідомлення. |
| Дія | Всі вставки, що підтримують вставку змінних, наприклад, назва угоди, ім'я контакту, назва завдання тощо. |
*Попередньо зіставлені змінні у структурі події підтримуються у всіх елементах ланцюжка автоматизації.
Використовуйте синтаксис {{$[path]}}, де [path] — це шлях до змінної у форматі JSONPath. Наприклад, якщо ваш масив виглядає так:
{
"data": {
"user": {
"name": "Alex",
"contact_info": {
"email": "alex@example.com",
"phone": "+380197654321"
}
},
"order": {
"number": "ORD-20250730",
"items_count": 2,
"total_price": 1899
}
}
}Приклад повідомлення може виглядати так:
Привіт, {{$['data']['user']['name']}}!
Ваше замовлення №{{$['data']['order']['number']}} оформлено успішно.
Очікуйте на дзвінок від нашого менеджера. Дякуємо, що обрали нас!При цьому змінні 'name' та 'number' можуть бути не зіставленими в структурі події.
Щоб переглянути дані про кожну виконану подію, перейдіть у Менеджер подій (Events Manager) > Журнал подій (Log).
Оновлено: 06.08.2025
або