자동화 사전을 사용하여 매개 변수 키 전달
자동화 사전은 세션에 대한 컨텍스트 데이터를 유지합니다. 자동화 사전의 키를 사용하여 조치에서 매개 변수를 전달할 수 있습니다.
관리 앱에서 템플릿 및 매크로를 생성하는 동안 세션 제목, 알림 제목, 애플리케이션 탭 템플릿 제목 및 애플리케이션 탭 유형에 대한 사용자 정의 매개변수 값과 같은 매개변수 키를 전달할 수 있습니다. 이 키는 실행시 사용 가능한 컨텍스트 정보에 따라 바뀝니다.
템플릿의 데이터 매개 변수 전달
알림이 포함된 템플릿의 시나리오를 살펴 보겠습니다.
알림에는 필드 헤더 및 값이라는 특정 필드와 값이 각각 표시됩니다.
고객인 Kenny Smith가 대화를 시작했으며 에이전트가 알림을 볼 때 고객 이름이 Kenny Smith로 표시됩니다.
여기에서 필드 헤더는 고객 이름이고 값은 Kenny Smith입니다.
템플릿에서 고객의 이름을 Kenny Smith로 식별하려면 관리자가 매개 변수를 키로 전달해야 합니다.
마찬가지로 세션 및 알림 제목의 경우 데이터 매개 변수를 전달할 수 있습니다. 추가 정보: 데이터 매개 변수 키에 대한 자동화 사전 형식
시스템은 세션, 채널 공급자, Microsoft Dataverse 및 사용자 작업의 컨텍스트에 따라 이 매개 변수 키를 실제 값으로 대체합니다. 추가 정보: 컨텍스트 데이터 매개 변수의 유형
매크로 및 에이전트 스크립트에서 데이터 매개 변수 전달
매크로는 사용자가 요청하면 실행하는 일련의 구성된 순차적 동작입니다. 관리자는 매크로가 수행해야 하는 작업을 구성해야 합니다. 작업을 구성하려면 데이터 매개 변수를 전달해야 합니다. 추가 정보: 데이터 매개 변수 키를 전달하는 자동화 사전 형식
에이전트가 매크로를 실행하면 시스템은 세션, 채널 공급자, Dataverse 및 사용자 작업의 컨텍스트에 따라 이 매개 변수 키를 실제 값으로 대체합니다.
컨텍스트가 세션에서 온 경우 매크로 작업은 현재 세션에 대한 정보를 기반으로 실행되며 여기서 정보는 초점이 있는 기준 위치 탭 또는 현재 탭에서 가져옵니다. 예를 들어 서비스 케이스를 만들려면 문제 엔터티 양식과 양식의 GUID(선택 사항)를 포함하는 작업을 정의해야 합니다. 추가 정보: 컨텍스트 데이터 매개 변수의 유형
컨텍스트 데이터 매개 변수의 유형
자동화 사전은 다음 소스에서 사용 가능한 컨텍스트 데이터 매개 변수를 사용합니다.
채널 공급자의 컨텍스트 데이터
이 컨텍스트 데이터는 Customer Service용 옴니채널과 같은 자사 채널 공급자 또는 Dynamics 365 채널 통합 프레임워크에 의해 노출된 위젯을 사용하는 타사 채널 공급자의 데이터입니다. Customer Service용 옴니채널의 컨텍스트 데이터는 대화 전 설문 조사, 방문자 포털 탐색 등입니다.
사용자 작업의 컨텍스트 데이터
에이전트가 세션에서 일부 활동을 수행할 때 이 데이터가 채워집니다. 예를 들어 새로운 고객 레코드, 서비스 케이스 등을 여는 것이 있습니다.
Dataverse의 컨텍스트 데이터
조직 데이터는 Dataverse에 저장되며 OData 쿼리를 사용하여 데이터를 가져올 수 있습니다. 추가 정보: OData 쿼리
다른 매크로 작업의 컨텍스트 데이터
매크로의 작업은 해당 매크로의 다른 작업에 사용되는 컨텍스트 데이터를 생성합니다.
예를 들어, 다음 순서로 두 가지 작업 단계가 있습니다.
- 새 양식을 열어 레코드를 만듭니다.
- 미리 정의된 템플릿으로 이메일 양식을 엽니다.
미리 정의된 템플릿으로 전자 메일 양식 열기 작업을 만드는 동안 새 양식을 열어 레코드 만들기 매크로 작업 단계에서 컨텍스트 데이터 매개 변수 키를 얻을 수 있습니다.
첫 번째 매크로 작업의 컨텍스트 데이터 매개 변수는 다음과 같습니다.
- 엔터티 논리적 이름
- 페이지 유형
- 탭 ID
노트
다른 매크로 작업의 컨텍스트 데이터 매개 변수는 매크로에만 적용되며 템플릿에는 적용되지 않습니다.
데이터 매개 변수 키 전달에 대한 자동화 사전 형식
자동화 사전은 세션에 대한 컨텍스트 데이터를 유지합니다. 자동화 사전의 키는 매크로의 작업에 매개 변수로 전달될 수 있습니다. 시스템은 세션, 채널 공급자, Dataverse 및 사용자 작업의 컨텍스트에 따라 이 매개 변수 키를 실제 값으로 대체합니다.
자동화 사전은 다음 형식을 지원합니다.
슬러그
동적 필드는 컨텍스트에 따라 런타임 시 시스템에서 입력하는 대체 매개 변수입니다. 매크로 및 에이전트 스크립트에만 다음 동적 필드 목록을 사용하고 에이전트 스크립트 식 작성기를 사용하여 에이전트 스크립트를 기본값으로 설정하십시오. 추가 정보: 생산성 도구
생산성 도구(매크로 및 에이전트 스크립트)용 동적 필드
매크로 및 에이전트 스크립트는 다음과 같은 슬러그를 지원합니다.
| 슬러그 | 설명 |
|---|---|
${customerName} |
대화를 시작한 고객의 이름입니다. |
${caseId} |
서비스 케이스의 고유 ID입니다. 서비스 케이스가 대화에 연결된 경우에만 서비스 케이스 ID가 표시됩니다. |
${caseTitle} |
서비스 케이스의 제목입니다. 서비스 케이스가 대화에 연결된 경우에만 서비스 케이스 제목이 표시됩니다. |
${LiveWorkItemId} |
대화의 고유 ID입니다. |
${queueId} |
큐의 고유 ID입니다. 이 영숫자 문자열은 큐 페이지 URL에 표시됩니다. |
${visitorLanguage} |
대화를 시작한 고객의 언어입니다. |
${visitorDevice} |
대화를 시작한 고객의 장치입니다. |
${entityRoutingLogicalName} |
알림이 엔터티 레코드에 대한 것이면 엔터티의 이름입니다. |
${customerEntityName} |
고객이 인증된 경우 엔터티의 이름(연락처 또는 거래처)입니다. |
${customerRecordId} |
고객이 인증된 경우 엔터티의 고유 ID(연락처 또는 거래처)입니다. |
${<name of the pre-conversation survey questions>} |
작업 스트림에 대해 구성된 모든 대화 전 설문 질문에는 질문 이름으로 슬러그 이름이 있습니다. |
노트
Customer Service workspace의 매크로 및 스크립트에는 ${anchor.<attribute_name>} 동적 필드만 지원됩니다.
재연결 링크용 슬러그
다음 슬러그는 동일한 에이전트 및 대화에 다시 연결하기 위해 고객과 공유할 수 있는 재연결 링크를 생성하는 데 사용됩니다. 추가 정보: 이전 채팅에 대한 재연결 구성
| 슬러그 | 설명 |
|---|---|
{ReconnectUrl{ReconnectID}} |
재연결 링크를 생성하기 위해 빠른 응답에 사용됩니다. |
생산성 도구용 동적 필드 형식
채널 공급자, 현재 사용자 세션, 기타 매크로 작업의 출력 또는 Dataverse에서 컨텍스트를 검색하는 ${Slug} 매개 변수 형식.
생산성 자동화 컨텍스트
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} |
서비스 케이스의 고유 ID입니다. 서비스 케이스가 대화에 연결된 경우에만 서비스 케이스 ID가 표시됩니다. |
{caseTitle} |
서비스 케이스의 제목입니다. 서비스 케이스가 대화에 연결된 경우에만 서비스 케이스 제목이 표시됩니다. |
{queueId} |
큐의 고유 ID입니다. 이 영숫자 문자열은 큐 페이지 URL에 표시됩니다. |
{visitorLanguage} |
대화를 시작한 고객의 언어입니다. |
{visitorDevice} |
대화를 시작한 고객의 장치입니다. |
{entityRoutingLogicalName} |
알림이 엔터티 레코드에 대한 것이면 엔터티의 이름입니다. |
{entityRoutingRecordId} |
알림이 엔터티 레코드에 대한 것이면 엔터티 레코드의 고유 ID입니다. |
{customerRecordId} |
고객이 인증된 경우 엔터티의 고유 ID(연락처 또는 거래처)입니다. |
{<name of the pre-chat survey questions>} |
워크스트림에 대해 구성된 모든 채팅 전 설문 질문에는 질문 이름으로 슬러그 이름이 있습니다. |
템플릿용 동적 필드 형식
채널 공급자, 현재 사용자 세션 또는 Dataverse에서 템플릿 컨텍스트를 검색하는 {Slug} 매개 변수 형식. 예: {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 -가 추가되기를 원합니다. 다음 필드로 새 양식을 열어 레코드 만들기 작업을 사용합니다.
| 매개 변수 | 값 |
|---|---|
| 엔터티 논리 이름 | incident |
| 특성 이름 | 서비스 케이스 제목 |
| 특성 값 | Contoso - {caseTitle} |
여기에서 Contoso -는 하드 코딩된 정적 값입니다.
예(템플릿):
수신 채팅 요청의 경우, 런타임 시 에이전트에게 표시하는 세션 및 알림 템플릿에 정적 제목을 제공하려고 합니다.
알림 제목 = New chat request
세션 제목 = Chat conversation