Переменные диалогов

Когда нужна переменная диалога

Используйте её для данных одной переписки: например номера сделки, выбранного заказа или этапа обсуждения. У одного клиента может быть несколько диалогов, и в каждом значение будет своим. В групповом диалоге это одно значение для всей беседы, а не отдельное поле каждого участника.

Данные клиента, которые нужны независимо от переписки, храните в переменных лида. Общие данные компании — в переменных проекта.

Откройте список

В настройках проекта выберите «Переменные», затем вкладку «Переменные диалогов». Здесь создаются определения: имя, тип и назначение поля. Значения отдельных переписок находятся не в этом списке, а в информации о диалоге.

Создайте поле

Нажмите «Создать определение». В форме определения заполните:

1. Имя — например deal_id. После создания его нельзя изменить.
2. Тип — строка, число, логический, массив, объект, JSON или дата. Для номера сделки, который может содержать буквы и ведущие нули, подойдёт строка.
3. Необязательное описание — что хранится в поле.
4. Необязательную AI-инструкцию — например «Сохраняй номер сделки, которую сейчас обсуждают в этом диалоге».

Нажмите «Создать». «Отмена» закроет окно без создания.

Создание определения не заполняет сразу все диалоги. Значение появится только там, где его присвоит оператор, агент, автоматизация или приложение.

Используйте поле

• Оператор задаёт значение в информации о диалоге.
• В инструкции агента {{dialog.deal_id}} подставляет значение текущей переписки. Для самостоятельного чтения или записи настройте доступ агента.
• В автоматизации «Для диалогов» выберите область «Диалог». Значение сохраняется после завершения процесса и доступно следующим запускам в этой переписке. В фоновой автоматизации текущего диалога нет, поэтому эта область недоступна.

Измените или удалите определение

Откройте строку поля. Можно изменить описание и AI-инструкцию. Тип меняется, только если ни в одном диалоге нет сохранённого значения этой переменной. Если данные уже есть, для другого типа создайте новое поле.

Если определение больше не нужно, нажмите «Удалить».

В открывшемся окне проверьте имя переменной и подтвердите действие. Если поле используется другими ресурсами, Senler не разрешит удаление и укажет зависимости.

Уже сохранённые значения диалогов не стираются вместе с определением. Доступ к ним можно вернуть, создав определение с прежним именем, типом и, если она была задана через API, той же схемой данных. Чтобы удалить только значение одной переписки, используйте редактор в диалоге.

Передайте поле в другой проект

Копирование и передача по ссылке переносят определение, а не значения переписок. Поле также можно включить в пакет агента. Подробнее — «Копирование и передача ресурсов».