"CCaaS_ObtenirDisponibilitéReprésentantPourConversation"

Utilisez l’API CCaaS_GetRepresentativeAvailabilityForConversation pour obtenir la disponibilité de la file d’attente et du représentant du service pendant une conversation active avec un ID de conversation valide.

Par exemple, lorsqu’un client qui discute avec un agent IVR ou AI demande une escalade vers un représentant de service, l’agent IA appelle cette API pour déterminer la disponibilité du représentant du service et acheminer la conversation en fonction de la réponse.

Détails de la demande

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

Méthode

POST

Version

1.0

En-têtes de demande

Nom Description
Autorisation Obligatoire. Microsoft Entra ID jeton porteur pour l’appelant de l'API dans l’instance du centre de contact. En savoir plus sur le jeton d’installation pour l’autorisation d’API

Corps de demande d’échantillon

Description Exemple de requête
Détermine la disponibilité de la file d’attente et des représentants pour une conversation active. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
Déterminez la disponibilité de la file d’attente et de l’agent pour une conversation où les règles de routage vers la file d’attente nécessitent davantage d’éléments de contexte. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
La règle concerne l’enquête sur l’élément de contexte (type : Texte, valeur : Inde) curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

Note

  • Dans le corps de la requête, CustomContextItems est une chaîne avec les éléments de contexte utilisés dans les règles de routage vers une file d'attente. Exemple de liste d’éléments de contexte :

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable indique si l’élément de contexte s’affiche à l’écran. Cette valeur est True ou False.

  • datatype peut uniquement être Text = 192350000 ou Integer = 192350001

Réponse

Si elle réussit, cette méthode retourne un code de réponse 200 OK. La méthode retourne également les codes d’état suivants.

État HTTP Description
400 Mauvaise requête (mauvais paramètres d’entrée)
401 Non autorisé
404 Ressource non trouvée
429 Limite de taux (trop de demandes)
405 API non autorisée
500 Erreur interne du serveur

Valeurs de réponse

Nom Type Description
queueId String File d’attente cible où la requête est routée en fonction des configurations de règle de routage et des données d’entrée telles que les valeurs d’entité et le contexte qui font partie de la règle de routage.
isQueueAvailable Boolean Affiche TRUE si la file d’attente se trouve dans les heures d’exploitation. FALSE si la file d’attente est en dehors des heures d’exploitation.
Heure de début de la prochaine heure de fonctionnement DateHeure Heure de début (UTC) des heures d’exploitation de la file d’attente si elle est actuellement en dehors des heures d’exploitation. Renvoie 01-01-0001 pendant les heures de fonctionnement.
HeureDeFinDeLaProchaineHeureDeFonctionnement DateHeure Heure (UTC) lorsque les heures d’exploitation se terminent pour la file d’attente, si elles sont actuellement en dehors des heures d’exploitation. Renvoie 01-01-0001 pendant les heures de fonctionnement.
HeureDeLaProchaineTransition DateHeure Heure (UTC) à laquelle la file d’attente est à nouveau opérationnelle si elle est en dehors des heures d’ouverture. Pendant les heures d’exploitation, s’affiche lorsque la file d’attente devient non opérationnelle.
positionInQueue Numéro Position dans la file d’attente d’un client en attente derrière d’autres personnes dans la même file d’attente.
EstAgentDisponible Boolean Écrans:
  • TRUE si les représentants du service dans la file d’attente sont actuellement disponibles pour prendre des demandes en fonction des règles de routage et d’affectation pour le flux de travail.
  • FALSE si les représentants du service ne sont pas disponibles pour prendre des demandes.
averageWaitTime Numéro Temps d’attente moyen en minutes pour les clients dans la file d’attente cible.
TempsAttenteMoyenEnSecondes Nombres Temps d’attente moyen en secondes pour les clients dans la file d’attente cible.
NombreDExpertsDisponiblesDansLaFileDAttente Nombres Nombre de représentants de service actuellement disponibles pour accepter les conversations dans la file d’attente cible.

Exemple de réponse

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

Utiliser des API de disponibilité représentatives
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on