SNIPPET

This help page is for Desktop Studio. This information is also available for CXone Studio.

Le permite agregar código personalizado a su script.

Dependencies

  • El código utilizado en esta acción se debe escribir en Snippet, un lenguaje interno de creación de guiones desarrollado por NICE CXone. La Studio guía de referencia técnica brinda información detallada sobre la programación de snippets.
  • No se pueden nombrar los atributos de los objetos de datos dinámicos __type (con dos guiones bajos). Esta palabra está reservada para su uso al analizar JSON de objetos dinámicos.
  • Puede hacer llamadas API usando la acción Snippet. El tamaño máximo de respuesta es 32 kB. Esto está en consonancia con el límite del tamaño de respuesta de la acción REST API.  Es estrictamente obligatorio el límite para evitar inestabilidad o interrupción del clúster. De ser posible, use mejor la REST API action. Tiene el mismo límite, pero puede manejar una carga mayor. Si ha de usar la acción SNIPPET , siga estos consejos para reducir el tamaño de los datos devueltos:
    • Filtre los datos en la respuesta de la API. Por ejemplo, si utiliza la API de generación de informes NICE para obtener contactos, puede filtrar los resultados por startDate y endDate el contacto. Esta llamada a la API también permite devolver y limitar el recuento máximo de elementos. Consulte la documentación de la API que acompaña a su integración de scripts para determinar qué filtros puede utilizar.

    • Actualice la solicitud de la API para que devuelva únicamente los datos que necesite. Por ejemplo, si está utilizando la API de generación de informes NICE para obtener contactos, puede utilizar los campos contactIdo agentId para devolver únicamente los datos relevantes. Consulte la documentación de la API que acompaña a su integración de scripts para determinar qué límites de datos puede utilizar.

    • Si no puede realizar ninguna de las opciones anteriores, cree un middleware.

Supported Script Types

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Genérico

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

Input Properties

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

Propiedad

Descripción

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. The default is the action name.

Data

Contiene el código personalizado que se agregó en la ventana Snippet Editor. Esto puede incluir varios comandos ASSIGN y DYNAMIC, declaraciones de control de flujo distintas y funciones integradas y definidas por el usuario.

MaxStringSize

Define el tamaño máximo de cadena para todos los comandos en la propiedad Data. Las opciones son: Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Se aplica este límite a las respuestas de integración con las Rest API y SOAP.

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.

OnError

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.

Tips & Tricks

Snippet Editor Window

The Snippet Editor window opens when you double-click on a Snippet action.

La ventana Snippet Editor en la acción Snippet tiene dos pestañas. Ambas pestañas le permiten crear los mismos tipos de código. Puede alternar entre pestañas y editar su código en cualquier lugar. Las pestañas son:

  • La pestaña Vista de Texto. Este es un campo de texto de formato libre donde puede escribir manualmente su código.
  • La pestaña Vista de Árbol. Esta es una interfaz gráfica que puede utilizar para crear su código. Esta pestaña tiene una lista desde la que puede seleccionar palabras clave para agregar declaraciones al snippet.

Script Example

Este ejemplo no es un script completo. Se requiere trabajo adicional en el script para usar esta acción.

In this simple example, the code in the Snippet is used to test whether a prospect can be created using information from a third-party system.

A script with two SNIPPET actions.

Download this script.