Freigeben über


automatischen Abschluss von Unterhaltungen mithilfe der Web-API konfigurieren

In diesem Artikel wird veranschaulicht, wie Sie die Dauer des automatischen Schließens einer Konversation mithilfe der Web-API konfigurieren können.

Von Bedeutung

Das dauerbasierte automatische Schließen von Unterhaltungen wird für Datensätze, die für einheitliches Routing konfiguriert sind, nicht unterstützt. Wenn Sie einen weitergeleiteten Datensatz löschen, wird das zugeordnete Warteschlangenelement gelöscht. Die Löschung des Live-Arbeitsobjekts oder Gesprächs erfolgt ebenfalls im Rahmen des Bereinigungsprozesses.

Verwenden Sie die folgende GET Anforderung, um alle Konfigurationsdatensätze abzurufen, 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":"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
      },
   ]
}

Das msdyn_name Attribut in der msdyn_occhannelstateconfiguration Entität erwähnt den Kanal und den Status der Konversation. Erfahren Sie mehr über Gesprächszustände im Omnichannel für den Kundendienst.

Sie können eine GET Anforderung an die msdyn_occhannelconfiguration Entität senden, um alle vorhandenen Kanaldatensätze abzurufen. Für jeden dieser Kanäle können Sie seinen Status sehen, wenn Sie die msdyn_occhannelstateconfiguration Entität abfragen.

Stellen Sie eine PATCH Anforderung an den msdyn_occhannelstateconfiguration Entitätsdatensatz und aktualisieren Sie den Wert des Attributs 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
}

Im Folgenden finden Sie einen 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);
    }
);

Hinweis

Der Wert für das msdyn_autocloseliveworkitemafter Attribut wird in Minuten angegeben. Wenn Sie einen Wert angeben möchten, der in Tagen angegeben wird, müssen Sie ihn in Minuten umwandeln. Beispiel: 1 Tag ist 24 x 60 = 1.440 Minuten.

Die Konversation wird automatisch geschlossen, wenn der Wert des Attributs msdyn_autocloseliveworkitemafter größer ist als der Wert des Attributs createdon .

Wenn sich die Unterhaltung im Abschlusszustand befindet – das heißt, der Kundendienstmitarbeiter (Servicemitarbeiter oder Vertreter) hat das Problem gelöst und kann nun einige Schritte nach der Unterhaltung ausführen, um die Unterhaltung abzuschließen – dann wird die Unterhaltung geschlossen, wenn der Wert des msdyn_autocloseliveworkitemafter Attributs größer als der Wert des wrapupinitiatedon Attributs ist.

Von Bedeutung

Die Entscheidung, eine Konversation basierend auf den Werten der msdyn_autocloseliveworkitemafter Attribute und createdon zu schließen, wird getroffen, wenn ein geplanter Auftrag 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 sich im Nachbearbeitungsstatus befindet, beträgt 15 Minuten. Der Wert wird im msdyn_autocloseliveworkitemafter Attribut definiert, das Sie programmgesteuert entsprechend Ihren Geschäftlichen Anforderungen ändern können.

Der für das Feld Blockkapazität für Nachbearbeitung im Arbeitsstream definierte Wert überschreibt den im msdyn_autocloseliveworkitemafter Attribut angegebenen Wert, wenn er höher ist als der Wert für das msdyn_autocloseliveworkitemafter Attribut. Wenn Sie z. B. den Wert für die Blockierung der Kapazität eines Vertreters auf 15 Minuten und das msdyn_autocloseliveworkitemafter Attribut als 10 Minuten festlegen, belegt eine Unterhaltung im Wrap-up-Zustand die Kapazität von 15 Minuten und ist nur nach 15 Minuten für die automatische Schließung berechtigt.

Nächste Schritte

Aktualisieren einer Entität mithilfe der Web-API

Automatisches Beenden von Konversationen