Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se muestra cómo puede configurar la duración del cierre automático de una conversación mediante la API web.
Importante
El cierre automático de conversaciones basado en la duración no es compatible con los registros configurados para el enrutamiento unificado. Al eliminar un registro enrutado, se elimina el elemento de cola asociado. El elemento de trabajo en directo o la conversación también se eliminan como parte del proceso de limpieza.
Utilice la siguiente GET solicitud para recuperar todos los registros de configuración que se han definido de forma predeterminada.
Solicitud
GET [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Respuesta
{
"@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
},
]
}
El msdyn_name atributo de la msdyn_occhannelstateconfiguration entidad menciona el canal y el estado de la conversación. Obtenga información sobre los estados de conversación en Descripción de los estados de conversación en Omnichannel para el servicio al cliente.
Puede realizar una GET solicitud a la msdyn_occhannelconfiguration entidad para obtener todos los registros de canal existentes. Para cada uno de estos canales, puede ver su estado al consultar la msdyn_occhannelstateconfiguration entidad.
Realice una PATCH solicitud al registro de entidad msdyn_occhannelstateconfiguration y actualice el valor del 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
}
Este es un código de ejemplo para actualizar los registros existentes en la msdyn_occhannelstateconfigurations entidad:
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:
El valor del msdyn_autocloseliveworkitemafter atributo se expresa en minutos. Si desea proporcionar un valor que esté en días, debe convertirlo en minutos. Por ejemplo, 1 día es 24 x 60 = 1.440 minutos.
La conversación se cierra automáticamente si el valor del msdyn_autocloseliveworkitemafter atributo es mayor que el valor del createdon atributo.
Si la conversación está en el estado de finalización, es decir, el representante del servicio al cliente (representante de servicio o representante) resolvió el problema y ahora puede realizar pasos posteriores para cerrarla, la conversación se cierra si el valor del atributo msdyn_autocloseliveworkitemafter es mayor que el valor del atributo wrapupinitiatedon.
Importante
La decisión de cerrar una conversación en función de los valores de los msdyn_autocloseliveworkitemafter atributos and createdon se toma cuando se ejecuta un trabajo programado y no cuando se ejecuta la solicitud de la PATCH API web.
Configurar el cierre automático del estado Conclusión para el chat en vivo
El tiempo predeterminado para cerrar automáticamente un chat en vivo que está en estado de finalización es de 15 minutos. El valor se define en el msdyn_autocloseliveworkitemafter atributo que puede cambiar mediante programación para satisfacer sus necesidades empresariales.
El valor definido para el campo Capacidad de bloque para finalización en el flujo de trabajo anula el valor especificado en el msdyn_autocloseliveworkitemafter atributo, si es mayor que el valor del msdyn_autocloseliveworkitemafter atributo. Por ejemplo, si establece el valor para bloquear la capacidad del agente en 15 minutos, y el atributo msdyn_autocloseliveworkitemafter como 10 minutos, una conversación en estado Conclusión ocupa la capacidad durante 15 minutos y es elegible para cierre automático solo después de 15 minutos.
Pasos siguientes
Actualización de una entidad mediante la API web