API d'enregistrement des interactions à l'écran

Une API peut être utilisée pour lancer l’enregistrement d’écran de l’activité du bureau. Cela permet d'enregistrer les écrans des agents lorsqu'aucun contact n'est en cours et l'enregistrement des écrans de back-office.

Cette API est disponible pour les utilisateurs Multi-ACD (Open) et CXone MpowerACD.

Avant de commencer

Avant de pouvoir commencer à utiliser ces API, configurez une autorisation utilisateur, générez une clé d'accès et suivez le processus d'inscription et d'authentification expliqué sur le portail des développeurs.

Ces API nécessitent l'autorisation Enregistrer l'interaction sur l'écran d'Interactions Hub.

POST Démarrer l'enregistrement des interactions sur l'écran

L'API permet de lancer l'enregistrement d'écran pour un utilisateur spécifique qui n'est pas en appel actif. Vous devez spécifier la durée d'enregistrement en la fournissant comme paramètre dans la commande de démarrage. La durée doit être comprise entre 5 secondes et 3h30, le temps maximum autorisé. L'enregistrement s'arrêtera automatiquement lorsque la durée sera atteinte. De plus, vous pouvez arrêter l'enregistrement de l'écran en invoquant la commande stop-screen-interaction-recording.

  • Lorsque l'enregistrement est lancé (indiqué par un code de réponse de 202) ou réussi (indiqué par un code de réponse de 200), l'ID de contact associé à l'écran enregistré sera fourni. Cet ID de contact doit être utilisé lors de l'émission de la commande Stop.

  • L'API peut être utilisée lors d'un appel en direct entre un agent et un client, qui peut être enregistré. Dans de tels cas, il y aura deux enregistrements distincts - l'un capturant la conversation vocale et l'autre basé sur les interactions API - chacun associé à des identifiants de contact différents.

  • Si le masquage est appliqué à un appel en direct, il affectera également une interaction d'enregistrement d'écran API qui pourrait être enregistrée en parallèle.

  • Lors de l'utilisation de l'API, il peut y avoir une seule instance d'enregistrement d'écran. Si l’écran d’un agent est déjà enregistré via l’API, tous les appels d’API ultérieurs pour ce même agent ne généreront pas de nouvel enregistrement d’écran ni ne mettront à jour la durée de l’enregistrement.

userId* :

chaîne de caractères

ID de l'utilisateur à enregistrer.
durée d'enregistrement* :

number

Spécifie la durée d'enregistrement requise dans la plage de 5 à 13 200 secondes

Exemple POST /interaction-recording-management-service/interactions/start-screen-interaction-recording?user-id=1234567&recordingDuration=3000

Réponses

  • Statut 200 - Opération réussie.

    contactId (numéro) : l'identifiant du contact ACD

    interactionId (chaîne) : l'ID d'interaction global

  • Statut 202 – L’opération est en cours.

    contactId (numéro) : l'identifiant du contact ACD

    interactionId (chaîne) : l'ID d'interaction global

  • Statut 400-Mauvaise demande.

  • Statut 401 - L'utilisateur demandeur n'a pas pu s'authentifier.

  • Statut 403 - L'utilisateur demandeur n'est pas autorisé à effectuer l'opération.

  • Statut 404-Non trouvé. Aucune interaction active n’a été trouvée.

  • Statut 425 - L'interaction est verrouillée lors du traitement d'une demande précédente.

  • Statut 500 - Erreur interne du serveur.

  • Statut 504 - La demande a expiré.

POST Arrêter l'enregistrement de l'interaction avec l'écran

L'API permet d'arrêter l'enregistrement d'écran pour l'ID de contact d'un utilisateur spécifique qui a été démarré à l'aide de la commande start-screen-interaction-recording. Vous devez utiliser l'ID de contact fourni dans la réponse de la commande start-screen-interaction-recording. Si cette méthode n'est pas appelée, l'enregistrement de l'écran est arrêté automatiquement après la durée fournie dans la commande start-screen-interaction-recording.

userId* :

chaîne de caractères

L'ID de l'utilisateur enregistré à arrêter.
contactId* :

number

L'ID de contact renvoyé dans la commande d'enregistrement de l'écran de démarrage.

Exemple POST /interaction-recording-management-service/interactions/stop-screen-interaction-recording?user-id=1234567&contactId=1122334455

Réponses

  • Statut 200 - Opération réussie.

  • Statut 202 – L’opération est en cours.

  • Statut 400-Mauvaise demande.

  • Statut 401 - L'utilisateur demandeur n'a pas pu s'authentifier.

  • Statut 403 - L'utilisateur demandeur n'est pas autorisé à effectuer l'opération.

  • Statut 404-Non trouvé. Aucune interaction active n’a été trouvée.

  • Statut 425 - L'interaction est verrouillée lors du traitement d'une demande précédente.

  • Statut 500 - Erreur interne du serveur.

  • Statut 504 - La demande a expiré.