Configurar peche automático de conversas mediante a API web

Este artigo mostra como configurar a duración do peche automático dunha conversa usando a API web.

Importante

O peche automático baseado na duración das conversas non está soportado para os rexistros configurados para o enrutamento unificado. Ao eliminar un rexistro enrutado, o elemento da cola asociado elimínase. O elemento de traballo ou conversa en directo tamén se elimina como parte do proceso de limpeza.

Use a seguinte GET solicitude para obter todos os rexistros de configuración que foron definidos fóra da caixa.

Solicitude

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

Resposta

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

O msdyn_name atributo da msdyn_occhannelstateconfiguration entidade menciona a canle e o estado da conversa. Aprende sobre os estados da conversa en Comprender os estados da conversa en Omnicanal para o servizo ao cliente.

Pode facer unha solicitude GET á msdyn_occhannelconfiguration entidade para obter todos os rexistros da canle existentes. Para cada unha destas canles, podes ver o seu estado cando consultas a msdyn_occhannelstateconfiguration entidade.

Realizar unha solicitude PATCH ao rexistro da msdyn_occhannelstateconfiguration entidade e actualizar o valor do msdyn_autocloseliveworkitemafter atributo.

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
}

Aquí tes unha mostra de código para actualizar os rexistros existentes na msdyn_occhannelstateconfigurations entidade:

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

Nota

O valor do msdyn_autocloseliveworkitemafter atributo é en minutos. Se queres proporcionar un valor que sexa en días, tes que convertelo en minutos. Por exemplo, 1 día é 24 x 60 = 1.440 minutos.

A conversa péchase automaticamente se o valor do msdyn_autocloseliveworkitemafter atributo é maior que o valor do createdon atributo.

Se a conversa está no estado de finalización, é dicir, o representante do servizo de atención ao cliente (representante do servizo ou representante) resolveu o problema e agora pode realizar algúns pasos posteriores á conversa para pechar a conversa, entón a conversa péchase se o valor do msdyn_autocloseliveworkitemafter atributo é maior que o valor do wrapupinitiatedon atributo.

Importante

A decisión de pechar unha conversa baseada nos valores dos msdyn_autocloseliveworkitemafter atributos e createdon tómase cando se executa unha tarefa programada, e non cando se executa a solicitude PATCH de API web.

Configurar o peche automático do estado de envoltorio para o chat en directo

O tempo predeterminado para pechar automaticamente un chat en directo que está en estado de Wrap-up é de 15 minutos. O valor defínese no msdyn_autocloseliveworkitemafter atributo que podes cambiar programáticamente para adaptarse ás necesidades da túa empresa.

O valor definido para o campo Bloquear capacidade para envoltura no fluxo de traballo ignora o valor especificado no msdyn_autocloseliveworkitemafter atributo, se é maior que o valor do msdyn_autocloseliveworkitemafter atributo. Por exemplo, se establece o valor para bloquear a capacidade do representante como 15 minutos e o msdyn_autocloseliveworkitemafter atributo como 10 minutos, unha conversa en estado Wrap-up ocupa capacidade durante 15 minutos e só pode pecharse automaticamente despois de 15 minutos.

Pasos seguintes

Actualizar unha entidade usando a API web

Peche automático de conversas