RUNAPP

Esta página de ayuda es para Studio. Esta información también está disponible para Desktop Studio.

Inicia la funcionalidad personalizada desde el script, concretamente el lanzamiento de un formulario, página web o aplicación. Cualquier URL dirigida a un panel de contacto debe configurarse para permitir su visualización en un iframe. Los agentes deben tener su Panels configuración en MAX ajustado a On. Salesforce Agent y Salesforce Agent Lightning Apoye esta acción.

Esta acción envía información a través de la rama Ondata.

Un uso común de Runapp es mostrar un formulario estándar o una URL personalizada para los agentes con el evento ONANSWER(gestionado con la acción Onanswer).

Puede utilizar la PAGE acción para desplegar páginas HTML simples a algún agente. Page es útil para crear una secuencia de elementos que sigan ramas diferentes, mientras que cada vez que envía información con Runapp, la información pasa por la rama Ondata.

En NiCE CXone Agent Workspace (Agent), esta acción solo muestra el enlace URL. No muestra la página mediante iframe. Además, un formulario personalizado se muestra como un enlace. Se sugiere utilizar la acción POPURL en su lugar.

OpenURL es el único tipo de acción compatible con Salesforce Agent. Si desea mostrar un formulario personalizado, utilice la acción Indicar .

Tipos de secuencias de comandos compatibles

A square with a line branching from it that goes to three other squares.

Generic

Email Chat Phone Work Item SMS Digital

Comparación de Actions similares

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

  • Runapp: Inicia la funcionalidad personalizada desde el script, concretamente el lanzamiento de un formulario, página web o aplicación.
  • PopURL: Abre las URL de la página web y ofrece opciones para la ubicación y el estilo del panel que abre la página web.
  • Indicate: Amplía la interfaz del agente con funciones personalizadas, específicamente un icono en el que el agente hace clic para iniciar la función personalizada. Esto es similar a Runapp, excepto que con Indicate, el Action Type lo inicia el script en lugar del agente.

Propiedades de Entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Las propiedad

Descripción

Add Caption

Ingrese una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción.

Agent ID

The agent ID. Enter an ID or type to find a specific agent. You can use a variable for this field, such as {agentId}.

Outbound skills have a custom script assigned, therefore when Runapp fires in the outbound custom script, it uses the Begin action since it already "knows" who the agent is (the one making the outbound call). Therefore, a screen pop will only work if {__agentID} is used as the variable name. For inbound scripts, the script does not "know" who the agent is until Onanswer fires, which sets the agent ID variable to AGENTID.

You can use the RunApp Property editor to configure this property by double-clicking the action.

Action Type

  • RunExe: NiCE CXone does not support. This requires a local executable which resides in the Windows path or with the full path entered in the ActionValue field. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\NiCE CXone\\studio.exe. Most modern browsers do not support running executable programs. If you want to use this type, ensure that your agents use a compatible browser.
  • OpenURL: Opens a default web browser to the URL specified in the ActionValue field.
  • ShowCustomForm: Launches a custom HTML form created in Studio. The captured data from the custom form will trigger the ONDATA event in the script.

You can use the RunApp Property editor to configure this property by double-clicking the action.

Action Value

The value needed by the specified ActionType. Variables are supported in this property by encapsulating the variable in {braces}.

  • RunExe: The name or path to a windows executable file. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}.
  • OpenURL: Must be fully qualified domain name and URL. Query string parameters are supported. For example, http://www.example.com/file.asp?ANI={ANI}. You can also customize the title of the tab that pops up in the MAX interface by appending the icAgentPanelTitle= parameter to the URL. This parameter is not supported in 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.

    Each input field must contain a name. Fields without a name will be ignored. Example, <input type="text" name="phone">.

    The script must contain one of these things for your custom form to work: 

    • Ondataaction: Names and values are returned to the script as variables using this action.
    • WaitForSubmit property: When included and set to True, field names become variables in the script. Field values become the contents of the variables.

    Form fields that support multiple values, for example Checkbox and Select, will contain a comma-separated array.

    Multiple submit buttons can be used using the same or different names, but any submit button will submit the data and close the window. If you want a button that doesn't submit, then use a button rather than a submit.

    Linked stylesheets are not supported, you can use inline styles. For example, <div style="position: absolute: left: 10px: top: 100px:">.

    Javascript will work when linked to an external Javascript, but content must be HTTPS to avoid errors. For example:

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

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

You can use the RunApp Property Editor to configure this property by double clicking the action.

Wait For Submit

Determines whether the system waits for a submit action by the agent. When set to True, the system waits for the agent's submit action. Field names become variables in the script with the field value as the variable's value. When set to False, you must include the Ondata action in the script, which returns the field names and values to the script as variables.

WaitForSubmit is only applicable if the Action Type is ShowCustomForm. It works in conjunction with WaitTimeout.

Disable this property when using this action in a script that integrates a CRMClosed sistemas de Terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. with a NiCE CXone Agent Workspace (Agent) application. When this property is enabled, the form to be blank when submitted if the form has timed out.

En modo valor: Click to On to enable. Leave set to Off to return field values to the script with the OnData action.

En Modo de Expresiones: Enter true to enable. Leave set to false to return field values to the script with the OnData action.

Wait Timeout

The number of seconds that will trigger the OnTimeout branch if the Action Type is ShowCustomForm.

Result Branch Conditions

Las condiciones de las ramas de resultados le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecute una acción.

Condición

Descripción

Default

Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.
Submit Ruta tomada si WaitForSubmit está establecido en True.
Timeout Recorrido si no hay respuesta para el número de segundos especificado.

Error

Ruta tomada cuando la acción no se ejecuta correctamente. Por ejemplo, cuando haya un problema inesperado como una mala conectividad, errores de sintaxis, etc. La variable _ERR, con un único carácter de subrayado, debe llenarse con una explicación condensada del problema.