SNIPPET

Le permite agregar código personalizado a su script.

Las Dependencias

• Code used in this action must be written in Snippet, an in-house scripting language developed for NiCE CXone. The Studio technical reference guide provides detailed information about scripting in snippets.
• Attributes of dynamic data objects cannot be named __type (with two underscores). This word is reserved for use when parsing JSON from dynamic objects.
• You can make API calls using the Snippet action. However, this is not the recommended method of making API calls in your scripts. If you do make them in this way, be sure to understand the risks and best practices.
• El tamaño máximo de las matrices en Studio es de 63 millones de elementos. Exceder este tamaño de matriz genera el siguiente error en la variable __err en un seguimiento de script: Índice de matriz fuera de límites. El índice de la matriz actual ([índice]) excede el índice máximo permitido (63000000). When the array size is exceeded, the script takes the SNIPPET action's Error branch. If the Error branch is not connected, the script continues to run, but without the array information. You can configure scripts to notify you when the maximum array size has been exceeded by adding an EMAIL action to the SNIPPET action's Error branch. Finally, you can add logic in the Error branch to continue to the script. Note that it will continue without the array information.

• The maximum response size in NiCE CXone is 32 KB. The limit is strictly enforced to prevent cluster instability and outages. Studio enforces this limit when saving the script, but Desktop Studio does not. If you can, use the REST API action or Integration Hub instead of the SNIPPET action to make API calls. They have the same limit, but can handle a heavier load. If you must use the SNIPPET action, follow these tips to reduce the size of the returned data: 

  • Filter the data in the API response: For example, if you're using the NiCE reporting API to get contacts, you can filter the results by the startDate and endDate of the contact. This API call also allows you to return and limit a top count of items. Refer to the API documentation that came with your script integration to determine what filtering you can use.

  • Update the API request to return only the data you need: For example, if you're using the NiCE reporting API to get contacts, you can use the contactId or agentId fields to return only relevant data. Refer to the API documentation that came with your script integration to determine what data limits you can use.

  • Build middleware: If you cannot do either of the previous options, build middleware that does filtering based on custom criteria you define. If you do this, ensure that your middleware does not add latency to the call.

• Every FOR, FOREACH, or REPEAT loop within a SNIPPET is protected by a 500 ms time limit. If a loop exceeds this limit, the SNIPPET action takes the error branch with the error Too much time has elapsed. This prevents the use of excessive system resources for runaway loops. The 500 ms time limit applies only to script-side work, including assignments, arithmetic, conditions, array access, and so on. It does not apply to the end-to-end running of the snippet code. For example, time spent waiting for an external system such as a REST API or database call does not count against this limit.

Tipos de secuencias de comandos compatibles

Generic	Email	Chat	Phone	Voicemail	Work Item	SMS	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.
Datos	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.
Tamaño máximo de cadena	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.

Condiciones de rama de Resultado

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

Consejos y trucos

• Utilice la función asjson() en una Snippet acción y almacene el JSON resultante en una variable de cadena. Utilice la variable de cadena en las propiedades de otras Studio acciones cuando necesite pasar los datos JSON. Este enfoque evita la posibilidad de errores de validación al guardar el script.
• If you're tuning an ASR Reconocimiento automático de Voz. Permite a los contactos responder a los avisos hablando, presionando teclas del teléfono o ambas opciones.-enabled IVR Respuesta de voz interactiva. menú telefónico automatizado que los contactos utilizan mediante voz o entradas de teclado para obtener información, enrutar una llamada de voz entrante, o ambas cosas. system, there is a set of parameters you can use in snippets.
• The Snippet language provides keyword commands that allow you to declare variables and objects, create loops and iterative statements, and more.
• Studio has built-in functions that you can use in your scripts.
• You can create your own custom functions to use in snippets.
• To add a comment to your code, type two forward slashes (//). You can click the speech bubble to automatically insert the forward slashes at the beginning of the row. Select multiple rows to convert them all to comments. Click the speech bubble again to remove the forward slashes. You can also use keyboard shortcuts to toggle comments on and off (CTRL + /).
• Click the bug on the side of the Snippet editor window to test and debug your code.
• Use the test system variable when debugging snippets. It allows you to set the value for variables that are used in the snippet and would be populated by the script when it runs for a contact La persona que interactúa con un agente, IVR o bot en su centro de contacto..

Ventana del Editor de Snippet

La ventana del editor de Snippet se abre cuando selecciona una acción Snippet y hace clic en Abrir editor en las propiedades de la acción. También puede hacer clic en la ventana en medio de la acción cuando esta se encuentra en el lienzo del script.

Ejemplo de Script

En este ejemplo simple, las acciones Snippet contienen declaraciones de objetos de datos dinámicos y otras variables utilizadas en el script. El Snippet con el título Analizar la transcripción contiene código que verifica si la transcripción corresponde a un mensaje de voz. Si es un mensaje de voz, el script copia el cuerpo del mensaje de la transcripción a una variable. La variable que contiene el cuerpo del mensaje se pasa a la acción PLAY, que lee el mensaje mediante texto a voz Permite a los usuarios ingresar avisos grabados como texto y utilizar una voz generada por computadora para reproducir el contenido..

Descargue este script.