Использование словаря автоматизации для передачи ключей параметров
Словарь службы автоматизации поддерживает контекстные данные для сеансов. Вы можете использовать ключи из словаря автоматизации для передачи параметра в действие.
При создании шаблонов и макросов в приложении администрирования вы можете передавать ключи параметров, такие как заголовок сеанса, заголовок уведомления, заголовок шаблона вкладки приложения и значения настраиваемых параметров для типов вкладок приложения. Эти ключи заменяются на основе контекстной информации, доступной на момент выполнения.
Передача параметра данных в шаблоны
Давайте рассмотрим сценарий для шаблонов с уведомлениями.
В уведомлении отображаются определенные поля и значения, которые называются Заголовок поля и Значение, соответственно.
Кенни Смит, клиент, инициировал разговор, и когда агент видит уведомление, оно отображает Имя клиента как Кенни Смит.
Здесь Заголовок поля имеет значение Имя клиента, а Значение равно Кенни Смит.
Для шаблонов, чтобы идентифицировать имя клиента как Кенни Смит, вы (администратор) должны передать параметр в качестве ключей.
Аналогично, для заголовков сеансов и уведомлений вы можете передавать параметры данных. Дополнительные сведения: Форматы словаря автоматизации для ключей параметров данных
Система заменяет эти ключи параметров фактическими значениями на основе контекста сеанса, провайдера канала, Microsoft Dataverse и действий пользователя. Дополнительные сведения: Типы параметров контекстных данных
Передайте параметр данных в макросах и скриптах агента
Макросы — это набор настроенных последовательных действий, которые запускаются пользователем по требованию. Как администратору, вам необходимо настроить действия, которые должен выполнять макрос. Для настройки действий необходимо передать параметры данных. Больше информации: Форматы словаря автоматизации для передачи ключей параметров данных
Когда агент запускает макрос, система заменяет эти ключи параметров фактическими значениями на основе контекста сеанса, провайдера канала, Dataverse и действий пользователя.
Когда контекст взят из сеанса, действие макроса запускается на основе информации для текущего сеанса, где информация получается со вкладки "Привязка" или текущей вкладки, которая находится в фокусе. Например, чтобы создать обращение, вам нужно определить действия, которые содержат форму сущности инцидента и GUID формы (необязательно). Дополнительные сведения: Типы параметра контекстных данных
Типы параметров контекстных данных
Словарь автоматизации использует параметры данных контекста, доступные из следующих источников:
- Контекстные данные от поставщика канала
- Контекстные данные от действий пользователя
- Контекстные данные из Dataverse
- Контекстные данные из других действий макроса
Контекстные данные от поставщика канала
Эти данные контекста получены от собственного поставщика канала, такого как многоканальное взаимодействие для Customer Service, или стороннего поставщика канала, который использует мини-приложение, предоставляемое инфраструктурой интеграции каналов Dynamics 365. Данные контекста из многоканального взаимодействия для Customer Service — это опрос перед разговором, навигация по порталу для посетителей и т. д.
Контекстные данные от действий пользователя
Эти данные заполняются по мере того, как агенты выполняют некоторые действия в сеансе. Примером является открытие новой записи клиента, обращения и так далее.
Контекстные данные из Dataverse
Организационные данные хранятся в Dataverse, и вы можете получить данные с использованием запросов OData. Дополнительные сведения: Запросы OData
Контекстные данные из других действий макроса
Действие в макросе генерирует данные контекста, которые используются другими действиями в этом макросе.
Например, есть два шага действия в следующем порядке:
- Открытие новой формы для создания записи.
- Открыть форму сообщения электронной почты с предопределенным шаблоном.
При создании действия Открыть форму электронной почты с предопределенным шаблоном вы можете получить ключи параметров данных контекста из шага действия макроса Открытие новой формы для создания записи.
Параметр данных контекста из первого действия макроса выглядит следующим образом:
- Логическое имя сущности
- Тип страницы
- ИД вкладки
Заметка
Параметры данных контекста из других действий макроса являются специфическими для макросов и не применимы к шаблонам.
Форматы словаря автоматизации для передачи ключей параметров данных
Словарь службы автоматизации поддерживает контекстные данные для сеансов. Ключи в словаре автоматизации можно передавать как параметры в действие в макросе. Система заменяет эти ключи параметров фактическим значением на основе контекста сеанса, провайдера канала, Dataverse и действий пользователя.
Словарь автоматизации поддерживает следующие форматы:
Динамические данные
Поле динамических данных — параметр замены, который система заполняет в среде выполнения в зависимости от контекста. Используйте следующий список полей динамических данных только для макросов и скриптов агента, а также для установки скрипта агента по умолчанию с помощью построителя выражений скрипта агента. Дополнительные сведения: Средства повышения производительности
Поля динамических данных для средств повышения производительности (макросы и скрипты агента)
Макросы и сценарии агента поддерживают следующие динамические данные:
| Поле динамических данных | Описание |
|---|---|
${customerName} |
Имя клиента, начавшего разговор. |
${caseId} |
Уникальный ИД обращения. Система отображает ИД обращения, только если обращение связано с разговором. |
${caseTitle} |
Заголовок обращения. Система отображает заголовок обращения, только если обращение связано с разговором. |
${LiveWorkItemId} |
Уникальный ИД беседы. |
${queueId} |
Уникальный ИД очереди. Эта алфавитно-цифровая строка отображается в URL-адресе страницы очереди. |
${visitorLanguage} |
Язык клиента, инициировавшего разговор. |
${visitorDevice} |
Устройство клиента, инициировавшего разговор. |
${entityRoutingLogicalName} |
Имя сущности, если уведомление предназначено для записи сущности. |
${customerEntityName} |
Имя сущности (контакт или учетная запись), если клиент прошел проверку подлинности. |
${customerRecordId} |
Уникальный ИД сущности (контакт или учетная запись), если клиент прошел проверку подлинности. |
${<name of the pre-conversation survey questions>} |
Все вопросы опроса перед беседой, настроенные для рабочего потока, будут иметь имя динамических данных в качестве имени вопроса. |
Заметка
Только поле динамических данных ${anchor.<attribute_name>} поддерживается в макросах и скриптах для Customer Service workspace.
Динамические данные для ссылки повторного подключения
Следующие динамические данные используются для создания ссылки для повторного подключения, которая может быть передана клиентам для обратного подключения к тому же агенту и разговору. Дополнительные сведения: Настройка повторного подключения к предыдущему чату
| Поле динамических данных | Описание |
|---|---|
{ReconnectUrl{ReconnectID}} |
Используется в быстрых ответах для создания ссылки для повторного подключения. |
Формат для полей динамических данных для средств повышения производительности
Формат параметра ${Slug}, который извлекает контекст из поставщика канала, текущего сеанса пользователя, выходных данных других действий макроса или Dataverse.
Контекст автоматизации для повышения производительности
Если вы хотите выполнить поле динамических данных в контексте автоматизации производительности, которое используется для выполнения операций, связанных с приложениями на основе модели в Dynamics 365, используйте формат ${</slug/>} Например: ${customerName}
Контекст соединителя сеанса
Если вы хотите выполнить поле динамических данных в контексте сеанса, вы должны использовать формат ${$session.<slug>}. Например: ${$session.customerName}
Динамические данные, которые доступны для контекста сеанса, включают:
${$session.visitorDevice}${$session.visitorDevice}${$session.entityRoutingLogicalName}${$session.entityRoutingRecordId}${$session.<name of the pre-chat survey questions>
Контекст соединителя многоканального взаимодействия
Если вы хотите выполнить поле динамических данных в контексте многоканального взаимодействия для Customer Service, вы должны использовать формат ${$oc.<slug>}. Например: ${$oc.customerName}
Параметры Session.CurrentTab.<Attribute> и Session.AnchorTab.<Attribute> предоставляют контекстные данные на основе текущего сеанса и вкладки привязки или текущей вкладки в фокусе. Поддерживаются следующие типы атрибутов:
- EntityName
- EntityId
Примеры:
Session.CurrentTab.<EntityName>Session.CurrentTab.<EntityId>Session.AnchorTab.<EntityName>Session.AnchorTab.<EntityId>
Заметка
Параметры Session.CurrentTab.<Attribute> и Session.AnchorTab.<Attribute> применимы только к макросам и не применимы к шаблонам.
Поля динамических данных для шаблонов
Список поддерживаемых динамических данных:
| Динамический идентификатор | Description |
|---|---|
{anchor.<attribute_name>} |
Используется для доступа к атрибутам записи, загруженной на вкладке привязки. |
{customerName} |
Имя клиента, начавшего разговор. |
{caseId} |
Уникальный ИД обращения. Система отображает ИД обращения, только если обращение связано с разговором. |
{caseTitle} |
Заголовок обращения. Система отображает заголовок обращения, только если обращение связано с разговором. |
{queueId} |
Уникальный ИД очереди. Эта алфавитно-цифровая строка отображается в URL-адресе страницы очереди. |
{visitorLanguage} |
Язык клиента, инициировавшего разговор. |
{visitorDevice} |
Устройство клиента, инициировавшего разговор. |
{entityRoutingLogicalName} |
Имя сущности, если уведомление предназначено для записи сущности. |
{entityRoutingRecordId} |
Уникальный ИД записи сущности, если уведомление предназначено для записи сущности. |
{customerRecordId} |
Уникальный ИД сущности (контакт или учетная запись), если клиент прошел проверку подлинности. |
{<name of the pre-chat survey questions>} |
Все вопросы опроса перед беседой, настроенные для рабочего потока, будут иметь имя динамических данных в качестве имени вопроса. |
Формат для полей динамических данных для шаблонов
Формат параметра {Slug}, который получает контекст шаблона от поставщика канала, текущего сеанса пользователя или Dataverse. Например: {caseId}
Запросы OData
Вы можете использовать запросы OData, чтобы получить контексты, доступные из Dataverse.
Формат запроса OData следующий:
{$odata.<entityName>.<entityAttributeName>.<?options>}
Примеры:
{$odata.account.name.?$filter=accountid eq '{customerRecordId}'}{$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}{$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}
Статические значения
Это жестко заданные значения, которые вы обновляете на основе требований бизнеса. Для каждого жестко заданного атрибута, который вы выбираете, следуйте типу формата для определенного атрибута.
Пример (макрос):
Вы хотите, чтобы к названию обращения всегда добавлялось Contoso —. Вы используете действие Откройте новую форму, чтобы создать запись со следующими полями.
| Параметр | Значение |
|---|---|
| Логическое имя сущности | инцидент |
| Имя атрибута | Заголовок обращения |
| Значение атрибута | Contoso - {caseTitle} |
Вот, Contoso — — это жестко заданное статическое значение.
Пример (шаблоны):
Для входящего запроса на разговор вы должны предоставить статический заголовок сеанса и шаблон уведомления, который агенты видят в среде выполнения.
Заголовок уведомления = New chat request
Заголовок сеанса = Chat conversation
См. также
Управление шаблонами сеансов
Управление шаблонами вкладок приложения
Управление шаблонами уведомлений
Связывание шаблонов с рабочими потоками