RUNAPP

Cette page d'aide s'applique à Studio. Ces informations sont aussi disponibles pour Desktop Studio.

Lance une fonctionnalité personnalisée depuis le script, en particulier en lançant 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 leur paramètre Panneaux dans MAX réglé sur Activé. Salesforce Agent et Salesforce Agent Lightning prennent en charge cette action.

Cette action soumet des informations par l’intermédiaire de 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é avec 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, tandis 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 par l’intermédiaire d’une iframe. De plus, un formulaire personnalisé s’affiche sous forme de lien. Il est suggéré d’utiliser plutôt l’action 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.

Générique

courriel Clavardage Téléphone Élément de travail SMS Digital

Comparaison des actions similaires

Les actions suivantes ont des fonctions semblables, mais avec quelques différences clés :

  • Runapp : Lance une fonctionnalité personnalisée depuis le script, en particulier en lançant un formulaire, une page Web ou une application.
  • PopURL : Ouvre des URL de pages Web et offre des options pour l’emplacement et le style du panneau qui affiche la page Web en incrustation.
  • Indicate : Étend l’interface de l’agent avec une fonctionnalité personnalisée, plus précisément une icône sur laquelle l’agent clique pour lancer la fonction personnalisée. Cela est semblable à 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 de façon unique cette action dans le script. La légende apparaît sur le canevas du script sous l’icône de l’action.

Id de l’agent

L’id de l’agent. Entrée un ID ou un type pour trouver un agent en particulier. Vous pouvez utiliser une Variable pour ce champ, comme {agentId}.

Les compétences sortantes ont un script personnalisé attribué, par conséquent, lorsque Runapp se déclenche dans le script personnalisé sortant, il utilise l’action Begin puisqu’il « connaît » 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 « connaît » pas qui est l’agent tant que Onanswer ne se déclenche pas, ce qui définit la variable de l’id de l’agent sur AGENTID.

Vous pouvez utiliser l’éditeur Propriété 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 réside dans le chemin Windows ou avec le chemin d’accès complet saisi dans le champ ActionValue. Le chemin d’accès 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 champ ActionValue.
  • ShowCustomForm : lance un formulaire HTML personnalisé créé dans Studio. Les données capturées 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’accès à un fichier exécutable Windows. Le chemin d’accès 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. Par exemple, http://www.example.com/file.asp?ANI={ANI}. Vous pouvez également personnaliser le titre de l’onglet qui s’affiche dans l’interface MAX 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 des champs deviennent des variables dans le script. Les valeurs des Champs 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'un bouton de 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 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 la soumission

Détermine si le système attend une action de soumission de la part de l'agent. Lorsque cette option est définie sur True, le système attend l'action de soumission de l'agent. Les noms des Champs deviennent des variables dans le script, la valeur du champ étant la valeur de la variable. Lorsque cette option est définie sur False, vous devez inclure l'action Ondata dans le script, qui retourne les noms et les valeurs des champs au script sous forme de variables.

WaitForSubmit s'applique uniquement 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 formulaire a atteint le dépassement de délai.

En mode valeur : Cliquez sur Activé pour activer. Laissez le paramètre Désactivé pour retourner les valeurs des champs au script à l'aide de l'action OnData.

En mode expression : Entrez true pour activer. Laissez le paramètre false pour retourner les valeurs des champs au script à l'aide de l'action OnData.

Dépassement de délai

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

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

Error

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.