WORKFLOW EXECUTE

Triggers a CRM sistemas de Terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. workflow when triggered by an agent in a NiCE CXone Agent Workspace (Agent)application. Workflows include things such as displaying data about a contact or creating a ticket. Other actions used in the script send the results and relevant data to the agent application when the agent answers the call. The other actions also pass any necessary information back to the CRM when the call completes. You can define a music file or other audio sequence to play for the contact while the script executes the workflow.

Dependencias

• Before you can configure this action, you must set up a CRM sistemas de Terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. configuration in Agent Integrations in NiCE CXone. You can integrate CRMs with Agent Workspace (Agent), Agent Workspace (Embedded) (Agent Embedded), Agent Workspace for Microsoft Teams (Agent for Microsoft Teams), and Agent Workspace (Browser Extension) (Agent Integrated).
• You must use a separate Workflow Execute action for each workflow you want to use in your script. You can include more than one Workflow Execute action in your script.
• To use the configuration wizard in this action, you must be logged in to NiCE CXone or log in to Studio using the Login button with your NiCE CXone user name and password. If you log in with the Login with Session ID button when you are not logged in to NiCE CXone, the wizard will not appear. This is because access to the wizard depends on Global Authentication, which is only used when you log in with your NiCE CXone user name and password.
• This action must be used with the Agent Workflow Configuration action. It can only be used in CRM integration scripts.

Tipos de scripts compatibles

Phone	Digital

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.
Configuration Id	El ID de configuración del CRM que usted usa. Se completa automáticamente el campo gracias al asistente de configuración de la acción. Si utiliza una variable en este campo, formatéela con llaves ( { } ). Por ejemplo, {integrationConfigId}.
Workflow Id	El ID del flujo de trabajo que maneja esta acción. Se completa automáticamente el campo gracias al asistente de configuración de la acción. Si utiliza una variable en este campo, formatéela con llaves ( { } ). Por ejemplo, {searchWorkflowId}.
Workflow Payload	Ingrese el nombre de la variable que contiene la carga útil del flujo de trabajo que gestiona esta acción. Esto se declara en la última línea de la carga útil SNIPPET anterior. Formatee el nombre con llaves ( { } ). La carga útil se debe convertir a JSON. En los scripts de plantilla de integración de CRM, este campo se establece en {searchJson} porque Snippet for Search Workflow Snippet declara la variable searchJson con el valor {searchInput.asjson()}.
Sequence	Defina el indicador que reproduce la acción. Un mensaje puede ser un archivo de audio WAV pregrabado o texto a voz Permite a los usuarios ingresar avisos grabados como texto y utilizar una voz generada por computadora para reproducir el contenido. (TTS). Si el aviso es un archivo de audio, ingrese el nombre del archivo entre comillas dobles. Por ejemplo, "saludo.wav". Si el archivo de audio se ubica en una carpeta diferente, incluir la ruta al archivo. Por ejemplo, si el script está en la carpeta raíz y el archivo de audio está en una subcarpeta dos niveles abajo, ingrese "Subfolder\Subfolder2\Audio-file.wav". Si el script está en una subcarpeta un nivel debajo de la raiz y el archivo de audio está en una subcarpeta diferente del mismo nivel, ingresar “\..\Subfolder\Audio-file.wav". Si el mensaje es de texto a voz, ingrese el texto que desea que lea el servicio TTS Permite a los usuarios ingresar avisos grabados como texto y utilizar una voz generada por computadora para reproducir el contenido.. Cada segmento debe estar encerrado entre comillas dobles e incluir un carácter de referencia de cadena para identificar el tipo de información que es. Por ejemplo: "%El saldo de su cuenta es""silencio.wav""${saldo de cuenta}" Para obtener más información sobre el formato de los mensajes en esta propiedad, incluidos los caracteres de prefijo de referencia de cadena a utilizar, consulte la página Mensajes. Algunas acciones con la propiedad Secuencia tienen acceso al editor de secuencia, que es una interfaz gráfica que puede utilizar para crear indicaciones. Esta acción no accede a este editor. Sin embargo, puedes utilizar el editor de secuencia desde una acción que lo admita, como Play. Añade Play a tu guión y crea tu secuencia de indicaciones. Pegue el texto de secuencia del campo Secuencia en Play en esta acción y luego elimine Play. Nota: La duración del mensaje en esta propiedad debe ser de 60 segundos o más. Esto ayuda a evitar que el contacto escuche un sonido muerto si la secuencia finaliza pero el flujo de trabajo no ha terminado de ejecutarse. Es posible que el flujo de trabajo no tarde tanto en ejecutarse, pero pueden producirse demoras. Reproducir un aviso es opcional para esta acción.
Phrase	Utilice esta propiedad para documentar el texto que contiene el aviso. El script no usa el texto en esta propiedad. Debido a que algunas indicaciones pueden ser complejas y contener múltiples segmentos, puede ser útil incluir el texto completo escrito sin el formato requerido por la propiedad Secuencia.
ActionType	Los flujos de trabajo para el tipo de acción seleccionada en el asistente WORKFLOW EXECUTE.
Dynamic Data Mapping ID	The ID of the dynamic data mapping to display in the customer card when this workflow is executed.

Propiedades de salida

Estas propiedades contienen variables que incluyen datos que se evuelven al ejecutar la acción. Están disponibles como referencia y para usarse cuando se completa la acción.

Condición	Descripción
errorArgs	Ingrese el nombre de la variable donde contener información sobre el error. La variable predeterminada es workflowErrorOutput. No es necesario colocar el nombre de la variable entre llaves.
resultSet	Ingrese el nombre de la variable que desea que contenga resultado del flujo de trabajo específico. La variable predeterminada es workflowResultOutput. Este campo no requiere llaves.
cacheKey	La variable que almacena los resultados de la búsqueda. Los resultados se almacenan en ElastiCache.

Condiciones de la rama de resultados

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.
Success	Ruta que se toma si la acción finaliza sin errores y cualquier llamada API o devolución de datos se realiza correctamente (códigos de respuesta 2xx).
Timeout	La ruta que se toma cuando la ejecución del flujo de trabajo supera el valor de tiempo límite especificado en la entrada.
ValidationError	La ruta que se toma cuando no es posible validar cualquier entrada. Esto incluye: ID de configuración: Debe ser un ID de configuración válido de la página Integraciones de Agentes > Configuraciones en NiCE CXone. ID de flujo de trabajo: Debe ser un ID de flujo de trabajo válido de la página Integraciones de Agentes > Configuraciones en NiCE CXone. Carga útil del flujo de trabajo: Debe ser una cadena JSON válida.
InvalidWorkflow	La ruta que se toma cuando el flujo de trabajo especificado no es válido.
InternalError	La ruta por seguir cuando la acción encuentra un error.
NotConfigured	The path taken if Agent Integrations are not enabled for your tenant Agrupación organizativa de alto nivel utilizada para administrar el soporte técnico, la facturación y la configuración global de su sistema NiCE CXone.. Contact your account representative to have the feature enabled.

Se requiere de código de acción para el SNIPPET

Esta acción necesita acciones Snippet con un código personalizado. La información sobre los snippets necesarios se encuentra disponible en la página de ayuda en línea sobre integrar su CRM con una aplicación Agent Workspace (Agent).

Seleccionar Acciones y Flujos de trabajo

1. Select the Workflow Execute action in your script and click Open Editor in the action's properties.

   View image

   
2. Select the Custom CRM Configuration you want this Workflow Execute action to use. If the drop-down list is empty, you must set up a configuration before continuing. You must choose the same configuration in both the Agent Workflow Configuration and Workflow Execute actions in this script.

3. Select one or more Actions that you want agents to be able to perform when this script runs.

   Learn more about action types

   Field Value	Details
   Select All	Select all three actions, described below.
   Create Timeline	Agents can add timeline information to the Activities section of the customer card.
   Data Memorialization	Agents can add data from the selected record in the Activities section of the customer card to the record of the current contact. You determine the data that can be added by mapping it for this CRM in the Agent Integrations page in NiCE CXone. See the CRM integration steps for your organization's CRM and the agent application you use.
   Search	Agents can perform a second-level search. After performing an initial search, they can search again to reveal more information about the initial search results. The Search must be selected to have any search records displayed in the Customer Card.

4. In the Workflow Mapping section, select the workflows that you want to assign to the Actions you selected. You can only select one workflow per action. The Action column shows which action each workflow option corresponds to.

   The following example image shows the workflows available for ServiceNow. If you use a different CRM, the options will be different.

   View image

   
5. If you want to change a workflow mapping, clear the first selection before choosing a new workflow. If you want to remove all selected mappings, select the checkbox in the column header.
6. Click Next.
7. Verify your selections on the Custom CRM Configurations Updated window. If you need to change a selection, close the window and make your change.
8. Click Save on the Custom CRM Configurations Updated window to apply your selections to the Workflow Execute properties.

Ejemplo de secuencia de comandos

El siguiente ejemplo muestra la acción Workflow Execute que se utiliza para integrar una aplicación CRM sistemas de Terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. con Agent Workspace (Agent), Agent Workspace (Embedded) (Agent Embedded)o Agent Workspace (Browser Extension) (Agent Integrated). Puede encontrar más información sobre el uso de la acción, que incluye descargar un script de muestra, en la página de ayuda sobre el proceso de integración.