Как настроить соответствие переменных для события
Если данные, которые вы передаёте через вебхук, содержат внешние переменные или вложенную структуру, можно вставить пример в формате 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;
- тип данных определяется системой как
Строка(String).
Чтобы передавать переменные 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
или