Поля и переменные
Вкладка «Поля и переменные» в окне скрипта реестра. Справа — поля запроса V2, слева — переменные опубликованной версии агента и откуда каждая получит значение. Поле без записи уходит агенту как есть, под своим именем.
- Поиск переменных агента.
- «Из полей запроса»: переменные, которые получат значение из полей; «как есть» — поле без записи.
- «Подставит ядро адаптера»:
rl_today— день кампании. - «Без значения»: действует умолчание агента; сигнатурная переменная здесь — красный блокер.
- Строка поля: имя, форма (
str 0–150), назначение «→ как есть». - Элементы строки: ручка ⋮⋮ слева — перетащить, ⚙ настройки, × убрать. Стрелки ↑↓ для порядка появляются при наведении на строку.
- «Добавить поле» по одному или «Вставить список полей» — по имени на строку.
Как добавить поля
1
Снимите схему строки с реального запроса клиента
Все ключи строки
data[], кроме четырёх общих, должны быть полями схемы. Лишний ключ в запросе даёт отказ «#ключ# does not exist in the format of the request», пропущенный — «The required field is missing #ключ#». Все поля схемы обязательны в каждой строке.2
Вставьте список полей
Кнопка «Вставить список полей», по одному имени на строку. Каждое имя становится полем
str 0–150 с любыми символами и уходит агенту как есть. Дубли пропускаются, итог — «Добавлено N, пропущено M».3
Выставьте порядок
Перетаскиванием за ручку ⋮⋮ или стрелками ↑↓, которые появляются при наведении на строку. Порядок важен для текста ошибок V2 и ни для чего больше.
4
Откройте ⚙ у поля и уточните форму
См. Формы полей. Форма и пределы повторяют проверки V2: строка, которую отверг бы V2, отвергнет и адаптер.
5
Назначьте переменную агента
«Как есть», «В переменную» или «Не передавать». Проверьте левую панель: ни одна сигнатурная переменная агента не должна остаться «без значения».

agent_name: форма str 0–150, уходит агенту как есть.
- Имя поля — ключ в строке запроса.
- Форма:
str,int,dte,dte_usa,arr. - Длина для
str(или «Значение» от/до дляint). - Символы для
str:abc,123,alphabet,ru,arabic. - Переменная агента: «Как есть», «В переменную», «Не передавать».
- Резервное значение, если пришло пустым: запрос → резерв → умолчание агента → пусто.
Формы полей
Назначение переменной
- Резервное значение доступно только у
strс минимальной длиной 0: пустое значение других форм V2 не пропускает. Порядок: значение из запроса → резервное значение → умолчание агента → пусто. Пустое значение без резерва агенту не передаётся вовсе, и тогда действует умолчание переменной в агенте. Резерв должен укладываться в форму поля и быть не длиннее 1000 символов. foreign_id— внешний идентификатор записи у клиента. По умолчанию агенту не передаётся; запись «В переменную» кладёт его копию в переменную агента. Резерва у него нет.- Зарезервированные имена:
phone_number,type,gender_voice,languageи служебные колонки загрузки контактов (phone,mobile,cell,msisdn,timezone, заголовки группы договора и роли). Их нельзя сделать полем схемы или целью записи. - Переменные, которые ставит платформа (
from_number,to_number,today,call_dateи подобные), целью записи быть не могут.
rl_today и сигнатурные переменные. Ядро адаптера подставляет ровно одну переменную — rl_today, день кампании в формате ДД.ММ.ГГГГ. Она перекрывает одноимённое поле запроса.Сигнатурные переменные агента (в левой панели помечены «подпись») обязаны получить значение — из поля, из записи карты или от ядра, иначе скрипт не сохранится: кампании без сигнатурных переменных не запускаются. Про переменные агента — Переменные.Как поле попадает к агенту: итоговый порядок
Для каждой строкиdata[]:
- Общие поля:
phone_numberиtypeпеременными не становятся никогда;gender_voiceиlanguageуходят агенту переменными под своими именами. - Поле схемы без записи в карте уходит как есть, под именем поля.
- Запись «В переменную» переименовывает поле в выбранную переменную агента; «Не передавать» — поле не уходит.
- Пустое значение берёт резервное значение записи; без резерва ключ не передаётся, и действует умолчание переменной в агенте.
foreign_idуходит агенту только через запись «В переменную».- Последней ядро пишет
rl_today.
{{имя}}. Где проверить, что дошло до агента, — в разделе Передача переменных агенту.