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