本文演示了如何使用 Web 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屬性提及聊天的頻道和狀態。 在了解 Customer Service 全通路中的交談狀態中了解交談狀態。
您可以向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 = 1440 分鐘。
如果 msdyn_autocloseliveworkitemafter 屬性的值大於 createdon 屬性的值，對話將自動關閉。
如果交談處於總結狀態，也就是說，客戶服務代表 （服務代表或代表） 已解決問題，現在可以執行一些交談後步驟來關閉交談，則如果屬性的 msdyn_autocloseliveworkitemafter 值大於屬性的 wrapupinitiatedon 值，則會關閉交談。
這很重要
根據 msdyn_autocloseliveworkitemafter 和 createdon 屬性的值關閉對話的決定是在計劃作業運行時做出的，而不是在運行PATCH Web API 請求時做出的。
設定即時聊天總結狀態的自動關閉
自動關閉處於 Wrap-up （總結 ） 狀態的即時聊天的預設時間為 15 分鐘。 該值定義在屬性中 msdyn_autocloseliveworkitemafter ，您可以以程式設計方式變更該屬性，以符合您的業務需求。
如果工作流中的 Block capacity for wrap-up 字段定義的值大於msdyn_autocloseliveworkitemafter屬性的值，則該值將覆蓋msdyn_autocloseliveworkitemafter屬性中指定的值。 例如，如果您將封鎖代表容量的值設定為 15 分鐘， msdyn_autocloseliveworkitemafter 並將屬性設定為 10 分鐘，則處於 總結狀態 的交談會佔用 15 分鐘的容量，並且只有在 15 分鐘後才有資格自動關閉。