Automatischen Abschluss von Unterhaltungen mithilfe der Web-API konfigurieren
Dieser Artikel verdeutlicht, um zu verstehen, wie Sie die Dauer des automatischen Schließens einer Unterhaltung mithilfe der Web-API konfigurieren.
Wichtig
Das dauerbasierte automatische Schließen von Konversationen wird für Datensätze, die für einheitliches Routing konfiguriert sind, nicht unterstützt. Wenn Sie einen weitergeleiteten Datensatz löschen, wird auch das zugehörige Warteschlangenelement gelöscht. Das Live-Arbeitselement oder die Unterhaltung wird im Rahmen des Bereinigungsprozesses ebenfalls gelöscht.
Verwenden Sie die folgende GET-Anforderung zum Abrufen aller Konfigurationsdatensätze, die standardmäßig definiert wurden.
Anforderung
GET [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Antwort
{
"@odata.context":"[Organization URI]/api/data/v9.1/$metadata#msdyn_occhannelstateconfigurations",
"value":[
{
"@odata.etag":"W/\"1379367\"",
"_organizationid_value":"758f70a9-7aba-4764-bdda-fcc0023a702f",
"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":"758f70a9-7aba-4764-bdda-fcc0023a702f",
"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
},
]
}
Das Attribut msdyn_name in der Entität msdyn_occhannelstateconfiguration zeigt den Kanal und den Status der Unterhaltung. Weitere Informationen zu Unterhaltungsstatus finden Sie unter Unterhaltungsstatus in Omnichannel für Kundenservice verstehen.
Sie können eine GET Anfrage an die msdyn_occhannelconfiguration Entität stellen, um alle vorhandenen Kanaldatensätze abzurufen. Für jeden dieser Kanäle können Sie mithilfe einer Abfrage an msdyn_occhannelstateconfiguration deren Status überprüfen.
Verfügbarmachen einer PATCH Anforderung für den msdyn_occhannelstateconfiguration Entitätsdatensatz und Aktualisieren des Wertes des msdyn_autocloseliveworkitemafter Attributs.
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
}
Hier ist ein Beispielcode zum Aktualisieren vorhandener Datensätze in der msdyn_occhannelstateconfigurations Entität:
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);
}
);
Anmerkung
Der Wert für das Attribut msdyn_autocloseliveworkitemafter ist in Minuten. Wenn Sie einen Wert in Tagen angeben möchten, müssen Sie ihn in Minuten umrechnen. Beispielsweise ist 1 Tag 24 x 60 = 1.440 Minuten.
Die Unterhaltung wird automatisch geschlossen, wenn der Wert des msdyn_autocloseliveworkitemafter-Attributs größer als der Wert des createdon-Attributs ist.
Wenn sich die Unterhaltung im Nachbearbeitungsstatus befindet – das heißt, der Agent hat das Problem gelöst und kann nun einige Schritte nach der Unterhaltung ausführen, um die Unterhaltung zu schließen – dann wird die Unterhaltung geschlossen, wenn der Wert des msdyn_autocloseliveworkitemafter-Attributs größer als der Wert des wrapupinitiatedon-Attributs ist.
Wichtig
Die Entscheidung, ein Gespräch basierend auf den Werten der msdyn_autocloseliveworkitemafter- und createdon-Attribute zu beenden, wird getroffen, wenn ein geplanter Job ausgeführt wird, und nicht, wenn die PATCH-Web-API-Anforderung ausgeführt wird.
Konfigurieren Sie das automatische Schließen des Nachbearbeitungsstatus für den Live-Chat
Die Standardzeit für das automatische Schließen eines Live-Chats, der im Status Zusammenfassen aktiv ist, beträgt 15 Minuten. Der Wert ist im msdyn_autocloseliveworkitemafter Attribut definiert und kann programmgesteuert an Ihre Geschäftsanforderungen angepasst werden.
Der definierte Wert für das Feld Blockkapazität für die Nachbearbeitung im Arbeitsstream überschreibt den Wert im msdyn_autocloseliveworkitemafter Attribut, wenn es größer ist als der Wert für das msdyn_autocloseliveworkitemafter Attribut. Wenn Sie beispielsweise den Wert für die Kapazität des Blockierungsmittels auf 15 Minuten eingestellt haben und den des msdyn_autocloseliveworkitemafter Attributs auf 10 Minuten, wird ein Gespräch im Status Zusammenfassen 15 Minuten lang die Kapazität belegen und kann erst nach 15 Minuten automatisch geschlossen werden.
Nächste Schritte,
Aktualisieren einer Entität mithilfe des Web-API