Понимание контекста и системных переменных

Переменные контекста

Контекстные переменные создают динамические соотнесения между объектами Salesforce и каналом, используемым клиентом для взаимодействия с ботом. Мы предоставляем готовые контекстные переменные, которые позволяют администраторам искать контакты вне зависимости от канала, а потом открывать любые связанные объекты. В сочетании с чатом он использует данные из предчатовой формы для облегчения быстрого поиска.

Например, если разговор бота использует чат, код контакта считывается из объекта LiveChatTranscript. Если разговор использует службу сообщений, код контакта считывается из объекта MessagingEndUser, связанного с объектом MessagingSession.

Боты могут ссылаться на несколько объектов в Salesforce, чтобы определить, кто ваш клиент. При наличии кода контакта можно использовать контекстную переменную кода контакта с потоком или Apex. Этот метод выводит Личное имя контакта, фамилию и любое другое поле.

Контекстные переменные доступны только для чтения.

Salesforce предоставляет следующие готовые переменные контекста:

• Маршрутизируемый код: Если вы используете предчатовую форму, используйте маршрутизируемый код для доступа к записи LiveChatTranscript для текущего сеанса бота. В нем можно найти поля «Код контакта» и «Код интереса».
• Ключ чата: Код сеанса транскрипта чата. Используйте ключ чата для ссылки на заказ или обращение, доступа к настраиваемым полям, созданным в записи транскрипта чата, и передачи информации в Apex или поток.
• Код контакта: Используйте код контакта, чтобы узнать, является ли клиент чата известным контактом.
  • В службе сообщений контекстная переменная ContactId в конструкторе ботов заполняется, если представитель предварительно связал пользователя службы сообщений и контакт. Эта переменная связана с полем MessagingEndUser.ContactId. Ссылка создана, когда представитель получает уведомление о ссылке или посредством Связывания объекта канала. Переменная ContactId будет нулевой при первом контакте клиента службы сообщений с представителем или для повторного пользователя службы сообщений, который только познакомился с ботом.
• Код конечного пользователя: В конструкторе ботов используйте код конечного пользователя для поиска информации о клиенте, общающемся с ботом. В Apex или потоке используйте код конечного пользователя для поиска кода контакта клиента

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

Переменные контекста обозначаются тегом [Context] перед именем переменной. Контекстные переменные можно использовать в качестве вводных данных для действий диалога.

Настраиваемые переменные контекста

Настраиваемые переменные контекста помогают боту использовать информацию, полученную во время разговора. Вы можете соотнести настраиваемые переменные контекста с настраиваемыми полями в предчатовой форме для настройки разговора или использовать входящий номер телефона службы сообщений для поиска контакта.

Настраиваемые переменные контекста могут быть связаны с несколькими каналами и объектами. Канал чата может соотноситься с объектом LiveChatTranscript, а каналы службы сообщений могут соотноситься из объектов MessagingSession или MessagingUser.

Для создания настраиваемых переменных контекста см. «Создание настраиваемых переменных контекста».

Системные переменные

Salesforce предоставляет следующие системные переменные:

• Код бота рекомендателя: В передачах между ботами это поле отображает код бота, запустившего передачу.
• Последний ввод клиента: Строка текста, введенная клиентом последним. Это поле заполняется только при вводе текста клиентом, а не при выборе клиентом статического или динамического ответа. Для сбора последнего ввода клиента используйте системную переменную «Последний ввод клиента» в действии диалога. Потом его можно передать в Apex для дальнейшей обработки, например, анализа мнений.
  

  Можно также использовать системную переменную «Последний ввод клиента» в условиях правила диалога.

  

Контекст и системные переменные в полях слияния

Как и другие переменные бота Einstein, контекстные и системные переменные можно использовать в сообщениях бота с синтаксисом слияния.

• Чтобы вызвать настраиваемые поля, воспользуйтесь полем «Имя поля» и добавьте __c в конце. Например, {!CustomField__c}.
• Чтобы вызвать определенную запись, используйте {!Record.Field}.
• Чтобы вызвать элемент в переменной списка, используйте FieldName[X], где X обозначает расположение элемента в списке. Поскольку боты Einstein используют индекс на основе нуля с переменными списка, первым элементом списка будет FieldName[0].

{!$System.LastCustomerInput}
{!$Context.ContactId}
{!VariableName}