FAQ: передача переменных агенту
Как поле из запроса V2 попадает в переменную агента?
Как поле из запроса V2 попадает в переменную агента?
Порядок для каждой строки
data[]:- Общие поля:
phone_numberиtypeпеременными не становятся никогда;gender_voiceиlanguageуходят агенту переменными под своими именами. - Поле схемы без записи в карте уходит как есть, под именем поля.
- Запись «В переменную» переименовывает поле в выбранную переменную агента; «Не передавать» — поле не уходит.
- Пустое значение берёт резервное значение записи; без резерва ключ не передаётся, и действует умолчание переменной в агенте. Порядок: значение из запроса → резерв → умолчание агента → пусто.
foreign_idуходит агенту только через запись «В переменную».- Последней ядро пишет
rl_today— день кампанииДД.ММ.ГГГГ; она перекрывает одноимённое поле запроса.
{{имя}}.Где посмотреть: карточка кампании → контакт → развёрнутая строка «Переменные контакта»; панель звонка → «Данные» → «Переменные, переданные агенту».Агент произносит {{amount_due}} буквально или молчит на месте переменной
Агент произносит {{amount_due}} буквально или молчит на месте переменной
Причина 1. Поле ведёт в переменную, которую опубликованная версия агента больше не использует, или агент опубликован заново после сохранения скрипта: новая публикация скрипт не перепроверяет. Что сделать: открыть скрипт в реестре, посмотреть сводку и левую панель «Без значения», сохранить заново.Причина 2. Имя переменной в агенте и имя поля различаются по сути (
amountDue против debt_sum). Что сделать: запись «В переменную» на нужную переменную.Причина 3. Значение пришло пустым, резерва нет, у агента нет умолчания. Что сделать: задать резервное значение у поля (только str с минимальной длиной 0) или умолчание переменной в агенте.Кампания не создаётся, клиент получает «Internal error, try again later», хотя скрипт сохранён
Кампания не создаётся, клиент получает «Internal error, try again later», хотя скрипт сохранён
Чаще всего у агента после перепубликации появилась новая сигнатурная переменная, и скрипт её не покрывает: запуск кампании блокируется, запрос откатывается.В кабинете это видно так: кампания появляется в списке и сразу становится «Отменена», контактов в наборе нет. Точную причину инженеры увидят в логах, в сообщении об откате.Что сделать: открыть скрипт в реестре, направить на переменную поле запроса или добавить поле кнопкой «+ поле», сохранить и попросить клиента повторить запрос с новым телом — повтор того же тела в течение 10 минут вернёт прежний ответ.
Агент не видит foreign_id
Агент не видит foreign_id
По умолчанию
foreign_id агенту не передаётся. Добавьте у поля foreign_id запись «В переменную».Дата в rl_today «неправильная»
Дата в rl_today «неправильная»
rl_today — день кампании, а не дата загрузки. Запрос, пришедший за 5 минут до конца дня кампании или позже, создаёт кампанию на завтра, и rl_today содержит завтрашнюю дату.Если агенту нужна дата самого звонка, используйте переменные платформы today или call_date: их платформа ставит на каждом звонке.Агент говорит не тем голосом и не на том языке, хотя gender_voice и language переданы
Агент говорит не тем голосом и не на том языке, хотя gender_voice и language переданы
Эти поля — только переменные. Голос и язык агент выбирает своей логикой: ветвлением во флоу по
{{gender_voice}} и {{language}} либо отдельными агентами под каждый вариант. Адаптер их не переключает.Скрипт не сохраняется: «поле зарезервировано платформой»
Скрипт не сохраняется: «поле зарезервировано платформой»
Имя поля или цели записи совпадает со служебной колонкой загрузки контактов —
phone, mobile, cell, msisdn, timezone, заголовки группы договора и роли — или с одним из четырёх общих полей. Переименуйте переменную в агенте и запись в карте.Лишний или пропущенный ключ в строке запроса
Лишний или пропущенный ключ в строке запроса
Клиент получает «#ключ# does not exist in the format of the request» или «The required field is missing #ключ#»: весь запрос отклонён, ничего не создано. Схема полей скрипта обязана ровно совпадать с набором ключей строки клиента. Сверьте порядок и имена с живым запросом клиента.