Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article montre comment configurer la durée de fermeture automatique d’une conversation à l’aide de l’API Web.
Important
La fermeture automatique des conversations basée sur la durée n’est pas prise en charge pour les enregistrements configurés pour le routage unifié. Lorsque vous supprimez un enregistrement routé, l’élément de file d’attente associé est supprimé. L’élément de travail en direct ou la conversation est également supprimé dans le cadre du processus de nettoyage.
Utilisez la requête suivante GET pour récupérer tous les enregistrements de configuration qui ont été définis hors de la boîte.
Requête
GET [Organization URI]/api/data/v9.1/msdyn_occhannelstateconfigurations
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Réponse
{
"@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
},
]
}
L’attribut msdyn_name de l’entité msdyn_occhannelstateconfiguration mentionne le canal et l’état de la conversation. Découvrez les états de conversation dans Comprendre les états de conversation dans Omnichannel pour customer Service.
Vous pouvez faire une demande à l'entité GET pour récupérer msdyn_occhannelconfiguration tous les enregistrements de canal existants. Pour chacun de ces canaux, vous pouvez voir son état lorsque vous interrogez l’entité msdyn_occhannelstateconfiguration .
Effectuez une requête PATCH sur l’enregistrement de l’entité msdyn_occhannelstateconfiguration et actualisez la valeur de l’attribut 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
}
Voici un exemple de code pour mettre à jour les enregistrements existants dans l’entité msdyn_occhannelstateconfigurations :
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);
}
);
Remarque
La valeur de l’attribut msdyn_autocloseliveworkitemafter est exprimée en minutes. Si vous souhaitez fournir une valeur exprimée en jours, vous devez la convertir en minutes. Par exemple, 1 jour équivaut à 24 x 60 = 1 440 minutes.
La conversation se ferme automatiquement si la valeur de l’attribut msdyn_autocloseliveworkitemafter est supérieure à la valeur de l’attribut createdon .
Si la conversation est dans l'état de conclusion — autrement dit, si le représentant du service client (représentant ou agent) a résolu le problème et peut maintenant effectuer quelques étapes après la conversation pour la clôturer — la conversation est fermée si la valeur de l'attribut msdyn_autocloseliveworkitemafter est supérieure à celle de l'attribut wrapupinitiatedon.
Important
La décision de fermer une conversation en fonction des valeurs des attributs msdyn_autocloseliveworkitemafter et createdon est prise lors de l’exécution d’un travail planifié, et non lors de l’exécution de la requête API Web PATCH.
Configurer la fermeture automatique de l’état Wrap-up pour le chat en direct
Le délai par défaut de fermeture automatique d’un chat en direct qui est à l’état Conclusion est de 15 minutes. La valeur est définie dans l’attribut msdyn_autocloseliveworkitemafter que vous pouvez modifier par programmation en fonction des besoins de votre entreprise.
La valeur définie pour le champ Capacité de bloc pour la conclusion du flux de travail remplace la valeur spécifiée dans l’attribut msdyn_autocloseliveworkitemafter , si elle est supérieure à la valeur de l’attribut msdyn_autocloseliveworkitemafter . Par exemple, si vous avez défini la valeur de durée de blocage de la capacité du représentant sur 15 minutes et celle de l’attribut msdyn_autocloseliveworkitemafter sur 10 minutes, une conversation dans l’état Conclusion occupera la capacité pendant 15 minutes et ne sera éligible à la fermeture automatique qu’après 15 minutes.
Étapes suivantes
Mettre à jour une entité à l’aide de l’API Web