Як налаштувати відповідність змінних для події

Якщо вебхук передає змінні з власними назвами або вкладеною структурою, вставте приклад даних у форматі JSON і вручну зіставте поля вебхука зі змінними події. Наприклад, щоб надіслати email, система має знати, яке поле містить email-адресу, навіть якщо воно називається інакше або вкладене в об'єкт.

У статті розглянемо, як зіставити змінні у власній події.

Створіть подію та виберіть структуру даних

Перейдіть до розділу Automation > Менеджер подій (Event manager) і натисніть Додати нову подію (Add new event). Виберіть тип події.

Читайте також: Як створити подію.

У розділі Структура даних (Data structure) виберіть тип структури Довільна (Custom).

Додайте структуру вхідних даних

Щоб зіставити змінні, спочатку додайте приклад даних, які надсилатиме вебхук. Так система зчитає доступні змінні та запропонує їх для зіставлення.

Натисніть Завантажити дані (Upload data) і виберіть спосіб додавання даних:

Коли дані буде додано, біля кнопки Завантажити з'явиться позначка Дані отримано (Data received).

Налаштуйте відповідність змінних

Зіставте поля вебхука зі змінними Automation у таких стовпцях:

Щоб ідентифікувати контакти, які проходять ланцюжок, зіставте змінні email або phone. Також зіставте інші змінні, які використовуються в ланцюжку, наприклад, в умовах елемента Фільтр.

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

Щоб переглянути змінні контакту, які отримала подія, відкрийте журнал подій.

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

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

Перевірте назви змінних

Назви змінних у шаблоні та в події мають точно збігатися. Якщо вони відрізняються, значення не з'явиться в листі. Перевірте, що назви відповідають таким правилам:

• Використовуйте лише базові латинські літери (a–z). Літери з діакритикою, як-от é чи ü, а також схожі на латинські літери інших алфавітів створюють іншу змінну, навіть якщо назва виглядає правильно.
• Використовуйте нижнє підкреслення замість крапки. Система зчитує data.price як змінну price з масиву data.
• Дотримуйтеся регістру літер. Products і products — це дві різні змінні.
• Розміщуйте HTML-теги поза фігурними дужками {{ }}. Наприклад, використовуйте <b>{{name}}</b>, а не {{<b>name</b>}}.

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

Використовуйте незіставлені змінні

Змінні, які ви не зіставили, все одно доступні в Automation. Такі змінні:

• доступні в елементах із текстовими полями (повідомлення, заголовки й назви);
• автоматично додаються зі структури даних;
• передаються як посилання JSONPath;
• за замовчуванням мають тип Рядок.

Щоб використовувати змінні JSONPath у ланцюжку, у налаштуваннях події позначте чекбокс Передавати додаткові дані до ланцюжка (Transfer additional data to the flow).

Ви можете додавати змінні в ланцюжки, які запускає створена подія.

Змінні JSONPath можна вставляти в такі елементи:

*Змінні, зіставлені в структурі події, підтримуються в усіх елементах автоворонки.

Використовуйте синтаксис {{$[path]}}, де [path] — шлях до змінної у форматі JSONPath. Наприклад, якщо масив має такий вигляд:

{
  "data": {
    "user": {
      "name": "Alex",
      "contact_info": {
        "email": "alex@example.com",
        "phone": "(601) 484-5378"
      }
    },
    "order": {
      "number": "WORD-20250730",
      "items_count": 2,
      "total_price": 1899
    }
  }
}

Повідомлення може виглядати так:

Hello, {{$['data']['user']['name']}}!
Your order #{{$['data']['order']['number']}} is being processed. 
We'll give you a call if anything needs your attention. Thank you for choosing us!

У цьому випадку змінні 'name' і 'number' можна не зіставляти в структурі події.

Щоб переглянути дані кожної виконаної події, перейдіть до розділу Менеджер подій > Журнал подій (Log).

Оновлено: 06.08.2025