この記事では、Web API を使用して会話の自動終了期間を構成する方法について説明します。
Von Bedeutung
期間ベースの会話の自動終了は、統合ルーティング用に構成されたレコードではサポートされていません。 ルーティングされたレコードを削除すると、関連付けられているキュー アイテムが削除されます。 ライブ作業項目または会話もクリーンアップ プロセスの一部として削除されます。
以下の 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 属性は、会話のチャネルと状態を示します。 会話の状態については、「 カスタマー サービスのオムニチャネルの会話状態を理解する」を参照してください。
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_autocloseliveworkitemafter 属性の値が createdon 属性の値より大きい場合、会話は自動的に終了します。
会話がラップアップ状態である場合 (つまり、顧客サービス担当者 (サービス担当者または担当者) が問題を解決し、会話後の手順を実行して会話を終了できるようになりました。 msdyn_autocloseliveworkitemafter 属性の値が wrapupinitiatedon 属性の値より大きい場合、会話は閉じられます。
Von Bedeutung
msdyn_autocloseliveworkitemafter 属性と createdon 属性の値に基づいて会話を閉じるかどうかは、スケジュールされたジョブの実行時に行われ、PATCH Web API 要求の実行時には行われません。
ライブチャットのラップアップ状態の自動終了を構成する
ラップアップ状態のライブ チャットを自動的に閉じる既定の時間は 15 分です。 この値は、ビジネス ニーズに合わせてプログラムによって変更できる msdyn_autocloseliveworkitemafter 属性で定義されます。
作業ストリームの ラップアップのブロック容量 フィールドに定義された値は、 msdyn_autocloseliveworkitemafter 属性で指定された値を上書きします ( msdyn_autocloseliveworkitemafter 属性の値より大きい場合)。 たとえば、ブロッキング担当者の容量の値を 15 分に設定し、 msdyn_autocloseliveworkitemafter 属性を 10 分として設定した場合、 ラップアップ 状態の会話は 15 分間の容量を占有し、15 分後にのみ自動クローズの対象となります。