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.

Vous pouvez essayer les API d'extraction de données et consulter leur documentation sur le portail développeur .

Lors de l'appel de POST /jobs, 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 point de terminaison /jobs/{jobId}, qui retourne l'état du travail. 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

Vous pouvez tester les API CXone Mpower sur le portail développeur . Connectez-vous avec un compte CXone Mpower, puis vous pourrez faire des requêtes avec le tenant Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre système CXone Mpower. de votre compte.

Pour commencer à utiliser les API, vous devez vous inscrire auprès de NiCE pour recevoir des identifiants valides utilisés pour l'authentification. Consultez la page Premiers pas du portail développeur pour obtenir des instructions.

L'utilisation de ces API nécessite les autorisations suivantes :

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.
- Si vous extrayez des notes d'évaluateur QM, vous avez besoin de l'autorisation QM Tools > Data Extraction APIs > QM Évaluation Notes API.

Trouver un emploi

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é.

Méthode : GET

Point de terminaison : /data-extraction/v1/jobs

Paramètres : aucun

Préparer les emplois

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é.

Méthode : POST

Point de terminaison : /data-extraction/v1/jobs

Paramètres : aucun

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.

Trouver des offres d'emploi par identifiant

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).

Méthode : GET

Point de terminaison : /data-extraction/v1/jobs

Paramètres :

jobId*:

string

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

Exemple de valeur et de réponses

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.

QM Entité de flux de travail 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é à 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) Dans le cas des appels, vous voulez extraire la date de soumission, et non la dernière mise à jour.
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)
Raison	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) Dans le cas des appels, vous voulez extraire la date de soumission, et non la date de dernière modification.
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 maximum	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 Liste déroulante 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 : 10
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 est attribué si un contact est transféré trois 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, WhatsApp, Apple Messages for Business, (Apple Business Chat), LINE Messagerie, Telegram Messenger, Viber Messenger, Personnalisé, Microsoft Teams, Slack. Canaux sociaux publics : Facebook, Google Lieux, Google Play, LinkedIn, YouTube, Apple Avis sur les applications, 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 : Succès 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 : Succès 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 : ScreenAgent est inaccessible : ScreenAgent n'est pas configuré correctement ou n'est pas en cours d'exécution. Erreur d'enregistrement d'écran : L'appel pourrait ne pas être complètement enregistré Erreur de vidéocapture d’écran Erreur de configuration de la machine ScreenAgent Aucun lien entre ScreenAgent et les écrans de l'agent Erreur de configuration réseau de la machine ScreenAgent ScreenAgent n'a pas démarré l'enregistrement en raison de la configuration de la machine ScreenAgent n'a pas pu télécharger l'enregistrement en raison d'une configuration de certificat auto-signé Erreur de configuration du disque dur de la machine ScreenAgent ScreenAgent a atteint le nombre maximal d'appels parallèles L'enregistrement d'écran a atteint la durée maximale de l'appel Voir Résoudre les problèmes ScreenAgent. Enregistrement trop court: L'enregistrement d'écran est trop court. L'audio dure moins de 4 secondes et pourrait ne pas être enregistré. 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. É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 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
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
Source	La source de l'enregistrement - CXone Mpower ou une source externe. Les valeurs comprennent : Engage BrandEmbassy Uptivity InContactACD Multi-ACD MigratedCallsExternal MigratedCallsEngage MigratedCallsNim SmartReach Type de champ : Chaîne de 30 caractères maximum (VARCHAR) Version de l’API : 6 et plus
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. Version de l'API : 8 et supérieure
Durée de maintien en secondes	Le nombre total de secondes pendant lesquelles le client a été mis en attente lors d'un appel (la somme de toutes les mises en attente). Version de l'API : 8 et supérieure
Appel complexe	Indique si un appel avait plusieurs participants. Type de champ : valeurs booléennes composées de VRAI ou FAUX (BOOLÉEN) Version de l'API : 9 et supérieure
État de masquage de l'enregistrement vocal	Indique l'état du masquage de l'enregistrement vocal pour une interaction. Type de champ : Chaîne Version de l'API : 10 et plus Les valeurs possibles sont : Réussite : l'enregistrement vocal a été masqué avec succès Échec : Échec du masquage de l'enregistrement vocal Partiel : L'enregistrement vocal a été partiellement masqué NA : Non applicable
État de masquage de l'enregistrement d'écran	Indique l'état du masquage de l'enregistrement d'écran pour une interaction. Type de champ : Chaîne Version de l'API : 10 et plus Les valeurs possibles sont : Réussite : l'enregistrement d'écran a été masqué avec succès Échec : Échec du masquage de l'enregistrement d'écran Partiel : L'enregistrement d'écran a été partiellement masqué NA : Non applicable
ID utilisateur de l’agent	Identifiant unique attribué à l’agent. Le fichier CSV contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 User ID, Agent 2 User ID, ..., Agent 5 User ID` 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 contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 ACD ID, Agent 2 ACD ID, ..., Agent 5 ACD ID` 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. Ce champ n’est pas disponible pour Multi-ACD (Open). Le fichier CSV contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 Contact Number, Agent 2 Contact Number, ..., Agent 5 Contact Number` 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 contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 Name, Agent 2 Name, ..., Agent 5 Name` 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 contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 Team ID, Agent 2 Team ID, ..., Agent 5 Team ID` 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 contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 Team, Agent 2 Team, ..., Agent 5 Team` 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 contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Exemples de noms de colonnes : `Agent 1 Skills, Agent 2 Skills, ..., Agent 5 Skills` Type de champ : Chaîne de 50 caractères maximum (VARCHAR)
Nom des données commerciales	Nom du champ de données commerciales tel que spécifié. Le fichier CSV contient ce champ sous forme de colonne distincte pour chaque entrée de données d'entreprise : Pour les versions d'API 7 à , le fichier prend en charge jusqu'à 50 entrées : 35 de type varchar, 10 numériques et 5 booléens. Pour la version d'API 11, disponible pour les clients dans le cadre du programme Controlled Release (CR), le fichier prend en charge jusqu'à 250 entrées : 1 à 35 varchar, 36 à 45 numérique, 46 à 65 booléen, 66 à 95 date, 96 à 210 varchar, 211 à 250 numérique Exemples de noms de colonnes : `Business Data Name 1, Business Data Name 2, ..., Business Data Name 50` (ou jusqu’à `Business Data Name 250` pour CR) 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. Le fichier CSV contient ce champ sous forme de colonne distincte pour chaque entrée de données d'entreprise : Pour les versions d'API 7 à , le fichier prend en charge jusqu'à 50 entrées : 35 de type varchar, 10 numériques et 5 booléens. Pour la version d'API 11, disponible pour les clients dans le cadre du programme Controlled Release (CR), le fichier prend en charge jusqu'à 250 entrées : 1 à 35 varchar, 36 à 45 numérique, 46 à 65 booléen, 66 à 95 date, 96 à 210 varchar, 211 à 250 numérique Exemples de noms de colonnes : `Business Data Value 1, Business Data Value 2, ..., Business Data Value 50` (ou jusqu’à `Business Data Value 250` pour CR) Type de champ : Chaîne de 4 000 caractères maximum (VARCHAR) Valeur numérique contenant jusqu'à 38 chiffres (NUMÉRO) Valeurs booléennes composées de VRAI ou FAUX (BOOLÉEN) Valeurs de date au format pris en charge (DATE) Version de l’API : 7 et plus Les mises à jour des données commerciales effectuées plus de 2 jours après la création de l'interaction ne sont pas incluses dans la sortie de l'API d'extraction de données.

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)