Les API d'extraction de données vous permettent d'extraire des données depuis NiCE CXone à des fins de reporting externe. 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 Management (CXone) ou des données de Paie WFM. Les données ne peuvent être filtrées que selon la période spécifiée. Les données de Gestion de la qualité sont transmises à l'API d'extraction de données toutes les 15 minutes.
Vous pouvez tester les API d'extraction de données et revoir leur documentation dans le portail développeur
.
Lors de l'appel de POST /jobs, un jobId est retourné pendant que les données sont en cours de préparation. Vous pouvez vérifier si les données sont prêtes en interrogeant le service à partir du terminal /jobs/{jobId}, qui renvoie l'état du job. Si le statut est réussite, une URL supplémentaire est également renvoyée. L'URL sera accessible pendant 30 secondes (sans compter le temps nécessaire pour télécharger le fichier).
Vous pouvez écrire des scripts pour appeler l'API périodiquement au lieu de récupérer les données manuellement à chaque fois. À tout moment, un seul utilisateur par locataire peut appeler une API. Vous ne pouvez appeler l'API qu'une fois toutes les 30 secondes.
Avant de Démarrer
Vous pouvez tester les API NiCE CXone sur le portail développeur . Connectez-vous avec un compte NiCE CXone, puis vous pourrez effectuer des demandes avec le locataire
Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone. de votre compte.
Pour commencer à utiliser les API, vous devez vous enregistrer auprès de NiCE pour recevoir des identifiants valides utilisés pour l'authentification. Consultez la page Prise en main sur le portail des développeurs 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 > Extract Interaction Metadata.
-
Si vous extrayez des QM données de flux de travail, vous devez alors disposer de l'autorisation QM Outils > API d'extraction de données > API de flux de travail QM.
-
Si vous extrayez des QM données de Q&A, vous devez alors disposer de l'autorisation QM Outils > API d'extraction de données > QM Workflow API.
-
Si vous extrayez des WFM données de Paie, vous devez disposer de l'autorisation WFM > API d'extraction de données > WFM API Paie.
-
Si vous extrayez des QM notes de l'évaluateur, vous avez alors besoin de l'autorisation QM Outils > API d'extraction de données > API de notes de l'Évaluateur QM.
-
Obtenir les Travaux
Afficher une liste de tous les statuts de travail par locataire. Les statuts possibles sont le Fonctionnement, Réussi,Manqué, annulé etExpiré.
Méthode : GET
Terminal : /data-extraction/v1/jobs
Paramètres : rien
Exemple de valeur et de réponses
Exemple de valeur à évaluer
"jobs": [
{
"id": "9dd92a83-1234-8549-8df4-939485722942",
"status": "RUNNING"
},
{
"id": "12345d5h-c099-2345-k3r3-w3ko9ppp1234",
"status": "FAILED"
}
]
}
Réponses
-
Statut 200 - Réussite. Statut récupéré pour toutes les tâches.
-
Statut 401 - Non autorisé. Informations d’identification non valides.
-
Statut 403 - Interdit. L'utilisateur ne dispose pas de l'autorisation nécessaire pour afficher l'état du poste.
-
Statut 500 - Erreur de serveur Interne.
Préparer les travaux
Une fois qu'une demande d'extraction de données est effectuée, 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 l'opération terminée, un id de tâche est renvoyé.
Méthode : POST
Terminal : /data-extraction/v1/jobs
Paramètres : rien
Exemple de valeur et de réponses
| Corps de la demande* : | application / json |
|
exportRequest {
|
Paramètres à fournir pour extraire les données. |
| entityName |
chaîne de caractères Nom de l'entité à extraire. Pour les noms d'entités corrects, voir ci-dessous. |
| version |
chaîne de caractères Version de l'entité à extraire. Pour les versions correctes pour chaque entité, voir ci-dessous. |
| startDate |
chaîne de caractères($ date) Date, au format UTC, à partir de laquelle commencer l'extraction des données. Le format de date est <YYYY-MM-DD>. Par exemple, pour extraire les données du 22 mai 2019, entrez la date: 2019-05-22. |
| Date DE fin |
string($date) Date, au format UTC, à partir de laquelle arrêter l'extraction des données. Le format de 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 - Réussite. Tâche asynchrone exportée avec succès.
chaîne de caractères
Exemple: 12345d5h-c099-9303-j99j-w3ko9ppp1234
-
État 400 - Demande non valide. filtres de date incorrects, etc.
-
Statut 401 - Non autorisé. Informations d’identification non valides.
-
Statut 403 - Interdit. L'utilisateur ne dispose pas de l'autorisation nécessaire pour afficher l'état du job.
-
État 404 - Introuvable. entité manquante ou version non valide.
-
Statut 500 - Erreur de serveur Interne.
Obtenir les travaux par Id de tâche
Affichez le statut d'une tâche spécifique selon son id de tâche. 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 nécessaire pour télécharger le 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 travail possibles sontFonctionnement,Réussi,Manqué ,annulé , etExpiré.
Méthode : GET
Terminal : /data-extraction/v1/jobs
Paramètres :
| jobId*: |
chaîne de caractères Identifiant unique de la demande effectuée pour extraire les données clients. |
Exemple de valeur et de réponses
Exemple de valeur
12345d5h-r3ds-9303-0pw3-w3ko9ppp1234
Réponses
-
Statut 202 - Réussite. Statut de la tâche 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. } } } -
État 400 - Demande non valide. filtres de date incorrects, etc.
-
Statut 401 - Non autorisé. Informations d’identification non valides.
-
Statut 403 - Interdit. L'utilisateur ne dispose pas de l'autorisation pour afficher l'état du job.
-
État 404 – Introuvable. entité manquante ou version non valide.
-
État 500 - Erreur de serveur Interne.
QM Entité Workflow et CSV fichier
L’API de Flux de travail de QM vous permet d'extraire les données de flux de travail de QM, ce qui inclut les évaluations, les auto-évaluations et les étalonnages.
Pour le travail POST :
-
L’entityName est : qm-workflows
-
La version est : 4
Les données sont filtrées en fonction de la Date de soumission (en UTC).
Champs dans le QM Fichier csv du flux de travail
|
Nom de colonne |
Description |
|---|---|
|
Nom du locataire |
Nom du locataire. |
|
Id de l’agent |
Identifiant unique de l'agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Type |
Type d'évaluation, par exemple :
Type DE champ : chaîne avec jusqu’à 24 caractères (VARCHAR) |
|
Déclencheur de Flux d'évaluation |
Événement qui a démarré l'évaluation :
Type DE champ : chaîne avec jusqu’à 24 caractères (VARCHAR) |
|
Statut du Workflow |
État du flux de travail :
Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) |
|
Accusé de réception automatique |
Les valeurs possibles sont :
Type DE champ : BOOLÉEN |
|
État du flux de travail |
État du flux de travail :
Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) |
|
Id du flux de travail |
L'identifiant unique de l'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) Version de l'API : 3 et supérieure |
|
Nom du plan |
Le nom du plan qualité utilisé pour lancer cette évaluation. Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) |
|
Nom du formulaire |
Le nom du formulaire utilisé pour cette évaluation. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Version du formulaire |
La version du formulaire d’évaluation utilisée pour cette évaluation. Type DE champ : numérique (4,0) |
|
Date de début |
Date et heure (en UTC) du début de cette évaluation. Type DE champ : TIMESTAMP_LTZ(3) |
|
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 recours, vous souhaitez extraire la Date de soumission, et non la Dernière mise à jour. |
|
Score - Pourcentage |
Note d’évaluation en pourcentage. Type DE champ : FLOTTANT |
|
Score |
Note d’évaluation. Type DE champ : FLOAT |
|
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 avec jusqu’à 256 caractères (VARCHAR) |
|
Question critique échouée |
Si la valeur est true, 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, l'utilisateur a répondu correctement à la question. Type DE champ : BOOLÉEN |
|
Commentaires de revue des utilisateurs |
Les commentaires saisis par l'utilisateur (Agent) lors de la contestation de l'évaluation. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Commentaires du résolveur de contestations |
Les commentaires saisis par l'utilisateur (responsable / évaluateur) lors de la clôture du litige. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Id DE segment |
Id DE segment de l'interaction en cours d'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
ID ACD |
Identifiant unique du distributeur automatique d'appels. Type DE champ : numérique (38,0) |
|
Type d'interaction |
Type d'interaction:
Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Date de début d’interaction |
Date-heure de début (en UTC) de l'interaction. Type DE champ : TIMESTAMP_LTZ(6) |
|
Date DE fin d'interaction |
Date-heure de fin (en UTC) de l'interaction. Type DE champ : TIMESTAMP_LTZ(6) |
|
Direction de l'interaction |
Direction of appel :
Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Id de l’équipe |
L'identifiant unique de l'équipe de l'agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Nom DE l’équipe |
Nom DE l’équipe de l’Agent. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Numéro DE téléphone |
Numéro DE téléphone du client. Type DE champ : chaîne avec jusqu’à 200 caractères (VARCHAR) |
|
Prénom (Eva) |
Prénom de l'évaluateur. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom (Eva) |
Nom de famille de l'évaluateur. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
FirstName (Agent) |
Prénom de l'agent évalué. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
NomDeFamille (Agent) |
Nom de famille de l'agent évalué. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Prénom (Disp) |
Prénom du résolveur de litige. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom de famille (Disp) |
Nom de famille du résolveur de litige. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Prénom (attributaire) |
Prénom de l'utilisateur qui a attribué l'évaluation. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom (attributaire) |
Nom de famille de l'utilisateur qui a attribué l'évaluation. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
| Raison |
Raison de la suppression de l'évaluation. Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) **API version** : 4 et supérieure |
| Id parent |
L'id du flux de travail parent de l'évaluation, tel que collaboratif et calibrage. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) Version de l'API : 4 et supérieure |
| Sujet d’évaluation |
Les valeurs possibles sont :
Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) Version de l'API : 4 et supérieure |
QM Questions and Answers (Q&A) Entité et Fichier csv
L'API QM Q&A vous permet d'extraire les questions et réponses des QM évaluations, auto-évaluations et étalonnages.
Pour le travail POST :
-
L’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 « Questions-réponses » de QM
|
Nom de colonne |
Description |
|---|---|
|
Id de question |
Identifiant unique de la question. Type DE champ : NUMBER(38,0) |
| Titre de la question |
Le texte de la question. Type DE champ : chaîne avec jusqu’à 2048 caractères (VARCHAR) |
| Numéro de question |
Le numéro de la question dans le formulaire d'évaluation. Type DE champ : chaîne avec jusqu’à 15 caractères (VARCHAR) |
| Répondre |
La réponse de l'évaluateur à la question. Type DE champ : chaîne avec jusqu’à 10000 caractères (VARCHAR) |
| Options |
Les options de réponse disponibles pour la question, telles que oui/Non, les options numérique, les options de bouton radio, etc. Type DE champ : Tableau |
| ID de formulaire |
Identifiant unique du formulaire d'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Nom du formulaire |
Le nom du formulaire utilisé pour cette évaluation. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Version du formulaire |
La version du formulaire d’évaluation utilisée pour cette évaluation. Type DE champ : NUMBER(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 Appeals, vous souhaitez extraire la Date de soumission, et non la date de dernière modification. |
|
Type de Workflow |
Type d'évaluation, par exemple :
Type DE champ : chaîne avec jusqu’à 24 caractères (VARCHAR) |
| Section ID | Unique identifier of the section in evaluation form. Type DE champ : NUMBER(38,0) |
| Titre de la Section |
Le nom de la section dans le formulaire d'évaluation. Type DE champ : chaîne avec jusqu’à 2048 caractères (VARCHAR) |
| Coté |
Indicateur vrai ou faux pour savoir si la question peut être notée. Type DE champ : BOOLÉEN |
| Score réel |
Le score que l'agent a reçu sur la question. Type DE champ : FLOTTANT |
| Note 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 avec jusqu’à 36 caractères (VARCHAR) |
|
FirstName (Agent) |
Prénom de l'agent évalué. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
LastName (Agent) |
Nom de famille de l'agent évalué. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Id de l’équipe |
L'identifiant unique de l'équipe de l'agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Nom DE l’équipe |
Nom DE l’équipe de l’Agent. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Prénom (Eva) |
Prénom de l'évaluateur. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom (Eva) |
Nom de famille de l'évaluateur. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
| Critique |
Indicateur vrai ou faux pour si la question était une question critique. Type DE champ : BOOLÉEN |
|
Question critique en échec |
Si la valeur est true, 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, 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:
Type DE champ : chaîne avec jusqu’à 64 caractères (VARCHAR) |
|
Id DE segment |
Id DE segment de l'interaction en cours d'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Date de début D'INTERACTION |
Date-heure de début (en UTC) de l'interaction. Type DE champ : TIMESTAMP_LTZ(6) |
|
Date DE fin d'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 avec jusqu’à 36 caractères (VARCHAR) |
|
Note 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 avec jusqu’à 36 caractères (VARCHAR) |
| Nom masqué |
L’indicateur « vrai » masque les questions et l’indicateur « faux » les affiche. Lorsque la règle QM Form est utilisée dans un formulaire de qualité, elle masque une question de suivi sur la base du score d'une question précédente. Type DE champ : BOOLÉEN Version de l'API : 2 et supérieure |
QM Notes de l'évaluateur et Fichier csv
L’API Notes de l’Évaluateur QM vous permet d’extraire les notes de l’évaluateur QM.
Pour le travail POST :
-
entityName a la valeur : qm-évaluation-commentaire-entité
-
La version est : 1
Les données sont filtrées en fonction de la Date de soumission (en UTC).
Champ du Fichier csv de notes de l’évaluateur QM
|
Nom de colonne |
Description |
|---|---|
|
ID de commentaire |
L'identificateur unique du commentaire. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Commentaires |
Le texte du commentaire. Type DE champ : chaîne avec jusqu’à 300 caractères (VARCHAR) |
|
Heure de commentaire |
Date et heure de création d’ajout du commentaire. Type DE champ : TIMESTAMP_LTZ(3) |
|
Activité |
Le nom de l’action d’évaluation lorsque le commentaire a été ajouté. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Commenté par ID |
L'identificateur unique de l'utilisateur qui a ajouté le commentaire. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Commentaire par prénom |
Prénom de l'utilisateur qui a ajouté le commentaire. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Commenté par prénom |
Le prénom d'utilisateur qui a ajouté le commentaire. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Id de question |
L'identificateur unique de la question. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Titre de la question |
Le texte de la question. Type DE champ : chaîne avec jusqu’à 2048 caractères (VARCHAR) |
|
ID de formulaire |
L'identificateur unique du formulaire d'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Nom du formulaire |
Le nom du formulaire utilisé pour l'évaluation. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Version du formulaire |
La version du formulaire d’évaluation utilisée pour l’évaluation. Type DE champ : NUMBER(4,0) |
|
Id du flux de travail |
L'identifiant unique de l'évaluation. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
État du flux de travail |
L'état du flux de travail. Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) |
|
Id de l’agent |
L'identificateur unique de l’agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
FirstName (Agent) |
Prénom de l'agent. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
LastName (Agent) |
Nom de l'agent. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Id de l’équipe |
L'identifiant unique de l'équipe de l'agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
|
Nom DE l’équipe |
Nom de l'équipe de l'Agent. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
Entité Métadonnées d'interaction et Fichier csv
L'API de Métadonnées d'interaction vous permet d'extraire Recording Management (CXone) métadonnées d'interaction.
Pour le travail POST :
-
L’entityName : recording-interaction-metadata
-
version est : 12
-
Pour filtrer les données par date et heure, utilisez startDate et endDate en UTC au format : yyyy-mm-dd 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, celui-ci est identique à NiCE CXoneId du contact principal Type DE champ : numérique avec jusqu’à 38 chiffres |
|
Id DE segment |
Identifiant unique du segment. Un segment est une interaction avec deux parties, comme un client et un agent. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR UUID) |
|
Raison du début de segment |
Raison pour laquelle le segment a commencé :
Type DE champ : chaîne avec jusqu’à 100 caractères (VARCHAR) |
|
Raison de fin de segment |
Raison pour laquelle le segment s'est terminé :
Type DE champ : chaîne avec jusqu’à 100 caractères (VARCHAR) |
| Direction |
Direction du segment:
Type DE champ : chaîne avec jusqu’à 150 caractères (VARCHAR) |
|
Date-heure de début (en UTC) du segment. Type DE champ : Estampille temporelle |
|
|
Date DE fin |
Date-heure de fin (en UTC) du segment. Type DE champ : Estampille temporelle |
| Type DE canal |
Type d'interaction:
Type DE champ : chaîne avec jusqu’à 150 caractères (VARCHAR) |
| Enregistrement de l’écran |
Si le segment comprend l'enregistrement d'écran:
|
| Statut de l'enregistrement vocal |
État de l'enregistrement :
Type DE champ : chaîne avec jusqu’à 250 caractères (VARCHAR) |
| État d'enregistrement d'écran |
État de l'enregistrement :
Type DE champ : chaîne avec jusqu’à 250 caractères (VARCHAR) |
|
Alertes d’enregistrement |
Les alertes d’enregistrement incluent :
|
|
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 avec jusqu’à 100 caractères (VARCHAR) |
| ANI |
Pour les appels entrants, ANI est le numéro DE téléphone de l'appelant (identification de l'appelant). Type DE champ : chaîne avec jusqu’à 200 caractères (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 avec jusqu’à 200 caractères (VARCHAR) |
| ACW (en secondes) |
Combien de secondes l'enregistrement d'écran s'est poursuivi après la fin de l'appel pour capturer le travail après l'appel de l'agent. |
| Disposition | Balise que l'Agent attribue avec des informations supplémentaires sur l'appel. |
|
Id DE segment Externe |
ID d’un segment tel que défini dans la source externe de l’enregistrement. Les valeurs sont uniquement disponibles pour les utilisateurs disposant de Recording AppLink. Type DE champ : chaîne avec jusqu’à 100 caractères (VARCHAR) Version de l'API : 6 et supérieure |
|
Id du contact Externe |
ID d’un contact tel que défini dans la source externe de l’enregistrement. Les valeurs sont uniquement disponibles pour les utilisateurs disposant de Recording AppLink. Type DE champ : chaîne avec jusqu’à 100 caractères (VARCHAR) Version de l'API : 6 et supérieure |
|
Source |
La source de l'enregistrement — NiCE CXone ou une source externe. Les valeurs sont les suivantes :
Type DE champ : chaîne avec jusqu’à 30 caractères (VARCHAR) Version de l'API : 6 et supérieure |
|
Liste des numéros de contact associés |
Liste des numéros des contacts des agents associés au segment. Les éléments de cette liste sont de type numérique uniquement. Type DE champ : Variante **API version** : 7 et supérieures |
|
ID d'interaction |
Id unique (UUID) pour une interaction. Lorsque plusieurs segments sont associés à une seule interaction, les segments peuvent avoir le même Id d’interaction. L’Id d’interaction ne doit pas être confondu avec l’Id DE segment ou l’id de contact. Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) Version de l'API : 7 et supérieure |
| Nombre d'appels en attente | The total number of times the agent placed the customer on hold during a call. **API version** : 8 et supérieures |
| Durée de la mise en attente en Secondes | The total number of seconds that the customer was put on hold during a call (the sum of all holds). Version de l'API : 8 et supérieures |
|
Appel Complexe |
Indique si un appel comportait plusieurs Participants. Type DE champ : Valeurs booléennes composées de TRUE ou FALSE (BOOLEAN) Version de l'API : 9 et supérieures |
|
État du 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 supérieure Les valeurs possibles sont :
|
|
État du masquage du Recording 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 supérieure Les valeurs possibles sont :
|
| Id DE l’utilisateur de l'Agent |
Identifiant unique attribué à l'agent. Le Fichier csv contient ce champ sous la forme d'une colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Noms de colonnes d'exemple : Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR) |
| ID Agent ACD |
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. Noms de colonnes exemples : Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
| Numéro du contact de l'Agent |
Identifiant unique du contact créé pour cet agent. Ce champ n'est pas disponible pour Engagement Hub (Multi-ACD/Open). Le Fichier csv contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Noms de colonnes d'exemple : Type DE champ : numérique avec jusqu’à 38 chiffres Version de l'API : 5 et supérieure |
|
Nom DE l’agent |
Nom de l'Agent tel que spécifié dans leNiCE CXone compte employé. Le Fichier csv contient ce champ sous forme de colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Noms de colonnes exemple : Type DE champ : chaîne avec jusqu’à 100 caractères (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. Noms de colonnes exemples : Type DE champ : chaîne avec jusqu’à 36 caractères (VARCHAR UUID) |
|
Équipe Agent |
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. Noms de colonnes d'exemple : Type DE champ : chaîne avec jusqu’à 40 caractères (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 la forme d'une colonne distincte pour chaque agent, prenant en charge jusqu'à 5 agents. Noms de colonnes d'exemple : Type DE champ : chaîne avec jusqu’à 50 caractères (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 commerciales :
Exemples de noms de colonnes : Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) Version de l'API : 7 et supérieure |
|
Valeur des Données commerciales |
La valeur des données commerciales peut être au format texte, numérique ou vrai/faux. Le Fichier csv contient ce champ sous forme de colonne distincte pour chaque entrée de données commerciales :
Exemple de noms de colonnes : Type DE champ :
Version de l'API : 7 et supérieure |
| Adresse client |
Contient des valeurs ANI et DNIS Multiple pour un même segment d'interaction, prenant en charge des scénarios où Multiple clients sont impliqués dans un même appel. . Les valeurs sont stockées sous forme de Tableau, par exemple : ['ANI1', 'ANI2', 'ANI3'] Pour les appels entrants, le champ contiendra toutes les valeurs ANI sous forme de chaîne séparée par des virgules. Pour les appels sortants, le champ contiendra toutes les valeurs DNIS sous forme de chaîne séparée par des virgules. Type DE champ : Tableau de chaînes de caractères comportant jusqu'à 200 caractères (VARCHAR) Version de l'API : 12 et supérieure |
| Nom du système téléphonique |
Indique le système téléphonique tiers à partir duquel les appels sont initiés. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) API version : 12 |
et sélectionnez WFM Entité de paie et Fichier csv
L'API WFM Paie (version1) vous permet d'extraire les données d'activité WFM à des fins de reporting externe sur la paie.
Le WFM nom de l'entité Paie pour le travail POST est : wfm-payroll.
Les données sont filtrées selon Date de 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.
Des champs dans le WFM Fichier csv de Paie
|
Nom de colonne |
Description |
|---|---|
|
Prénom |
Prénom de l'Agent. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom de famille |
Nom de famille de l'Agent. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Nom d’utilisateur |
Nom d’utilisateur (nom d’utilisateur) de l'Agent. Type DE champ : chaîne avec jusqu’à 255 caractères (VARCHAR) |
|
Unité DE planification |
Unité DE planification de l'Agent. Type DE champ : chaîne avec jusqu’à 256 caractères (VARCHAR) |
|
Fuseau horaire de l'unité DE planification |
Fuseau horaire de l'unité DE planification de l'agent. Type DE champ : chaîne avec jusqu’à 128 caractères (VARCHAR) |
|
Code de paie |
Le code de paie qui contient les données d'activité planifiées. Type DE champ : chaîne avec jusqu’à 50 caractères (VARCHAR) |
|
Date (dans le fuseau horaire de l'unité DE planification) de l'activité. Type DE champ : DATE |
|
|
Heure de DÉMARRAGE |
Heure de début (dans le fuseau horaire de l'unité DE planification) de l'activité. Type DE champ : TIME (9) |
|
Durée en Secondes |
La durée de l'activité en secondes. Type DE champ : numérique (8,0) |