Подстановка в инструкцию
Подставляйте в инструкцию значения проекта, лида и диалога и используйте условия для разных вариантов текста.
Откройте инструкцию агента.
Данные текущего диалога
При подготовке ответа Senler использует не всю базу проекта, а выбранный фрагмент текущего диалога. В нём есть текущее событие, время сообщений, их авторы и явные связи ответов на сообщения. В групповом диалоге в служебной разметке истории у участников указывается внутренний ID лида Senler; доступные имя или username также могут быть показаны рядом с автором.
Эта разметка помогает агенту понимать ход беседы, но её не следует разбирать в пользовательской инструкции. Если правило зависит от точного поля текущего лида, вставьте это поле через «Данные лида». Например, {{lead_data.id}} — внутренний ID лида Senler, а {{lead_data.external_user_id}} — ID пользователя в подключённом канале. Это разные значения.
Системные данные выбираются для лида, связанного с текущим событием. Если у события нет отдельного лида, используется основной лид диалога. В групповом чате такая подстановка относится к текущему лиду, а не сразу ко всем участникам.
Вставьте данные в инструкцию
- Поставьте курсор в нужное место инструкции агента.
- Нажмите «Вставить переменную». Откроется окно «Данные и переменные».
- Выберите вкладку «Проект», «Лид», «Диалог» или «Данные лида».
- Найдите поле по названию или системному имени.
- Нажмите «Значение», чтобы подставить его в текст, либо «Условие», чтобы выбрать один из двух фрагментов инструкции в зависимости от значения.
После вставки в редакторе останется запись вида {{lead_data.first_name}}. Перед каждым ответом Senler заменит её фактическим значением текущего лида, и только затем передаст инструкцию агенту. Если значения нет, вместо него будет пустое место. Подстановка сама по себе не разрешает агенту изменять данные.
«Условие» вставляет блок {{#if ...}}. Например, так можно задать обращение к клиенту:
{{#if lead_data.first_name}}
Обращайся к клиенту по имени: {{lead_data.first_name}}.
{{else}}
Сначала спроси, как обращаться к клиенту.
{{/if}}В этом примере заполненное имя включает первый фрагмент, а отсутствие имени — фрагмент после {{else}}. Для других типов данных важно учитывать правило: условие также считается невыполненным для числа 0, логического значения false, пустого массива [], пустого объекта {} и строки из одних пробелов. Строка "0", напротив, включает первый фрагмент.
Поэтому не используйте такое условие как универсальную проверку «значение задано»: например, нулевой остаток — это известное значение, но он попадёт в ветку else. Замените текст в обеих ветках правилами для своей задачи.
Системные данные лида
На вкладке «Данные лида» доступны следующие поля:
| Поле | Что будет подставлено |
|---|---|
{{lead_data.id}} | Внутренний ID лида в Senler |
{{lead_data.first_name}} | Имя |
{{lead_data.last_name}} | Фамилия |
{{lead_data.full_name}} | Имя и фамилия, собранные из заполненных полей |
{{lead_data.username}} | Имя пользователя в канале, если оно известно |
{{lead_data.email}} | |
{{lead_data.phone}} | Телефон |
{{lead_data.avatar_url}} | Ссылка на аватар |
{{lead_data.channel_id}} | Внутренний ID подключённого канала |
{{lead_data.channel_type}} | Тип канала |
{{lead_data.external_user_id}} | ID пользователя на стороне канала |
{{lead_data.language_code}} | Код языка лида |
{{lead_data.lead_source}} | Источник создания лида |
{{lead_data.lead_type}} | Тип лида |
{{lead_data.created_at}} | Дата и время создания лида |
{{lead_data.updated_at}} | Дата и время последнего обновления лида |
Поля берутся из карточки текущего лида и не создаются вручную. Даты передаются в системном формате с датой, временем и часовым поясом. Если человеку нужен обычный вид даты, сформулируйте в инструкции, как её показывать.
Для уведомления менеджера используйте {{lead_data.full_name}} для имени клиента, {{lead_data.channel_type}} для платформы и {{lead_data.channel_id}} для внутреннего ID канала Senler. Внешний ID пользователя находится в {{lead_data.external_user_id}} и относится к его платформе. Для сообщения в другой диалог выберите данные лида и диалога процесса, чтобы в уведомление попали сведения клиента, а не получателя.
Примеры для инструкции
Обращение по имени:
Если имя заполнено, обращайся к клиенту по имени: {{lead_data.first_name}}.Передача точного идентификатора во внешний инструмент:
Когда инструменту нужен внутренний ID лида Senler, используй {{lead_data.id}}.
Когда нужен ID пользователя в канале, используй {{lead_data.external_user_id}}.
Не подменяй один идентификатор другим.Постоянные данные проекта:
В конце ответа указывай актуальный адрес: {{project.office_address}}.Ссылка на переменную и подстановка значения — разные действия
Кнопка @ открывает единый каталог ссылок для инструкции. В разделе «Переменные» можно добавить заметный тег переменной проекта, лида или диалога. Такой тег помогает сформулировать правило для работы с переменной и сразу включает агенту доступ на чтение выбранной переменной.
Кнопка «Вставить переменную» добавляет шаблон {{...}}. Senler подставляет значение в инструкцию до запуска агента; для этой подстановки отдельное право инструмента не требуется. Однако шаблон не даёт агенту возможности получить другое поле по ходу разговора или сохранить новое значение.
Если агент должен только видеть одно заранее выбранное значение, достаточно подстановки. Если он должен самостоятельно читать или менять переменные по ситуации, добавьте правило в инструкцию и настройте права инструмента.