RUNAPP

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

Icono de Runapp: ventana de navegador azul con un puntero

Inicia la funcionalidad personalizada desde el script, específicamente el lanzamiento de un formulario, página web o aplicación. Cualquier URL dirigida a un panel de contacto debe configurarse para permitir que se muestre en un iframe. Los Agentes deben tener la configuración de Panels en MAX establecida en Activado. Salesforce Agent y Salesforce Agent Lightning admiten 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 (administrado con la acción Onanswer).

Puede usar la PAGE acción para mostrar Páginas HTML simples a un agente. Page es útil para crear una secuencia de elementos que siguen ramas separadas, 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 de la URL. No muestra la página a través de iframe. Además, un formulario personalizado se muestra como un enlace. Se sugiere utilizar la POPURL acción en su lugar.

OpenURL es el único Tipo DE acción compatible para Salesforce Agent. Si desea mostrar un formulario personalizado, use la Acción Indicar action.

Tipos de secuencias de comandos compatibles

Un cuadrado del que sale una línea que va a otros tres cuadrados.

Icono de un sobre verde grisáceo

Icono de burbuja de diálogo verde oscuro

Ícono de auricular de teléfono violeta

Icon of pink document with lines of text

Icono de un teléfono móvil verde con un globo de diálogo en su pantalla

Ícono de un monitor de computadora violeta con un dispositivo móvil que se superpone a su esquina inferior derecha

Genérico

Correo electrónico Conversación Teléfono Elemento de trabajo SMS Digital

Comparación de acciones similares

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

  • Runapp: Inicia una funcionalidad personalizada desde el script, específicamente al abrir un formulario, una página web o una aplicación.
  • PopURL: abre URL de páginas web y proporciona opciones para la ubicación y el estilo del panel que muestra la página web emergente.
  • Indicate: Extiende la interfaz del agente con una funcionalidad personalizada, 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 tipo DE acción es iniciado por el script en lugar de por el agente.

Propiedades de entrada

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

Propiedad

Descripción

Agregar leyenda

Introduzca 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.

Id de agente

El id de agente. Ingrese un ID o escriba para buscar un agente específico. Puede usar una variable para este campo, como {AgentId}.

Las habilidades de salida tienen un script personalizado asignado, por lo tanto, cuando Runapp se activa en el script personalizado de salida, utiliza la acción Begin ya que esta ya "sabe" quién es el agente (el que realiza la llamada saliente). Por lo tanto, una pantalla emergente solo funcionará si se usa {__agentID} como nombre DE variable. En el caso de los scripts de entrada, el script no "sabe" quién es el agente hasta que se activa Onanswer, lo cual establece la variable de id de agente en AGENTID.

Puede usar el editor de la propiedad RunApp para configurar esta propiedad haciendo doble clic en la acción.

Tipo DE acción

  • RunExe: NiCE CXone no es compatible. Esto requiere un ejecutable local que reside en la ruta de Windows o con la ruta completa ingresada en el campo ActionValue. La ruta del archivo debe incluir barras diagonales inversas dobles (\\) en la ruta. Por ejemplo, C:\\Archivos de programa\\NiCE CXone\\studio.exe. La mayoría de los navegadores modernos no admiten la ejecución de programas ejecutables. Si desea utilizar este tipo, asegúrese de que sus agentes usen un navegador compatible.
  • OpenURL: abre un navegador web predeterminado en la URL especificada en el campo ActionValue.
  • ShowCustomForm: Inicia un formulario HTML personalizado creado en Studio. Los datos capturados del formulario personalizado activarán el ONDATA evento en el script.

Puede usar el editor propiedad RunApp para configurar esta propiedad haciendo doble clic en la acción.

Valor de acción

El valor que requiere el tipo DE acción especificado. Las variables se admiten en esta propiedad por encapsular la variable en {llaves}.

  • RunExe: El nombre o la ruta de un archivo ejecutable de Windows. La ruta del archivo debe incluir barras diagonales inversas dobles (\\) en la ruta. Por ejemplo, C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}.
  • OpenURL: Debe ser un nombre de dominio completamente calificado y una URL. Se admiten parámetros de cadena de consulta. Por ejemplo, http://www.ejemplo.com/file.asp?ANI={ANI}. También puede personalizar el título de la pestaña que aparece en la Intefaz de MAX agregando el parámetro icAgentPanelTitle= a la URL. Este parámetro no se admite en 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.

    Cada campo de entrada debe contener un nombre. Los Campos sin nombre serán ignorados. Ejemplo, <input type="text" name="phone">.

    El script debe contener una de estas cosas para que su formulario personalizado funcione:

    • Ondataacción: con esta acción, los nombres y los valores se devuelven al script como variables.
    • WaitForSubmit property: Cuando se incluye y se establece en True, los nombres de los campos se convierten en variables en el script. Los valores de campo se convierten en el contenido de las variables.

    Los campos de formulario que admiten valores múltiples, por ejemplo Casilla y Seleccione, contendrán una matriz separada por comas.

    Se pueden usar múltiples botones de envío con el mismo nombre o con nombres diferentes, pero cualquier botón de envío enviará los datos y cerrará la ventana. Si desea un botón que no envíe, entonces use un botón en vez de enviar.

    Las hojas de estilo vinculadas no SOn compatibles, puede usar estilos en línea. Por ejemplo, <div style="position: absolute: left: 10px: top: 100px:">.

    JavaScript funcionará cuando se vincule a un JavaScript externo, pero el contenido debe ser HTTPS para evitar errores. Por ejemplo:

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

Puedes usar el editor de propiedades de RunApp para configurar esta propiedad haciendo doble clic en la acción.

Espere para enviar

Determina si el sistema esperará una acción de envío por parte del agente. Cuando se establece en True, el sistema espera la acción de envío del agente. Los nombres de campos se convierten en variables en el script, con el valor del Campo como el valor de la variable. Cuando se establece en False, debe incluir la acción Ondata en el script, que devuelve los nombres y valores de los campos al script como variables.

WaitForSubmit solo es aplicable si el Tipo DE acción es ShowCustomForm. Funciona en conjunto con WaitTimeout.

Deshabilite esta propiedad cuando use esta acción en un script que integre un CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. con una aplicación NiCE CXone Agent Workspace (Agent). Cuando esta propiedad está habilitada, el formulario quede en blanco al enviarse si el formulario ha superado el tiempo DE espera.

En modo Valor: Haga clic en Encendido para habilitar. Deje la configuración en Nula para devolver los valores de campo al script con la acción OnData.

En Modo Expresión: Ingrese verdadero para habilitar. Deje la opción establecida en false para devolver los valores de campo al script con la acción OnData.

Tiempo límite de espera

El número de segundos que activará la rama OnTimeout si el Tipo DE acción es ShowCustomForm.

Condiciones de la rama de resultado

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

Condición

Descripción

Por defecto

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.
Enviar Path taken if WaitForSubmit is set to True.
Tiempo límite 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.