Variables prédéfinies

Les informations contenues dans cette page d’aide s’appliquent à la fois à Studio et à Desktop Studio.

Les variables prédéfinies sont des variables système déjà définies. Vous pouvez les utiliser dans vos scripts sans les créer. Il est possible de remplacer la valeur attendue pour les variables prédéfinies, mais ce n'est pas recommandé. Ne remplacez ces valeurs que si l'aide en ligne ou un représentant de compte vous demande de le faire.

Les variables prédéfinies sont automatiquement ajoutées aux scripts. Certaines proviennent de scripts système qui s'exécutent en arrière-plan avant qu'une interaction soit acheminée vers vos scripts. Celles-ci sont aussi appelées variables système. D'autres variables prédéfinies proviennent des actions que vous ajoutez à vos scripts. Vous pouvez utiliser l'outil de trace pour afficher les variables d'un script. Au fur et à mesure que vous cliquez sur chaque action dans la Sortie de trace, l'onglet Variables vous montre les actions du script à ce point.

Afficher les variables prédéfinies dans un script

Vous pouvez afficher les variables d'un script à l'aide de l'outil de trace. Si vous tracez un script pendant une interaction, vous pouvez voir les variables qui lui sont transmises. Ces variables proviennent de scripts système et d'autres sources, comme le fournisseur de services téléphoniques. Vous pouvez tracer un script avec une interaction simulée, mais vous ne pouvez voir que les variables qui lui sont transmises par les scripts système. Cette section décrit la trace d'un script d'appel téléphonique entrant simulé. Vous pouvez également afficher les variables prédéfinies d'un script en exécutant une trace sur d'autres interactions.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Omnicanal Routing > Studio Three arrows joined at the base. One points straight up, one up and to the right, and one up and to the left. .
  2. Sur la page Scripts, repérez et double-cliquez pour ouvrir le script que vous voulez utiliser ou créez-en un nouveau. Le script s'ouvre dans un nouvel onglet.
  3. Cliquez sur Trace > Démarrer avec Trace.
  4. Sélectionnez une ACDCompétence de téléphone entrant.
  5. Sélectionnez Simuler un Appel entrant.
  6. Entrez le numéro de Téléphone que vous voulez que le script compose. Ce doit être le numéro d'un téléphone auquel vous pouvez répondre pendant les tests. Cette ligne représente le contact qui appelle votre organisation.
  7. Entrez le DNIS pour ce canal. C'est le numéro que le contact composerait pour joindre votre organisation. Vous pouvez utiliser le numéro de téléphone d'un autre téléphone auquel vous avez accès pour ce numéro. Cette ligne représente le segment d’agentClosed Votre connexion audio à NiCE CXone pour les appels et les messages vocaux..
  8. Entrez un ANI. L'ANI est le numéro de téléphone indiqué comme l'id de l’appelant d'un appel téléphonique entrant. Il peut s'agir du même numéro que celui utilisé dans le champ numéro de téléphone.
  9. Cliquez sur Démarrer la trace.
  10. Répondez à l'appel lorsque votre téléphone sonne et effectuez les actions nécessaires pour tester votre script. Par exemple, si vous testez l'IVR, vous voudrez peut-être répéter ces étapes autant de fois que nécessaire pour tester chaque option de menu.
  11. Dans la fenêtre Trace Output, cliquez sur l'action Begin. L'onglet Variables affiche toutes les variables transmises au script à partir des scripts système.

  12. Double-cliquez sur une variable pour voir le nom de la variable et sa valeur. Ceci est utile pour les variables ayant des valeurs longues qui ne tiennent pas dans la colonne Value.

    Si vous voulez voir d'autres variables ajoutées au script à mesure que l'interaction progresse, cliquez sur d'autres actions dans la section principale de la fenêtre Trace Output.

Variables prédéfinies communes

Le tableau suivant contient certaines des variables prédéfinies les plus courantes. Chaque script ne contiendra pas nécessairement toutes les variables de la liste. Les variables prédéfinies disponibles dans un script dépendent du type de support du script et des actions utilisées dans le script. De plus, certaines variables proviennent du fournisseur de services. Ces variables peuvent varier selon le fournisseurr.

Avant d'utiliser l'une des variables de cette section, vérifiez qu'elles sont présentes dans le script sur lequel vous travaillez à l'aide de l'outil de trace. L'utilisation de variables prédéfinies dans un script alors que cette variable n'est pas transmise au script ou ajoutée par une action peut entraîner des scripts qui ne fonctionnent pas comme prévu.

Dans la mesure du possible, vérifiez les variables de votre script à l'aide d'une interaction en direct et non d'une interaction simulée. Les interactions simulées peuvent contenir des variables qu'une interaction en direct ne contient pas. De même, une interaction en direct peut contenir des variables qu'une simulation ne contient pas.

Nom de variable Description
__agentContactID L'id de session pour la session de l'application d'agent.
__agentId L'ID de l'agent qui répond à une interaction. Cette variable ne contient aucune valeur jusqu'à ce qu'un agent réponde à l'interaction.
EAN (enregistrement automatique des numéros, ANI en anglais)

Le numéro de téléphone de l'appelant au format du Plan de Numérotage nord-américain. Il s'agit du format standard des numéros de téléphone en Amérique du Nord. La variable e164ANI contient le même numéro, mais au format international.

Cette valeur provient du transporteur téléphonique. Les valeurs possibles incluent Restreint et Anonyme.

busno

Le numéro de votre unité commercialeClosed 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.. Il s'agit de l'identifiant unique de votre NiCE CXone système.

Si votre organisation compte plus d'une unité commerciale, vous pouvez utiliser cette valeur pour effectuer des déterminations logiques dans votre script. Par exemple, vous pouvez vérifier le busno avant d'attribuer une compétenceClosed Utilisé pour automatiser la livraison des interactions en fonction des compétences, des aptitudes et des connaissances de l’agent. ACD pour vous assurer que vous attribuez une compétence qui existe dans l'unité commerciale.

contactId L'identifiant unique de chaque contact. Le contactId permet de trouver et de générer des rapports sur un contact spécifique. Un nouveau contactId est créé si un script secondaire est généré.
city The name of the city where the call originates.

Pour les interactions entrantes, cette valeur provient du fournisseur de services du contact. Pour les interactions sortantes, cette valeur provient de votre fournisseur de services.

pays

Nom du pays désigné par le code de pays (voir l'élément suivant) dans la chaîne du numéro de téléphone d'un appel entrant ou sortant. La plateforme de téléphonie NiCE CXone génère automatiquement cette valeur en fonction des valeurs de l'Union internationale des Télécommunications (UIT) et la transmet dans les métadonnéesClosed Données qui fournissent des informations sur d'autres données. d'appel.

Pour les interactions entrantes, cette valeur provient du fournisseur de services du contact. Pour les interactions sortantes, cette valeur provient de votre fournisseur de services.

countryCode

Code de l'Union internationale des Télécommunications (UIT) désignant le pays d'origine pour un appel entrant ou le pays de destination pour un appel sortant. Ce code apparaît au début de toute chaîne de numéro de téléphone et est transmis dans les métadonnées d'appel. Par exemple, le code UIT des états-Unis est +1. Pour connaître le code de pays d'un pays donné, effectuez une recherche sur Internet pour code de pays <pays>. Le format de ce code peut varier selon l'origine de l'appel.

Pour les interactions entrantes, cette valeur provient du fournisseur de services du contact. Pour les interactions sortantes, cette valeur provient de votre fournisseur de services.

DNIS Le numéro composé par l’appelant selon le format du plan de Numérotage nord-américain. Il s’agit du format standard pour les numéros de téléphone en Amérique du Nord. La variable e164DNIS contient le même numéro, mais dans un format international.

e164ANI

e164DNIS

Les ANIClosed Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. et DNISClosed Le numéro composé lors des appels vocaux entrants ou sortants. mis en forme selon les normes de mise en forme téléphonique E.164. E.164 est une norme internationale de mise en forme des numéros de téléphone en dehors des états-Unis.
de L’adresse courriel de l’expéditeur.
__httpstatuscode Le code d’état HTTP renvoyé par le serveur que l’REST API action appelle.
__httpstatusdescription La description de l’état HTTP renvoyée par le serveur que l’action REST API appelle.
isReskill Indique si l’id du contact actuel a fait l’objet d’un recyclage des compétences. Les valeurs sont 1 (vrai) ou 0 (faux).
__lastStateChange L’estampille temporelle de la dernière fois qu’un contact a changé d’état. Par exemple, lorsqu’un contact passe de l’état Pré-file d’attente à l’état En file d’attente, cette variable se remplit avec l’estampille temporelle du moment où ce changement a eu lieu.
masterId

L’identifiant unique qui permet d’identifier tous les scripts provenant du même parent. Il est utilisé lorsqu’un script en génère un autre ou est exécuté à partir d’un autre. Pour le script parent, les contactId et masterId sont identiques. Pour tout script enfant, le contactId est une nouvelle valeur unique et le masterId est la même valeur que le contactId du script parent.

Par exemple, lorsque vous recyclez les compétences d’une interaction, le masterId de l’interaction recyclée est identique au contactId de l’interaction d’origine. Si l’interaction est recyclée une deuxième fois, le masterId de l’interaction nouvellement recyclée est identique au contactId du script enfant.

__mediaServerName Le nom du serveur multimédia. Cette variable est utile pour le dépannage des problèmes liés au serveur lorsque vous travaillez avec le Soutien Technique NiCE CXone. Les problèmes incluent des éléments tels que la latence distante ou les problèmes de téléphonie.
__POC L’id unique du point de contactClosed point d’entrée qu’un contact entrant utilise pour amorcer une interaction, comme un numéro de téléphone ou une adresse courriel.. Il correspond à l’ID dans l’application NiCE CXone ACD.
__SIPInvite Contient les informations d’en-tête relatives au contact. Si vous transférez un appel d’une unité commercialeClosed 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. à une autre, cette variable contient les informations relatives à l’appel d’origine. Par exemple, vous pouvez accéder au contactID de l’appel provenant de l’unité commerciale d’origine.
__Skill

L’identifiant unique de la compétenceClosed Utilisé pour automatiser la livraison des interactions en fonction des compétences, des aptitudes et des connaissances de l’agent. ACD particulière. La __Skill variable permet de trouver et de produire un rapport sur une compétence spécifique. Cette valeur peut changer avec la Reqagent action.

__SkillName The name of the ACD skill. It accompanies __Skill and can change with the Reqagent action.

état État des états-Unis où vit l’appelant. Cette valeur provient du fournisseur de services du contact.
__targetScript Le script que le script système lance.
test Ne tentez pas de définir ou d’utiliser cette variable en dehors d’une action Extrait action. Cela pourrait entraîner de graves conséquences. Elle est réservée au débogage de code dans une action Extrait.
to L’adresse courriel de destination.

Variables prédéfinies d’Uptivity

s
Nom de variable Description
_customFilter

La valeur de cette variable est utilisée comme filtre de porte ACD dans Uptivity.

_user1 - _user 8

La valeur de ces variables est utilisée pour remplir les champs User 1 à User 8 dans Uptivity.

User9

Bien que User9 ne soit pas techniquement une variable, sa valeur provient du compte utilisateur de l’agent, plus précisément de la valeur des propriétés Custom 1, et remplit le champ User 9 dans Uptivity.

User10 Bien que User10 ne soit pas techniquement une variable, sa valeur provient du compte utilisateur de l’agent, plus précisément de la valeur des propriétés Custom 2, et remplit le champ User 10 dans Uptivity.
_surveyDNIS

Cette valeur est un id unique créé par l’utilisateur qui est attribué lors de la création d’un sondage Uptivity et utilisé pour déterminer quel sondage exécuter pendant le rappelClosed Conserve la place d’un client dans la file d’attente et appelle automatiquement le client lorsqu’il arrive en tête de file..

_surveyCallbackDNIS

Cette valeur est le nombre qui sera utilisé dans le rappel pour le sondage. Cette variable est destinée à être utilisée uniquement avec un sondage Uptivity.

_surveyCallbackANI

Cette valeur est l’id de l’appelant qui s’affichera pendant le rappel utilisé pour le sondage. Cette variable est destinée à être utilisée uniquement avec un sondage Uptivity.