RUNAPP

Cette page d'aide concerne Studio. Ces informations sont également disponibles pour Desktop Studio.

Icône de Runapp : fenêtre de navigateur bleue avec un pointeur

Lance des fonctionnalités personnalisées à partir du script, en lançant spécifiquement un formulaire, une page Web ou une application. Toutes les URL ciblées vers un panneau de contact doivent être configurées pour permettre leur affichage dans une iframe. Les agents doivent avoir le paramètre Panels dans MAX défini sur Activé. Salesforce Agent et Salesforce Agent Lightning prennent en charge cette action.

Cette action soumet des informations via la branche Ondata.

Une utilisation courante de Runapp consiste à afficher un formulaire standard ou une URL personnalisée pour les agents avec l'événement ONANSWER (géré par l'action Onanswer).

Vous pouvez utiliser l'PAGE action pour afficher des pages HTML simples à un agent. Page est utile pour créer une séquence d'éléments qui suivent des branches distinctes, alors que chaque fois que vous soumettez des informations avec Runapp, les informations passent par la branche Ondata.

Dans NiCE CXone Agent Workspace (Agent), cette action affiche uniquement le lien URL. Elle n'affiche pas la page via un iframe. De plus, un formulaire personnalisé s'affiche comme un lien. Il est suggéré d'utiliser plutôt l'POPURL action.

OpenURL est le seul type d'action pris en charge pour Salesforce Agent. Si vous voulez afficher un formulaire personnalisé, utilisez l'Indiquer action.

Types de scripts pris en charge

Un carré d'où part une ligne qui va vers trois autres carrés.

Icon of gray-green envelope

\n Icon of dark green speech bubble\n

Icon of purple telephone handset

Icon of pink document with lines of text

Icône d'un téléphone mobile vert avec une bulle de discussion sur l'écran

Icône d'un moniteur d'ordinateur violet avec un appareil mobile chevauchant son coin inférieur droit

Générique

Email Conversation Téléphone Élément de travail SMS Digital

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais présentent quelques différences clé :

  • Runapp : Lance des fonctionnalités personnalisées à partir du script, en lançant spécifiquement un formulaire, une page Web ou une application.
  • PopURL : ouvre des URL de pages Web et propose des options pour l'emplacement et le style du panneau qui affiche la page Web.
  • Indiquer : Étend l'interface agent avec une fonctionnalité personnalisée, plus précisément une icône que l'agent clique pour initier la fonction personnalisée. Ceci est similaire à Runapp, sauf que, avec Indiquer, le Type d'action est initié par le script plutôt que par l'agent.

Propriétés de saisie

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété

Description

Ajouter une légende

Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action.

Id de l’agent

L'ID de l'agent. Entrée un ID ou type pour trouver un agent spécifique. Vous pouvez utiliser une variable pour ce champ, telle que {agentId}.

Les compétences sortantes ont un script personnalisé attribué. Par conséquent, lorsque Runapp se déclenche dans le script personnalisé sortant, celui-ci utilise l'action Begin car il « sait » déjà qui est l'agent (celui qui effectue l'appel sortant). Par conséquent, un pop d'écran ne fonctionnera que si {__agentID} est utilisé comme nom DE variable. Pour les scripts entrants, le script ne « sait » pas qui est l'agent jusqu'à ce que Onanswer se déclenche, ce qui définit la variable ID de l'agent sur AGENTID.

Vous pouvez utiliser l’éditeur de propriétés RunApp pour configurer cette propriété en double-cliquant sur l’action.

Type d’action

  • RunExe : NiCE CXone ne prend pas en charge. Cela nécessite un exécutable local qui se trouve dans le chemin Windows ou avec le chemin complet saisi dans le champ ActionValue. Le chemin du fichier doit inclure des doubles barres obliques inverses (\\) dans le chemin. Par exemple, C:\\ Program Files\\NiCE CXone\\ studio.exe. La plupart des navigateurs modernes ne prennent pas en charge l'exécution de programmes exécutables. Si vous souhaitez utiliser ce type, assurez-vous que vos agents utilisent un navigateur compatible.
  • OpenURL : ouvre un navigateur web par défaut vers l'URL spécifiée dans le ActionValue champ.
  • ShowCustomForm : lance un formulaire html personnalisé créé dans Studio. Les données capturées à partir du formulaire personnalisé déclencheront l'événement ONDATA dans le script.

Vous pouvez utiliser l'éditeur Propriété RunApp pour configurer cette propriété en double-cliquant sur l'action.

Valeur de l’action

La valeur requise par le ActionType spécifié. Les variables sont prises en charge dans cette propriété en encapsulant la variable entre {accolades}.

  • RunExe : nom ou chemin vers un fichier exécutable Windows. Le chemin du fichier doit inclure des doubles barres obliques inverses (\\) dans le chemin. Par exemple, C: \\ Program Files \\ MyCompany \\ myApp.exe -h {ANI}.
  • OpenURL: doit être un nom de domaine complet et une URL. Les paramètres de chaîne de requête sont pris en charge. http://www.example.com/file.asp?ANI={ANI}. Vous pouvez également personnaliser le titre de l'onglet qui apparaît dans le MAX interface en ajoutant le paramètre icAgentPanelTitle = à l'URL. Ce paramètre n'est pas pris en charge dans NiCE CXone Agent Workspace (Agent).
  • ShowCustomForm: This field offers the ability to build a custom HTML form. Any standard form input fields may be used, including Input, Textarea, Password, Checkbox, Radio, Select, Button, and Submit. Don't include the <form> tags.

    Chaque champ de saisie doit contenir un nom. Les Champs sans nom seront ignorés. Exemple, <input type="text" name="phone">.

    Le script doit contenir l'un des éléments suivants pour que votre formulaire personnalisé fonctionne :

    • Ondataaction : les noms et les valeurs sont renvoyés au script sous forme de variables à l'aide de cette action.
    • WaitForSubmit propriété : lorsqu'elle est incluse et définie sur True, les noms de champ deviennent des variables dans le script. Les valeurs de Champ deviennent le contenu des variables.

    Les champs de formulaire qui prennent en charge plusieurs valeurs, par exemple Case à cocher et Select, contiendront un tableau séparé par des virgules.

    Les boutons de soumission multiples peuvent être utilisés avec des noms identiques ou différents, mais tout bouton de soumission soumettra les données et fermera la fenêtre. Si vous voulez un bouton qui ne soumet pas, utilisez un bouton plutôt qu'une soumission.

    Les feuilles de style liées ne sont pas prises en charge, vous pouvez utiliser des styles en ligne. Par exemple, <div style="position: absolute: left: 10px: top: 100px:">.

    Le JavaScript fonctionnera lorsqu'il est lié à un JavaScript externe, mais le contenu doit être en HTTPS pour éviter les erreurs. Par exemple :

    <script type="text/javascript" src="https://www.example.com/test.js"></script>

    <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">

Vous pouvez utiliser l'Éditeur de propriétés RunApp pour configurer cette propriété en double-cliquant sur l'action.

Attendre Soumettre

Détermine si le système attend une action soumettre de l’agent. Lorsque ce paramètre est défini sur True, le système attend l'action de validation de l'agent. Les noms des champs deviennent des variables dans le script, la valeur du Champ correspondant à la valeur de la variable. Lorsque ce paramètre est défini sur False, vous devez inclure l'action Ondata dans le script, qui renvoie les noms de champs et les valeurs au script sous forme de variables.

WaitForSubmit ne s'applique que si le Type d'action est ShowCustomForm. Il fonctionne conjointement à WaitTimeout.

Désactivez cette propriété lorsque vous utilisez cette Action dans un script qui intègre un CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. avec une application NiCE CXone Agent Workspace (Agent). Lorsque cette propriété est activée, le formulaire est vide une fois soumis si le formulaire a expiré.

En mode Valeur: Cliquez pour basculer sur Activé. Laissez le paramètre sur Désactivé pour renvoyer les valeurs de champ au script avec l'action OnData.

En mode Expression : Entrez vrai pour activer la propriété. Laissez défini sur false pour renvoyer les valeurs de champ au script avec l'action OnData.

Dépassement DE délai d'attente

Le nombre de secondes qui déclenchera la branche OnTimeout si le Type d’action est ShowCustomForm.

Conditions de branche de résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition

Description

Par défaut

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Soumettre Path taken if WaitForSubmit is set to True.
Dépassement DE délai Path taken if there is no response for the number of seconds specified.

Erreur

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.