Udostępnij przez

Konfigurowanie automatycznego zamykania konwersacji za pomocą interfejsu API sieci Web

W tym artykule pokazano, jak skonfigurować czas trwania automatycznego zamykania konwersacji przy użyciu internetowego interfejsu API.

Ważne

Automatyczne zamykanie konwersacji na podstawie czasu trwania nie jest obsługiwane w przypadku rekordów, które są skonfigurowane do ujednoliconego rozsyłania. Po usunięciu rozsyłanego rekordu skojarzony element kolejki też jest usuwany. Element roboczy lub konwersacja na żywo jest również usuwana w ramach procesu czyszczenia.

Użyj następującego GET żądania, aby pobrać wszystkie rekordy konfiguracji, które zostały zdefiniowane domyślnie.

Zażądaj

GET [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Odpowiedź

{ 
   "@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
      },
   ]
}

Atrybut msdyn_name w msdyn_occhannelstateconfiguration jednostce wspomina o kanale i stanie konwersacji. Poznaj stany konwersacji w Omnichannel for Customer Service.

Możesz wysłać GET żądanie do msdyn_occhannelconfiguration encji w celu pobrania wszystkich istniejących rekordów kanału. Dla każdego z tych kanałów można zobaczyć jego stan podczas wykonywania zapytania dotyczącego msdyn_occhannelstateconfiguration jednostki.

Przekaż żądanie PATCH do rekordu encji msdyn_occhannelstateconfiguration i zaktualizuj wartość atrybutu 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
}

Oto przykładowy kod służący do aktualizowania istniejących rekordów w msdyn_occhannelstateconfigurations encji:

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);
    }
);

Uwaga / Notatka

Wartość atrybutu msdyn_autocloseliveworkitemafter jest podawana w minutach. Jeśli chcesz podać wartość wyrażoną w dniach, musisz przekonwertować ją na minuty. Na przykład 1 dzień to 24 x 60 = 1 440 minut.

Konwersacja zostanie automatycznie zamknięta, jeśli wartość atrybutu msdyn_autocloseliveworkitemafter jest większa niż wartość atrybutu createdon .

Jeśli konwersacja jest w stanie podsumowania — co oznacza, że przedstawiciel obsługi klienta (przedstawiciel usługi lub przedstawiciel) rozwiązał problem i może teraz wykonać kilka czynności po zakończeniu rozmowy, aby ją zamknąć — rozmowa zostaje zamknięta, jeśli wartość atrybutu msdyn_autocloseliveworkitemafter jest większa niż wartość atrybutu wrapupinitiatedon.

Ważne

Decyzja o zamknięciu konwersacji na podstawie wartości atrybutów msdyn_autocloseliveworkitemafter i createdon jest podejmowana po uruchomieniu zaplanowanego zadania, a nie po PATCH uruchomieniu żądania internetowego interfejsu API.

Skonfiguruj automatyczne zamykanie stanu podsumowania dla czatu na żywo

Domyślny czas automatycznego zamykania czatu na żywo, który jest w stanie podsumowania , to 15 minut. Wartość jest zdefiniowana w atrybucie msdyn_autocloseliveworkitemafter , który można programowo zmienić zgodnie z potrzebami biznesowymi.

Wartość zdefiniowana dla pola Pojemność bloku do zawijania w strumieniu pracy zastępuje wartość określoną w msdyn_autocloseliveworkitemafter atrybucie, jeśli jest większa niż wartość atrybutu msdyn_autocloseliveworkitemafter . Na przykład, jeśli ustawiono wartość dla blokowania dyspozycyjności agenta na 15 minut, a atrybut msdyn_autocloseliveworkitemafter na 10 minut, konwersacja w stanie Opakowane zajmie dyspozycyjność przez 15 minut i będzie kwalifikować się do automatycznego zamknięcia dopiero po 15 minutach.

Dalsze kroki

Aktualizowanie jednostki przy użyciu internetowego interfejsu API

Automatyczne zamykanie rozmów

  • Last updated on