Как настроить соответствие переменных для события

Если вебхук передает переменные с собственными названиями или вложенной структурой, вставьте пример данных в формате 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