Перейти к основному содержанию

Переменные: откуда берутся и куда попадают

Цель модуля: научиться передавать данные внутрь звонка, вытаскивать сказанное клиентом и считать производные значения.
Переменные звонка (dynamic variables) — это память разговора. Три источника:
  1. Приходят снаружи — из кампании обзвона (колонки файла контактов), из вызова публичного API или из SIP-заголовков входящего звонка. Именно так агент знает, к какому врачу и на какое время записан клиент. Колонка доходит до агента под своим именем из файла: contact_first_name, contact_last_name, contact_city и любые ваши колонки вроде doctor или visit_time. В шаблоне файла для профиля рынка США есть ещё contact_zip и contact_state; по ZIP-коду платформа определяет часовой пояс контакта.
  2. Извлекаются из разговора — узлом Extract Variables.
  3. Считаются — узлом Code или из ответа Function.
Значения по умолчанию задаются в окне «Переменные агента»: оно открывается кнопкой «Изменить» или «+ Переменная» на одноимённой вкладке, а сама вкладка только показывает список. Эти значения служат и тестовыми данными в чат-тесте. Объявленная переменная без значения подставляется пустой строкой, звонок из-за неё не падает. Флажок «В сигнатуре» в том же окне отмечает переменные, которые обязаны прийти колонкой файла контактов: если такой колонки в файле нет, кампания не запустится.
Панель переменных агента со значениями по умолчанию

Переменные агента. Значения здесь — дефолты и тестовые данные; в бою их перекрывают данные кампании или API.

Панель переменных агента со значениями по умолчанию
Ещё десять переменных есть в любом звонке с первого слова, их не надо ни объявлять, ни передавать. Три описывают сам звонок: {{direction}} (inbound, outbound или web), {{from_number}} и {{to_number}}. У входящего звонка from_number — номер звонящего, to_number — набранный номер; у исходящего наоборот. Номера приходят одними цифрами, с кодом страны, без +, пробелов и скобок: 77011234567 для Казахстана, 12125551234 для США. Если агент произносит номер вслух, приведите его к читаемому виду нодой Code. Значения из публичного API и SIP-заголовков применяются после и перекрывают эти переменные, а колонка файла контактов с таким же именем до звонка не доходит. В чат-тесте звонка нет: номера там берутся из значений по умолчанию на вкладке, а без них остаются пустыми, direction — web. Остальные семь — дата и время разговора: {{call_date}} (2026-09-24), {{call_date_us}} (09/24/2026), {{call_time}} (14:05), {{call_time_us}} (2:05 PM), {{call_weekday}} (день недели по-английски, Thursday), {{call_timezone}} и {{today}}. Форма {{today}} зависит от профиля рынка организации: в Казахстане (kz) это 2026-09-24, в США (us_tcpa) — 09/24/2026. Дата считается в часовом поясе контакта или организации и пересчитывается на каждом звонке, в чат-тесте тоже, поэтому значение по умолчанию с вкладки её не заменит. Полный список и порядок выбора пояса — в справочнике, в разделе Переменные, которые есть в каждом звонке.
Инспектор узла Extract Variables: три извлекаемые переменные

Extract Variables — немой узел: одним structured-вызовом достаёт из сказанного желаемую дату, часть дня и причину переноса. Если нужен ответ из заданного набора — например, да или нет, — выберите тип enum: по такому значению удобно строить формулу.

Инспектор узла Extract Variables: три извлекаемые переменные
Типы извлекаемых переменных — string, number, boolean и enum; у enum модель выбирает одно из перечисленных значений. Совет: пишите описание переменной как инструкцию модели, а не как комментарий для коллеги. «Желаемая дата визита в формате YYYY-MM-DD» работает; «дата» — нет. Формат выбирайте под то, куда значение пойдёт дальше: YYYY-MM-DD совпадает по форме с {{call_date}}, MM/DD/YYYY — с {{call_date_us}}.
Инспектор узла Code: код на Python и переменные результата

Code — Python в песочнице: собрать строку, нормализовать телефон, посчитать разницу дат. Читает vars, отдаёт значения через result; какие переменные забрать — перечислено в «Переменных результата». Сети и файлов в песочнице нет — за этим идут в Function.

Инспектор узла Code: код на Python и переменные результата
Редактор кода узла «Местное время» на весь экран: вызов now('Asia/Almaty') и словарь result

Code с часами на весь экран: подсказка внизу напоминает, что доступно в песочнице — словарь vars, переменная result и now(…). Значения из result перечислены в «Переменных результата» и дальше живут как переменные звонка.

В песочнице есть часы: now("Asia/Almaty") или now("America/New_York") возвращает время в указанной зоне IANA словарём — date (YYYY-MM-DD), time (HH:MM), hour, minute, dow (1–7, понедельник первый), iso, epoch и остальное. Зона обязательна: now() без аргумента или с незнакомой зоной — ошибка и уход по ветке ошибки узла. import datetime в песочнице не работает, так что «который час» спрашивают именно так — внешний сервис времени для этого не нужен. А чтобы просто назвать дату или время звонка, Code не нужен вовсе: хватит готовых {{call_date}} и {{call_time}} или их американских форм {{call_date_us}} и {{call_time_us}}.
Имена vars, result и now принадлежат самой песочнице — переменную результата так называть нельзя, она всегда осталась бы пустой. Валидатор про это предупреждает, а не блокирует публикацию.

Где {{переменная}} подставляется

Плейсхолдер разворачивается во всём авторском тексте, а не только в инструкции узла: в общем промпте агента, в условиях переходов (включая глобальные), в сводке целей, в описаниях и аргументах функций, в полях извлечения, в промпте flex-режима и в подсказке распознавания автоответчика.
Общий промпт разворачивает плейсхолдеры. Скрипт, положенный в «Общий промпт», доезжает до модели с подставленными значениями — копировать текст в инструкции узлов ради подстановки не нужно.Имя, которого в звонке нет, остаётся текстом: модель увидит {{имя}}. Пустая подстановка сделала бы опечатку невидимой — вместо явного сигнала агент заговорил бы с дырой в фразе.
Грабли: немой узел молчит, но время тратитExtract Variables — это ещё один вызов модели, а Code — исполнение кода. В голосовом звонке они стоят между репликой клиента и ответом агента, то есть напрямую добавляются к паузе перед ответом. Не ставьте три немых узла подряд там, где хватит одного, и не давайте им «тяжёлую» reasoning-модель — инспектор об этом предупреждает.