Partilhar via


Configurar o fecho automático das conversações com a API Web

Este artigo demonstra como você pode configurar a duração do fechamento automático de uma conversa usando a API da Web.

Importante

O encerramento automático de conversas com base na duração não é suportado para registros configurados para roteamento unificado. Quando você exclui um registro roteado, o item de fila associado é excluído. O item de trabalho em direto ou conversação também é eliminado como parte do processo de limpeza.

Utilize a solicitação a seguir GET para buscar todos os registros de configuração que foram definidos de fábrica.

Pedido

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 na msdyn_occhannelstateconfiguration entidade menciona o canal e o estado da conversa. Saiba mais sobre os estados da conversação em Compreender os estados da conversação no Omnichannel for Customer Service.

Você pode fazer uma GET solicitação à msdyn_occhannelconfiguration entidade para buscar todos os registros de canal existentes. Para cada um desses canais, você pode ver seu estado quando consulta a msdyn_occhannelstateconfiguration entidade.

Faça uma PATCH solicitação ao msdyn_occhannelstateconfiguration registo da entidade e atualize o valor do atributo 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
}

Aqui está um código de exemplo para atualizar os registros 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);
    }
);

Observação

O valor do msdyn_autocloseliveworkitemafter atributo é em minutos. Se você quiser fornecer um valor que é em dias, você tem que convertê-lo em minutos. Por exemplo, 1 dia é 24 x 60 = 1.440 minutos.

A conversa é encerrada automaticamente se o valor do msdyn_autocloseliveworkitemafter atributo for maior do que o valor do createdon atributo.

Se a conversa estiver no estado de encerramento, ou seja, o representante do atendimento ao cliente (representante ou representante de serviço) resolveu o problema e agora pode executar algumas etapas pós-conversa para fechar a conversa, a conversa será encerrada se o valor do msdyn_autocloseliveworkitemafter atributo for maior do que o valor do wrapupinitiatedon atributo.

Importante

A decisão de fechar uma conversa com base nos valores dos atributos msdyn_autocloseliveworkitemafter e createdon é tomada quando um trabalho agendado é executado, e não quando a solicitação de Web API PATCH é executada.

Configurar o fechamento automático do estado de Wrap-up para bate-papo ao vivo

O tempo padrão para fechar automaticamente um bate-papo ao vivo que está no estado Wrap-up é de 15 minutos. O valor é definido no msdyn_autocloseliveworkitemafter atributo que você pode alterar programaticamente para atender às suas necessidades de negócios.

O valor definido para o campo Capacidade de bloco para encapsulamento no fluxo de trabalho substitui o valor especificado no msdyn_autocloseliveworkitemafter atributo, se for maior que o valor do msdyn_autocloseliveworkitemafter atributo. Por exemplo, se você definir o valor para bloquear a capacidade do representante como 15 minutos e o msdyn_autocloseliveworkitemafter atributo como 10 minutos, uma conversa no estado Wrap-up ocupará a capacidade por 15 minutos e será qualificada para encerramento automático somente após 15 minutos.

Próximos passos

Atualizar uma entidade usando a API da Web

Encerramento automático de conversas