> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ: передача переменных агенту

> Агент не видит поле запроса, произносит переменную буквально, кампания отменяется из-за сигнатурной переменной.

# FAQ: передача переменных агенту

> [accordion] Как поле из запроса V2 попадает в переменную агента?
>
> Порядок для каждой строки `data[]`:
>
> 1. Общие поля: `phone_number` и `type` переменными не становятся никогда; `gender_voice` и `language` уходят агенту переменными под своими именами.
> 2. Поле схемы без записи в карте уходит как есть, под именем поля.
> 3. Запись «В переменную» переименовывает поле в выбранную переменную агента; «Не передавать» — поле не уходит.
> 4. Пустое значение берёт резервное значение записи; без резерва ключ не передаётся, и действует умолчание переменной в агенте. Порядок: значение из запроса → резерв → умолчание агента → пусто.
> 5. `foreign_id` уходит агенту только через запись «В переменную».
> 6. Последней ядро пишет `rl_today` — день кампании `ДД.ММ.ГГГГ`; она перекрывает одноимённое поле запроса.
>
> При сравнении имён регистр, подчёркивания, дефисы и пробелы не различаются. В агенте переменные используются как `{{имя}}`.
>
> **Где посмотреть:** карточка кампании → контакт → развёрнутая строка «Переменные контакта»; панель звонка → «Данные» → «Переменные, переданные агенту».

> [accordion] Агент произносит \{\{amount\_due}} буквально или молчит на месте переменной
>
> **Причина 1.** Поле ведёт в переменную, которую опубликованная версия агента больше не использует, или агент опубликован заново после сохранения скрипта: новая публикация скрипт не перепроверяет. **Что сделать:** открыть скрипт в реестре, посмотреть сводку и левую панель «Без значения», сохранить заново.
>
> **Причина 2.** Имя переменной в агенте и имя поля различаются по сути (`amountDue` против `debt_sum`). **Что сделать:** запись «В переменную» на нужную переменную.
>
> **Причина 3.** Значение пришло пустым, резерва нет, у агента нет умолчания. **Что сделать:** задать резервное значение у поля (только `str` с минимальной длиной 0) или умолчание переменной в агенте.

> [accordion] Кампания не создаётся, клиент получает «Internal error, try again later», хотя скрипт сохранён
>
> Чаще всего у агента после перепубликации появилась новая сигнатурная переменная, и скрипт её не покрывает: запуск кампании блокируется, запрос откатывается.
>
> В кабинете это видно так: кампания появляется в списке и сразу становится «Отменена», контактов в наборе нет. Точную причину инженеры увидят в логах, в сообщении об откате.
>
> **Что сделать:** открыть скрипт в реестре, направить на переменную поле запроса или добавить поле кнопкой «＋ поле», сохранить и попросить клиента повторить запрос **с новым телом** — повтор того же тела в течение 10 минут вернёт прежний ответ.

> [accordion] Агент не видит foreign\_id
>
> По умолчанию `foreign_id` агенту не передаётся. Добавьте у поля `foreign_id` запись «В переменную».

> [accordion] Дата в rl\_today «неправильная»
>
> `rl_today` — день кампании, а не дата загрузки. Запрос, пришедший за 5 минут до конца дня кампании или позже, создаёт кампанию на завтра, и `rl_today` содержит завтрашнюю дату.
>
> Если агенту нужна дата самого звонка, используйте переменные платформы `today` или `call_date`: их платформа ставит на каждом звонке.

> [accordion] Агент говорит не тем голосом и не на том языке, хотя gender\_voice и language переданы
>
> Эти поля — только переменные. Голос и язык агент выбирает своей логикой: ветвлением во флоу по `{{gender_voice}}` и `{{language}}` либо отдельными агентами под каждый вариант. Адаптер их не переключает.

> [accordion] Скрипт не сохраняется: «поле зарезервировано платформой»
>
> Имя поля или цели записи совпадает со служебной колонкой загрузки контактов — `phone`, `mobile`, `cell`, `msisdn`, `timezone`, заголовки группы договора и роли — или с одним из четырёх общих полей. Переименуйте переменную в агенте и запись в карте.

> [accordion] Лишний или пропущенный ключ в строке запроса
>
> Клиент получает «#ключ#  does not exist in the format of the request» или «The required field is missing #ключ#»: весь запрос отклонён, ничего не создано. Схема полей скрипта обязана ровно совпадать с набором ключей строки клиента. Сверьте порядок и имена с живым запросом клиента.

См. также: [Поля и переменные](https://docs.hubtalk.ai/ru/v4/compat-adapter/registry-fields.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.