이 문서에서는 웹 API를 사용하여 대화의 자동 종료 기간을 구성하는 방법을 보여 줍니다.
중요합니다
기간별 대화 자동 종료는 통합 회람에 대해 구성된 레코드에 대해 지원되지 않습니다. 라우팅된 레코드를 삭제하면 연결된 큐 항목이 삭제됩니다. 라이브 작업 항목 또는 대화도 정리 프로세스의 일부로 삭제됩니다.
다음 GET 요청을 사용하여 즉시 정의된 모든 구성 레코드를 가져옵니다.
요청
GET [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
응답
{
"@odata.context":"[Organization URI]/api/data/v9.1/$metadata#msdyn_occhannelstateconfigurations",
"value":[
{
"@odata.etag":"W/\"1379367\"",
"_organizationid_value":"11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
"msdyn_name":"Live Chat - Open",
"statecode":0,
"statuscode":1,
"_msdyn_occhannelconfigurationid_value":"836717fd-5578-e911-8196-000d3af7d71e",
"msdyn_autocloseliveworkitemafter":20,
"modifiedon":"2019-10-01T13:41:51Z",
"_modifiedby_value":"d6e088ce-8866-4b3d-8ea2-150ad72e2b79",
"msdyn_ocliveworkitemstate":0,
"msdyn_showconfirmationonsessionclose":false,
"versionnumber":1379367,
"msdyn_occhannelstateconfigurationid":"6283ab63-5778-e911-8196-000d3af7d71e",
"createdon":"2019-10-01T13:41:51Z",
"_createdby_value":"d6e088ce-8866-4b3d-8ea2-150ad72e2b79",
"_modifiedonbehalfby_value":null,
"importsequencenumber":null,
"overriddencreatedon":null,
"_createdonbehalfby_value":null,
"utcconversiontimezonecode":null,
"timezoneruleversionnumber":null
},
{
"@odata.etag":"W/\"1379368\"",
"_organizationid_value":"11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
"msdyn_name":"Live Chat - Active",
"statecode":0,
"statuscode":1,
"_msdyn_occhannelconfigurationid_value":"836717fd-5578-e911-8196-000d3af7d71e",
"msdyn_autocloseliveworkitemafter":null,
"modifiedon":"2019-10-01T13:41:51Z",
"_modifiedby_value":"d6e088ce-8866-4b3d-8ea2-150ad72e2b79",
"msdyn_ocliveworkitemstate":1,
"msdyn_showconfirmationonsessionclose":true,
"versionnumber":1379368,
"msdyn_occhannelstateconfigurationid":"e2737c9a-5778-e911-8196-000d3af7d71e",
"createdon":"2019-10-01T13:41:51Z",
"_createdby_value":"d6e088ce-8866-4b3d-8ea2-150ad72e2b79",
"_modifiedonbehalfby_value":null,
"importsequencenumber":null,
"overriddencreatedon":null,
"_createdonbehalfby_value":null,
"utcconversiontimezonecode":null,
"timezoneruleversionnumber":null
},
]
}
msdyn_name 엔터티의 msdyn_occhannelstateconfiguration 특성은 대화의 채널과 상태를 나타냅니다.
고객 서비스용 Omnichannel의 대화 상태를 이해하기에 대해 알아봅니다.
GET 요청을 통해 msdyn_occhannelconfiguration 엔터티에서 모든 기존 채널 레코드를 가져올 수 있습니다. 이러한 각 채널에 대해 엔터티를 쿼리할 때 해당 상태를 볼 수 있습니다 msdyn_occhannelstateconfiguration .
PATCH 엔터티 레코드에 msdyn_occhannelstateconfiguration 대한 요청을 수행하고 특성의 msdyn_autocloseliveworkitemafter 값을 업데이트합니다.
PATCH [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations(6283ab63-5778-e911-8196-000d3af7d71e)
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
{
"msdyn_autocloseliveworkitemafter":5
}
다음은 msdyn_occhannelstateconfigurations 엔터티의 기존 레코드를 업데이트하기 위한 샘플 코드입니다.
var data =
{
"msdyn_autocloseliveworkitemafter": 2
}
// update the record
Xrm.WebApi.updateRecord("msdyn_occhannelstateconfiguration", "6283ab63-5778-e911-8196-000d3af7d71e", data).then(
function success(result) {
console.log("Auto close time updated");
},
function (error) {
console.log(error.message);
}
);
비고
속성의 값은 msdyn_autocloseliveworkitemafter 분 단위입니다. 일 단위의 값을 제공하려면 분으로 변환해야 합니다. 예를 들어 1일은 24 x 60 = 1,440분입니다.
특성의 값이 특성의 msdyn_autocloseliveworkitemaftercreatedon 값보다 크면 대화가 자동으로 닫힙니다.
대화가 마무리 상태인 경우, 즉 고객 서비스 담당자가 문제를 해결하고 이제 대화 후 단계를 수행하여 대화를 닫을 수 있는 경우, msdyn_autocloseliveworkitemafter 특성 값이 wrapupinitiatedon 특성 값보다 크면 대화가 닫힙니다.
중요합니다
msdyn_autocloseliveworkitemafter 및 createdon 특성의 값을 기반으로 대화를 닫는 결정은 웹 API 요청이 실행될 때가 아니라, 예약된 작업이 실행될 때 이루어집니다.
라이브 채팅에 대한 마무리 상태의 자동 종료 구성
후속 작업 상태인 실시간 채팅을 자동으로 종료하는 기본 시간은 15분입니다. 비즈니스 요구에 맞게 프로그래밍 방식으로 변경할 수 있는 msdyn_autocloseliveworkitemafter 속성에 이 값이 정의됩니다.
작업 스트림의 Block capacity for wrap-up 필드에 대해 정의된 값이 msdyn_autocloseliveworkitemafter 속성에 지정된 값을 초과하는 경우, msdyn_autocloseliveworkitemafter 속성의 값을 무시합니다. 예를 들어 담당자의 용량 차단 값을 15분 msdyn_autocloseliveworkitemafter 으로 설정하고 특성을 10분으로 설정하는 경우 래핑 상태의 대화는 15분 동안의 용량을 차지하고 15분 후에만 자동 닫을 수 있습니다.