RUNAPP

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

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 Panneaux 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'action PAGE pour envoyer 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 iframe. De plus, un formulaire personnalisé s'affiche sous forme de lien. Il est suggéré d'utiliser l'POPURL action à la place.

OpenURL est le seul Action Type prise en charge pour Salesforce Agent. Si vous souhaitez afficher un formulaire personnalisé, utilisez l'action Indiquer.

Types de scripts pris en charge

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

``` ```

``` ```

``` ```

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 avec quelques différences clés :

  • 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.
  • Indicate : étend l'interface agent avec une fonctionnalité personnalisée, à savoir une icône sur laquelle l'agent clique pour déclencher la fonction personnalisée. Ceci est similaire à Runapp, sauf qu'avec Indicate, 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.

Agent ID

L'ID de l'agent. Entrez un ID ou tapez 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é assigné, par conséquent lorsque Runapp se déclenche dans le script personnalisé sortant, il utilise l'action Begin car il « sait » déjà qui est l'agent (celui qui effectue l'appel sortant). Par conséquent, une fenêtre contextuelle 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 n'offre pas de soutien. Cela nécessite un exécutable local qui réside 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 à 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 : le nom ou le chemin d'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 prise 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:">.

    JavaScript fonctionnera lorsqu'il est lié à un JavaScript externe, mais le contenu doit être en HTTPS afin d'é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 étant la valeur de la variable. Lorsque défini sur False, vous devez inclure l'action Ondata dans le script, qui renvoie les noms et valeurs de champ au script en tant que 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 systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de soutien et les historiques de cas. à une application NiCE CXone Agent Workspace (Agent). Lorsque cette propriété est activée, le formulaire est vide lorsqu'il est soumis si le délai du 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 le paramètre sur false pour renvoyer les valeurs de champ au script au moyen de l'action OnData.

Dépassement DE délai d'attente

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

Conditions de branche 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.