API d’extraction de données

Les API d’extraction de données vous permettent d’extraire des données de CXone Mpower à des fins de rapports externes. Par exemple, vous pouvez extraire des données de flux de travail QM, des données de questions et réponses QM, des métadonnées d’interaction Recording ou des données de paie WFM. Les données ne peuvent être filtrées qu’en fonction de la plage de dates spécifiée.

Les API d'extraction de données sont disponibles dans le portail de la communauté des développeurs.

Pour plus d'informations sur les domaines et les URL, consultez la section Mise en route du portail de la communauté des développeurs.

Lors de l’appel du nœud final (endpoint) /jobs avec la méthode POST, un jobId est retourné pendant la préparation des données. Vous pouvez vérifier si les données sont prêtes en interrogeant le service à partir du terminal /jobs/{jobId}, l’état de la tâche est renvoyé. Si le statut est Réussi, une URL supplémentaire est également renvoyée. L’URL sera accessible pendant 30 secondes (sans compter le temps de téléchargement du fichier).

Vous pouvez écrire des scripts pour appeler l’API périodiquement au lieu de récupérer manuellement les données à chaque fois. À tout moment, un seul utilisateur par locataire peut appeler une API. Vous ne pouvez appeler l’API qu’une seule fois au cours d’une période de 30 secondes.

Avant de commencer

Avant de commencer à utiliser l’API Données commerciales, vous devez configurer les autorisations des utilisateurs, générer une clé d’accès et suivre le processus d’enregistrement et d’authentification expliqué sur le portail des développeurs. Autorisations requises :

Entité :
- Si vous extrayez des métadonnées d’interaction, vous avez besoin de l’autorisation Recherche et lecture > API > Extraire les métadonnées d’interaction.
- Si vous extrayez des données de flux de travail QM, alors vous avez besoin de l’autorisation Outils QM > API d’extraction de données > API QM Workflow (Flux de travail).
- Si vous extrayez des données de questions-réponses QM, vous avez besoin de l’autorisation Outils QM > API d’extraction de données > API de flux de travail QM.
- Si vous extrayez des Données de paie WFM, vous avez besoin de l’autorisation WFM > API d’extraction de données > API de paie WFM.

GET Travaux

Afficher une liste de tous les statuts de travail par locataire. Les états possibles sont En cours d’exécution, Réussi, Échoué, Annulé et Expiré.

POST (Publier) Travaux

Après une demande d’extraction de données, les données sont collectées et préparées pour l’extraction. Les données sont disponibles dans S3 sous forme de fichier CSV pendant 24 heures. Une fois terminé, un ID de travail est renvoyé.

Exemple de valeur et de réponses

Corps de demande* :	application/json
exportRequest { description:	Paramètres à fournir pour extraire les données.
entityName	string Nom de l’entité à extraire. Pour les noms d’entités corrects, voir ci-dessous.
version	string Version de l’entité à extraire. Pour les versions correctes pour chaque entité, voir ci-dessous.
startDate	string($date) Date, en UTC, à partir de laquelle commencer l’extraction des données. Le format de la date est <YYYY-MM-DD>. Par exemple, pour extraire les données du 22 mai 2019, entrez la date : 2019-05-22.
endDate	string($date) Date, en UTC, à partir de laquelle arrêter l’extraction des données. Le format de la date est <YYYY-MM-DD>. Par exemple, pour extraire les données jusqu’au 29 mai 2019, entrez la date : 2019-05-29.
}

Exemple de valeur

{ "entityName": "qm-workflows", "version": "3", "startDate": "2019-05-22", "endDate": "2019-05-29" }

Réponses

Statut 202 - Succès. Travail asynchrone exporté avec succès.

string

Exemple : 12345d5h-c099-9303-j99j-w3ko9ppp1234
Statut 400 - Demande non valide. Filtres de date incorrects, etc.
Statut 401 - Non autorisé. Les informations d’identification invalides.
Statut 403 - Interdit. L’utilisateur n’est pas autorisé à afficher l’état du travail.
Statut 404 - Introuvable. Entité manquante ou version non valide.
État 500 - Erreur de serveur interne.

GET (obtenir) Emplois par ID de travail

Affichez l’état d’un travail spécifique en fonction de son ID de travail. Si un travail a réussi, une URL pour accéder aux données extraites est renvoyée et est accessible pendant 30 secondes (sans compter le temps de téléchargement du fichier). Si le travail a échoué, un message d’erreur est renvoyé. Le lien peut être utilisé pour accéder aux données extraites. Les statuts de tâche possibles sont En cours d’exécution(Running), Réussi (Succeeded), Échoué (Failed), Annulé (Cancelled) et Expiré (Expired).

Exemple de valeur et de réponses

jobId*:

string

Identificateur unique de la demande d’extraction des données client.

Exemple de valeur

 12345d5h-r3ds-9303-0pw3-w3ko9ppp1234

Réponses

Statut 202 - Succès. Statut du travail récupéré.

 jobResponse{ description: Displays the job status jobStatus: { description: Job Status, includes job ID and job status id:	string Unique identifier of the job. status: string example: SUCCEEDED Job status that can be returned. Enum: [ RUNNING, SUCCEEDED, FAILED, CANCELLED, EXPIRED ] result: { description:	Job result. If successful, contains the url, if failed, an error message is displayed. url: string example: https://s3.example.amazonaws.com/results-bucket/data-extraction/{details} A url to access the extracted data is returned when a job for extracting data is successful. errorMessage: string Error message displayed when a request for extracting data fails. } } }

Statut 400 - Demande non valide. Filtres de date incorrects, etc.
Statut 401 - Non autorisé. Les informations d’identification invalides.
Statut 403 - Interdit. L’utilisateur n’est pas autorisé à afficher l’état du travail.
Statut 404 - Introuvable. Entité manquante ou version non valide.
État 500 - Erreur de serveur interne.

Entité de flux de travail QM et fichier CSV

L’API de flux de travail QM vous permet d’extraire des données de flux de travail QM, y compris des évaluations, des auto-évaluations et des calibrages.

Pour le travail POST :

entityName est: qm-workflows
La version est: 4

Les données sont filtrées en fonction de la Date de soumission (en UTC).

Champs du fichier CSV de flux de travail QM

Nom de colonne	Description
Nom du locataire	Nom du locataire.
ID de l’agent	Identifiant unique de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Type	Type d’évaluation, par exemple : Évaluation Auto-évaluation Type de champ : Chaîne de 24 caractères maximum (VARCHAR)
Déclencheur du flux d’évaluation	Événement qui a commencé l’évaluation : Calibrage Collaboratif Manuel QP Type de champ : Chaîne de 24 caractères maximum (VARCHAR)
État du flux de travail	Statut du travail : Envoyé à l’agent En révision Contestation Terminé Confirmé Auto-évaluation terminée Terminé avec révision Terminé sans révision Terminé Supprimé Supprimé - Terminé Expiré Supprimé - Expiré Supprimé - Complété reconnu Supprimé - Terminé Révisé Supprimé - Terminé Pas d’examen Type de champ : Chaîne de 128 caractères maximum (VARCHAR)
Accusé de réception automatique	Les valeurs possibles sont : VRAI : Si l’agent n’a pas accusé réception de l’évaluation, celle-ci a été automatiquement acquittée. FAUX : Si l’agent a accusé réception de l’évaluation. Valeur vide : En cas d’auto-évaluation, aucun accusé de réception n’est nécessaire. Type de champ : BOOLÉEN
État du flux de travail	État du flux de travail : Ouvert Fermé Expiré Type de champ : Chaîne de 128 caractères maximum (VARCHAR)
ID du flux de travail	L’identifiant unique de l’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR) Version de l’API : 3 et plus
Nom du plan	Le nom du plan qualité utilisé pour lancer cette évaluation. Type de champ : Chaîne de 128 caractères maximum (VARCHAR)
Nom du formulaire	Le nom du formulaire utilisé pour cette évaluation. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Version du formulaire	La version du formulaire d’évaluation utilisée pour cette évaluation. Type de champ : Nombre (4,0)
Date de début	Date et heure (en UTC) du début de cette évaluation. Type de champ : TIMESTAMP_LTZ(3)
Date de soumission	Date et heure (en UTC) auxquelles cette évaluation a été soumise. Type de champ : TIMESTAMP_LTZ(3)
Dernière mise à jour	Estampille temporelle (en UTC) de la dernière modification de cette évaluation. Type de champ : TIMESTAMP_LTZ(3)
Note - Pourcentage	Score d’évaluation en pourcentage. Type de champ : FLOTTANT
Score	Score d’évaluation. Type de champ : FLOTTANT
Score maximum possible	Le score le plus élevé possible pour chaque question du formulaire d’évaluation. Type de champ : FLOTTANT
Rang	Plage de valeurs personnalisée définie par l’utilisateur pour définir le classement du formulaire. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Échec de la question critique	Si la valeur est true (vrai), l’utilisateur a échoué à une question critique et le score du formulaire d’évaluation est défini sur zéro. Si la valeur est false (faux), l’utilisateur a répondu correctement à la question. Type de champ : BOOLÉEN
Commentaires des utilisateurs	Les commentaires saisis par l’utilisateur (agent) lors de la contestation de l’évaluation. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Commentaires du résolveur de différends	Les commentaires saisis par l’utilisateur (gestionnaire / évaluateur) lors de la clôture du litige. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
ID de segment	ID de segment de l’interaction en cours d’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
ID de l’ACD	Identifiant unique du distributeur automatique d’appels. Type de champ : Nombre (38,0)
Type d’interaction	Type d’interaction : PHONE_CALL COURRIEL CLAVARDAGE SMS WORKITEM GOOGLE_BUSINESS_MESSAGES_PRIVATE APPLE_BUSINESS_CHAT_PRIVATE TELEGRAM_PRIVATE LINE_PRIVATE WHATSAPP_PRIVATE SLACK_PRIVATE MICROSOFT_TEAMS_PRIVATE TW_PRIVATE VIBER_PRIVATE CUSTOM_PRIVATE WE_CHAT_PRIVATE FB_PRIVATE Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Date de début de l’interaction	Date-heure de début (en UTC) de l’interaction. Type de champ : TIMESTAMP_LTZ(6)
Date de fin de l’interaction	Date-heure de fin (en UTC) de l’interaction. Type de champ : TIMESTAMP_LTZ(6)
Direction d’interaction	Direction d’appel : Entrant Sortant Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
ID de l’équipe	L’identifiant unique de l’équipe de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom de l’équipe	Le nom de l’équipe de l’agent. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Numéro de téléphone	Numéro de téléphone du client. Type de champ : Chaîne de 200 caractères maximum (VARCHAR)
FirstName (Eva)	Prénom de l’évaluateur. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Eva)	Nom de famille de l’évaluateur. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
FirstName (Agent)	Prénom de l’agent évalué. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Agent)	Nom de famille de l’agent évalué. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
FirstName (Disp)	Prénom du résolveur de litige. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Disp)	Nom de famille du résolveur de litige. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
FirstName (Assigner)	Prénom de l’utilisateur qui a attribué l’évaluation. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Assigner)	Nom de famille de l’utilisateur qui a attribué l’évaluation. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Motif	Raison de la suppression de l’évaluation. Type de champ : Chaîne de 128 caractères maximum (VARCHAR) Version de l’API : 4 et plus
ID Parent	ID de flux de travail parent de l’évaluation, tel que collaboratif et calibrage. Type de champ : Chaîne de 36 caractères maximum (VARCHAR) Version de l’API : 4 et plus
Objet d’évaluation	Les valeurs possibles sont : Employé Segment Type de champ : Chaîne de 128 caractères maximum (VARCHAR) Version de l’API : 4 et plus

Entité Questions et réponses (Q&A) QM et fichier CSV

L’API Q&A QM vous permet d’extraire les questions et les réponses des évaluations, des auto-évaluations et des calibrages QM.

Pour le travail POST :

entityName est : qm-questions
la version est : 2

Les données sont filtrées en fonction de la Date de soumission (en UTC).

Champs du fichier CSV Q&A QM

Nom de colonne	Description
ID de question	Identifiant unique de la question. Type de champ : NOMBRE (38,0)
Titre de question	Le texte de la question. Type de champ : Chaîne de 2048 caractères maximum (VARCHAR)
Numéro de question	Le numéro de la question dans le formulaire d’évaluation. Type de champ : Chaîne de 15 caractères maximum (VARCHAR)
Réponse	La réponse de l’évaluateur à la question. Type de champ : Chaîne de 10000 caractères maximum (VARCHAR)
Options	Les options de réponse disponibles pour la question, telles que oui / non, les options numériques, les options de bouton radio, etc. Type de champ : TABLEAU
ID du formulaire	Identifiant unique du formulaire d’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom du formulaire	Le nom du formulaire utilisé pour cette évaluation. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Version du formulaire	La version du formulaire d’évaluation utilisée pour cette évaluation. Type de champ : NOMBRE (4,0)
Date de début de l’évaluation	Date et heure (en UTC) du début de cette évaluation. Type de champ : TIMESTAMP_LTZ(3)
Date de soumission de l’évaluation	Date et heure (en UTC) auxquelles cette évaluation a été soumise. Type de champ : TIMESTAMP_LTZ(3)
Type de flux de travail	Type d’évaluation, par exemple: Évaluation Auto-évaluation Type de champ : Chaîne de 24 caractères maximum (VARCHAR)
ID de section	Identifiant unique de la section dans le formulaire d’évaluation. Type de champ : NOMBRE (38,0)
Section titre	Le nom de la section dans le formulaire d’évaluation. Type de champ : Chaîne de 2048 caractères maximum (VARCHAR)
Coté	Indicateur vrai ou faux pour savoir si la question peut être notée. Type de champ : BOOLÉEN
Score actuel	Le score que l’agent a reçu sur la question. Type de champ : FLOTTANT
Score de la section (%)	Le score en pourcentage de la section où se trouvait la question. Type de champ : FLOTTANT
Score max	Le score maximum qu’un agent aurait pu obtenir sur la question. Type de champ : FLOTTANT
ID de l’agent	Identifiant unique de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
FirstName (Agent)	Prénom de l’agent évalué. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Agent)	Nom de famille de l’agent évalué. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
ID de l’équipe	L’identifiant unique de l’équipe de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom de l’équipe	Le nom de l’équipe de l’agent. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
FirstName (Eva)	Prénom de l’évaluateur. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Eva)	Nom de famille de l’évaluateur. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Critique	Indicateur vrai ou faux pour si la question était une question critique. Type de champ : BOOLÉEN
Échec de la question critique	Si la valeur est true (vrai), l’utilisateur a échoué à une question critique et le score du formulaire d’évaluation est défini sur zéro. Si la valeur est false (faux), l’utilisateur a répondu correctement à la question. Type de champ : BOOLÉEN
Obligatoire	Indicateur vrai ou faux pour si la question était obligatoire. Type de champ : BOOLÉEN
Type de question	Le type de question : Radio Oui/Non Case à cocher Dropdown Date/Heure Type de champ : Chaîne de 64 caractères maximum (VARCHAR)
ID de segment	ID de segment de l’interaction en cours d’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Date de début de l’interaction	Date-heure de début (en UTC) de l’interaction. Type de champ : TIMESTAMP_LTZ(6)
Date de fin de l’interaction	Date-heure de fin (en UTC) de l’interaction. Type de champ : TIMESTAMP_LTZ(6)
ID de WorkflowInstance	L’identifiant unique de l’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Score d’évaluation (%)	Le pourcentage de score de l’évaluation. Type de champ : FLOTTANT
ID de la banque	Identifiant unique de la banque de questions où se trouve la question. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom caché	L’indicateur Vrai masque les questions et l’indicateur Faux les montre. Lorsque vous utilisez la règle Formulaire QM dans un formulaire de qualité, elle masque une question de suivi en fonction du score d’une question précédente. Type de champ : BOOLÉEN Version de l’API : 2 et plus

Notes de l’évaluateur QM et fichier CSV

L’API Notes de l’évaluateur QM vous permet d’extraire des notes d’évaluateurs QM.

Pour le travail POST :

entityName est : qm-evaluation-comment-entity
version est : 1

Les données sont filtrées en fonction de la Date de soumission (en UTC).

Champs dans le fichier CSV des notes de l’évaluateur QM

Nom de colonne	Description
ID du commentaire	L’identifiant unique du commentaire. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Commentaires	Le texte du commentaire. Type de champ : Chaîne de 300 caractères maximum (VARCHAR)
Date et heure du commentaire	Date et heure auxquelles le commentaire a été ajouté. Type de champ : TIMESTAMP_LTZ(3)
Activité	Nom de l’action d’évaluation lors de l’ajout du commentaire. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
ID de l’auteur du commentaire	L’identifiant unique de l’utilisateur qui a ajouté le commentaire. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Prénom de l’auteur du commentaire	Prénom de l’utilisateur qui a ajouté le commentaire. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Nom de l’auteur du commentaire	Nom de famille de l’utilisateur qui a ajouté le commentaire. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
ID de question	L’identifiant unique de la question. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Titre de question	Le texte de la question. Type de champ : Chaîne de 2048 caractères maximum (VARCHAR)
ID du formulaire	L’identifiant unique du formulaire d’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom du formulaire	Le nom du formulaire utilisé pour l’évaluation. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Version du formulaire	La version du formulaire d’évaluation utilisée pour l’évaluation. Type de champ : NOMBRE (4,0)
ID du flux de travail	L’identifiant unique de l’évaluation. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
État du flux de travail	L’état du flux de travail. Type de champ : Chaîne de 128 caractères maximum (VARCHAR)
ID de l’agent	L’identifiant unique de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
FirstName (Agent)	Prénom de l’agent. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
LastName (Agent)	Nom de famille de l’agent. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
ID de l’équipe	L’identifiant unique de l’équipe de l’agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
Nom de l’équipe	Le nom de l’équipe de l’agent. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)

Entité de métadonnées d’interaction et fichier CSV

L’API de métadonnées d’interaction vous permet d’extraire des métadonnées d’interaction Recording.

Pour le travail POST :

entityName est: recording-interaction-metadata
version est : 7
Pour filtrer les données par date et heure, utilisez startDate et endDate en UTC avec le format : aaaa-mm-jj hh:mm:ss.

Champs du fichier CSV de métadonnées d’interaction

Nom de colonne	Description
ID d’appel ACD (par exemple, ID de contact principal)	L’ID d’appel ACD dépend de la solution ACD, par exemple, c’est le même que CXone MpowerID de contact principal ID principal ou parent d’un ou de plusieurs contacts associés. Un nouvel ID de contact principal sera attribué si un contact a été transféré 3 fois ou plus.. Type de champ : Numéro contenant jusqu’à 38 chiffres
ID de segment	Identifiant unique du segment. Un segment est une interaction avec deux utilisateurs, comme un client et un agent. Type de champ : Chaîne de 36 caractères maximum (VARCHAR UUID)
Raison du début du segment	Raison pour laquelle le segment a commencé : Conférence IVR Segment : Premier segment du contact Transférer Contact Élevé Transféré vers un numéro externe Transfert externe Type de champ : Chaîne de 100 caractères maximum (VARCHAR)
Raison de fin de segment	Raison pour laquelle le segment s’est terminé : Conférence IVR Segment : Dernier segment du contact Transférer Contact Élevé Transféré vers un numéro externe Transfert externe Type de champ : Chaîne de 100 caractères maximum (VARCHAR)
Direction	Direction du segment : Entrant Sortant Interne Inconnu Type de champ : Chaîne de 150 caractères maximum (VARCHAR)
Date de début	Date et heure de début (en UTC) du segment. Type de champ : HORODATAGE
Date de fin	Date et heure de fin (en UTC) du segment. Type de champ : HORODATAGE
Type de canal	Type d’interaction : Voix Clavardage Courriel IVR Élément de travail SMS Canaux de messagerie : Facebook Messenger, messages directs Twitter, WhatsApp, Apple Messages for Business (Apple Business Chat), LINE Messaging, Telegram Messenger, Viber Messenger, Custom, Google Business Messenger, Microsoft Teams, Slack. Canaux sociaux publics : Facebook, Google Places, Google Play, LinkedIn, Twitter, YouTube, Apple Apps Reviews, Personnalisé (public). Type de champ : Chaîne de 150 caractères maximum (VARCHAR)
Vidéocapture d’écran	Si le segment comprend a vidéocapture d’écran : Oui Non
État de l’enregistrement vocal	Statut de l’enregistrement : Réussite Partiellement enregistré : des parties de ce segment n’ont pas été enregistrées, mais l’interaction peut toujours être lue Ne correspond à aucune politique : aucun enregistrement : aucune des politiques d'enregistrement n'a été déclenchée par cette interaction Non enregistré en raison du pourcentage d'enregistrement : aucun enregistrement : une politique d'enregistrement a été déclenchée par cette interaction, mais n'a pas été enregistrée en raison du pourcentage d'enregistrement défini dans la politique Politique de non-enregistrement : aucun enregistrement : une politique de non-enregistrement a été déclenchée pour cette interaction Consentement refusé dans IVR : aucun enregistrement Échec : aucun enregistrement Masqué : Aucun enregistrement – l'enregistrement a été masqué Transfert d’enregistrements vers les numéros externes non sélectionné : aucun enregistrement Peut être enregistré (voix) non sélectionné : aucun enregistrement - l'attribut Agent Peut être enregistré (voix) n'a pas été sélectionné Type de champ : Chaîne de 250 caractères maximum (VARCHAR)
Statut de vidéocapture d’écran	Statut de l’enregistrement : Réussite Partiellement enregistré : des parties de ce segment n’ont pas été enregistrées, mais l’interaction peut toujours être lue Ne correspond à aucune politique : aucun enregistrement : aucune des politiques d'enregistrement n'a été déclenchée par cette interaction Non enregistré en raison du pourcentage d'enregistrement : aucun enregistrement : une politique d'enregistrement a été déclenchée par cette interaction, mais n'a pas été enregistrée en raison du pourcentage d'enregistrement défini dans la politique Politique de non-enregistrement : aucun enregistrement : une politique de non-enregistrement a été déclenchée pour cette interaction Consentement refusé dans IVR : aucun enregistrement Échec : aucun enregistrement Masqué : Aucun enregistrement – l'enregistrement a été masqué Type de champ : Chaîne de 250 caractères maximum (VARCHAR)
Alertes d’enregistrement	Les alertes d’enregistrement incluent : Erreur ScreenAgent : ScreenAgent est inaccessible : le ScreenAgent n'a pas pu être atteint car il est en panne ou n'est pas installé. Voir Résoudre les problèmes ScreenAgent. Erreur d'enregistrement d'écran : N/A : Le client ScreenAgent ou FFMPEG s'est écrasé pour une raison inconnue, l'appel est donc marqué comme une erreur. Succès partiel lors du téléchargement des fichiers : tous les fichiers enregistrés n'ont pas atteint le cloud en raison d'un problème de réseau ou d'une panne.ScreenAgent Par conséquent, seule une partie de l'enregistrement de l'écran est disponible. La dernière mise à jour de l'agent remonte à trop longtemps : une déconnexion de communication s'est produite avec le client ScreenAgent pendant l'enregistrement de l'écran, ce qui a entraîné l'arrêt du signalement de l'état de l'enregistrement. Par conséquent, cet appel est marqué comme partiel. L'enregistrement est trop court : l'enregistrement de l'écran dure moins de 4 secondes. L'enregistrement n'a pas démarré : FFmpeg ne parvient pas à démarrer l'enregistrement de l'écran ou a démarré avec retard. Aucune connexion au serveur multimédia : un problème est survenu avec le serveur multimédia, ce qui a entraîné l'absence d'enregistrement disponible. Cette erreur peut se produire pour diverses raisons, et la description de l'erreur pour l'alerte d'enregistrement fournit des informations plus détaillées. Pour la solution Multi-ACD (Open), cette erreur indique des événements SIP manquants du client. Cela peut signifier que l'invitation entière est manquante ou qu'un seul côté (Nearend ou Farend) est reçu. L’enregistreur vocal n’a pas pu enregistrer l’appel : Pas d’enregistrement. Il y a eu un problème avec l’enregistreur vocal. Les raisons peuvent être multiples. La description de l’erreur pour l’alerte d’enregistrement fournit des informations plus détaillées. Audio non disponible : données audio incomplètes : L’audio n’est pas disponible pour cette interaction (données audio incomplètes). Contactez le support CXone Mpower. Audio non disponible : paquets audio manquants : L’audio n’est pas disponible pour cette interaction (paquets audio manquants). Contactez le support CXone Mpower. Audio non disponible : paquets audio manquants de la source externe : (fonctionnalité en version contrôlée) L’audio n’est pas disponible pour cette interaction (paquets audio manquants dans le flux média). Contactez le support CXone Mpower. Erreur système : L’enregistrement n’a pas démarré ou autre erreur générale. Contactez le support CXone Mpower. Appel trop court : L’appel dure moins de 4 secondes et ne peut donc pas être enregistré. Échec du masquage : Échec du masquage de l’enregistrement. Vous pouvez lire l’enregistrement pour vérifier s’il existe des données sensibles. Pour supprimer l’enregistrement, cliquez sur Action et sélectionnez Supprimer les enregistrements. Enregistrement arrêté à la demande : Enregistrement arrêté par l’utilisateur.
Nom de la politique	Nom de la stratégie d’enregistrement ou ne pas enregistrer la stratégie qui a été appliquée à cette interaction. Type de champ : Chaîne de 100 caractères maximum (VARCHAR)
EAN	Pour les appels entrants, EAN (ANI) est le numéro de téléphone de l’appelant (identification de l’appelant). Type de champ : Chaîne de 200 caractères maximum (VARCHAR)
DNIS	Pour les appels entrants, DNIS est le numéro de téléphone qui a été appelé (numéro composé). Type de champ : Chaîne de 200 caractères maximum (VARCHAR)
ACW (en secondes)	Combien de secondes de vidéocapture d’écran s’est poursuivi après la fin de l’appel pour capturer le traitement de l’agent après l’appel.
Disposition	L’étiquette que l’agent attribue avec des informations supplémentaires sur l’appel.
ID utilisateur de l’agent	Identifiant unique attribué à l’agent. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : ID d’utilisateur Agent1, ID d’utilisateur Agent2, ID d’utilisateur Agent3, ID d’utilisateur Agent4 et ID d’utilisateur Agent5. Type de champ : Chaîne de 36 caractères maximum (VARCHAR)
ID ACD de l’agent	Identifiant unique attribué à l’agent par l’ACD. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : ID ACD Agent1, ID ACD Agent2, ID ACD Agent3, ID ACD Agent4 et ID ACD Agent5. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Numéro de contact de l’agent	Identifiant unique du contact créé pour cet agent. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : Numéro de contact Agent1, Numéro de contact Agent2, Numéro de contact Agent3, Numéro de contact Agent4 et Numéro de contact Agent5. Ce champ n’est pas disponible pour Multi-ACD (Open). Type de champ : Numéro contenant jusqu’à 38 chiffres Version de l’API : 5 et plus
Nom de l’agent	Nom de l’agent tel que spécifié dans le compte employé CXone Mpower. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : Nom Agent1, Nom Agent2, Nom Agent3, Nom Agent4 et Nom Agent5. Type de champ : Chaîne de 100 caractères maximum (VARCHAR)
ID de l’équipe d’agent	Identifiant unique attribué à l’équipe de l’agent. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : ID de l’équipe Agent1, ID de l’équipe Agent2, ID de l’équipe Agent3, ID de l’équipe de Agent4 et ID de l’équipe Agent5. Type de champ : Chaîne de 36 caractères maximum (VARCHAR UUID)
Équipe d’agents	Le nom de l’équipe de l’agent. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : Équipe Agent1, Équipe Agent2, Équipe Agent3, Équipe Agent4 et Équipe Agent5. Type de champ : Chaîne de 40 caractères maximum (VARCHAR)
Compétences de l’agent	Classification attribuée à l’agent dans l’ACD, basée sur ses capacités, ses spécialités et ses connaissances. Le fichier CSV peut contenir des informations relatives à l’agent pour un maximum de 5 agents. Par exemple : Compétence Agent1, Compétence Agent2, Compétence Agent3, Compétence Agent4 et Compétence Agent5. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Liste des numéros de contact associés	Liste des numéros de contact des agents associés au segment. Les éléments de cette liste sont uniquement de type numérique. Type de champ : Variante Version de l’API : 7 et plus
ID d’interaction	Un identifiant unique (UUID) pour une interaction. Lorsque plusieurs segments sont associés à une même interaction, les segments peuvent avoir le même ID d’interaction. L’ID d’interaction n’est pas le même que l’ID de segment ou l’ID de contact. Type de champ : Chaîne de 36 caractères maximum (VARCHAR) Version de l’API : 7 et plus
Compte de suspensions	Le nombre total de fois où l'agent a mis le client en attente pendant un appel.
Durée de maintien en secondes	Le nombre total de secondes pendant lesquelles le client a été mis en attente pendant un appel (la somme de toutes les mises en attente).
Nom des données commerciales	Nom du champ de données commerciales tel que spécifié. Type de champ : Chaîne de 128 caractères maximum (VARCHAR) Version de l’API : 7 et plus
Valeur des données commerciales	La valeur des données commerciales peut être un texte, un nombre ou vrai/faux. Les données commerciales peuvent comprendre jusqu'à 50 champs : 35 varchar, 10 numériques et 5 booléens. Type de champ : Chaîne de 4 000 caractères maximum (VARCHAR) Valeur numérique contenant jusqu’à 38 chiffres (CHIFFRE) Valeurs booléennes composées de VRAI ou FAUX (BOOLÉEN) Version de l’API : 7 et plus
Source	La source de l'enregistrement - CXone Mpower ou une source externe. Les valeurs comprennent : Engage BrandEmbassy Uptivity InContactACD Multi-ACD MigratedCallsExternal MigratedCallsEngage MigratedCallsNim Type de champ : Chaîne de 30 caractères maximum (VARCHAR) Version de l’API : 6 et plus
ID de contact externe	L’ID d’un contact tel que défini dans la source externe de l’enregistrement. Les valeurs ne sont disponibles que pour les utilisateurs avec AppLink. Type de champ : Chaîne de 100 caractères maximum (VARCHAR) Version de l’API : 6 et plus
ID de segment externe	L’ID d’un segment tel que défini dans la source externe de l’enregistrement. Les valeurs ne sont disponibles que pour les utilisateurs avec AppLink. Type de champ : Chaîne de 100 caractères maximum (VARCHAR) Version de l’API : 6 et plus

Entité de paie WFM et fichier CSV

L’API de paie WFM (version 1) vous permet d’extraire des données d’activité WFM à des fins de rapports de paie externe.

Le nom de l’entité Payroll (paie) WFM pour le travail POST est : wfm-payroll.

Les données sont filtrées selon la date du code de paie. Gardez à l’esprit que le fuseau horaire de la date et de l’heure correspond au fuseau horaire de l’unité de planification.

Champs du fichier CSV de la paie WFM

Nom de colonne	Description
Prénom	Prénom de l’agent. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Nom	Nom de famille de l’agent. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Nom d’utilisateur	Nom d’utilisateur de l’agent. Type de champ : Chaîne de 255 caractères maximum (VARCHAR)
Unité de planification	Unité de planification de l’agent. Type de champ : Chaîne de 256 caractères maximum (VARCHAR)
Fuseau horaire de l’unité de planification	Fuseau horaire de l’unité de planification de l’agent. Type de champ : Chaîne de 128 caractères maximum (VARCHAR)
Code de paie	Code de paie contenant les données d’activité programmée. Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Date	Date (dans le fuseau horaire de l’unité de planification) de l’activité. Type de champ : DATE
Heure de début	Heure de début (dans le fuseau horaire de l’unité de planification) de l’activité. Type de champ : TEMPS (9)
Durée en secondes	La durée de l’activité en secondes. Type de champ : NOMBRE (8,0)