Personalización del widget de secuencia de comandos en la aplicación de zoom

Los administradores del centro de contactos pueden agregar y editar el widget Script. Este widget de secuencia de comandos le permite crear un flujo enviando las acciones deseadas al propio widget, lo que elimina la necesidad de confiar en la interfaz de usuario al crear un flujo. De forma predeterminada, los widgets de Script ocultan claves, secretos y otras credenciales asociadas con ellos.

Importante:

• Zoom Contact Center anunció que lanzará un nuevo motor de secuencias de comandos el 17 de septiembre de 2022 que presenta un nuevo sintaxis para scripts. No habrá impacto en los scripts existentes como resultado de este cambio. Sin embargo, hay algunas reglas que se deben seguir al desarrollar nuevo widgets de secuencias de comandos. Este artículo incluye ejemplos de nuevo sintaxis del script en la sección Nueva versión.

• Las siguientes configuraciones de ejemplo lo ayudarán a comprender mejor cómo utilizar el widget Script.

Requisitos previos para personalizar el widget Script

• Propiedad o privilegios administrativos de la cuenta

• Ya sea que sea titular de una cuenta Business, Education o Pro

• Se requiere una licencia para Zoom Contact Center

• Cree flujos de voz, video, web, en la aplicación o SMS según sus preferencias

• Se requiere una comprensión avanzada de Javascript

Cómo agregar o editar el widget de Script

1. Se puede acceder al portal web de Zoom iniciando sesión.

2. Haga clic en Administración del centro de contacto en el menú de navegación y luego haga clic en Flujos en la lista desplegable.

3. El nombre para mostrar de un flujo se puede editar haciendo clic en él.

4. El script se puede arrastrar a la ubicación preferida en el flujo haciendo clic y arrastrando el widget en el panel de widgets del lado izquierdo.

5. Deberá seleccionar el widget llamado Script.

6. Se puede cambiar el nombre del widget para que sea más comprensible para el usuario final. Haga clic en Renombrar para hacer su cambiar.

7. Se puede agregar una nueva secuencia de comandos a un widget haciendo clic en el botón Agregar secuencia de comandos y luego especificando las siguientes opciones:

8. Haga clic en el botón Agregar.

9. Si está utilizando JavaScript, ingrese el código a continuación.

10. El panel Parámetros de entrada se puede usar para ingresar parámetros para el script en formato JSON en el lado derecho de la pantalla. Esto se usa para probar el script localmente. Los pares clave/valor deben incluirse de acuerdo con el código JavaScript, así que asegúrese de incluirlos. El parámetro de entrada que deberá proporcionar debe contener todos los pares clave/valor que espera ver al probar su código localmente.

11. Haga clic en el botón Ejecutar.
    En la sección Resultados, podrá ver los resultados.

12. Cierre la ventana haciendo clic en ella.

13. Para guardar el script, haga clic en el botón Guardar.

14. Haga clic en las siguientes opciones en la pestaña Configuración (opcional):

15. Puede personalizar su configuración de salida haciendo clic en el salidas pestaña.

    • Éxito: en caso de que el script se haya ejecutado correctamente, seleccione el widget de destino.

    • Fallar: cuando el script no se ejecuta, seleccione el widget que debería ser el destino

Nota: vea configuraciones de ejemplo del widget de secuencia de comandos para comprender mejor cómo funciona.

Asignación de variables de script

Es posible asignar un valor de variable de secuencia de comandos a una variable de flujo después de configurar el widget de secuencia de comandos y ejecutarlo.

• En el script var_set(), todas las variables se establecen en una variable de flujo llamada widget que luego se asocia con el script var_set(). Es posible considerar esta variable como una variable local.

• Hay una variable de flujo llamada valor debajo del nombre del widget que contiene el valor devuelto por el script cuando se invoca el widget.

• Global Las variables personalizadas deben definirse para todas las variables establecidas por global_var_set para poder usarse en variables globales. Es posible hacer referencia al nombre completo de la variable global en el widget de Script, así como modificarlo usando global_var_set en el widget de Script.

Ejemplo de asignación de secuencias de comandos

Para obtener más información sobre los números de cuenta, consulte el siguiente ejemplo.

Cómo programar guiones

1. Su código debe contener todas las dependencias que necesita. Puede ver el código de ejemplo a continuación en Líneas 2 a 4.

2. Para que el motor de código pueda extraer su función JS, pase su función a module.exports. Async solo debe usarse cuando se requiere await en su función. No es necesario llamar a la función desde el panel de código, por lo que no es necesario llamarla allí.
   Nota: Se enciende un interruptor automático para habilitar el modo estricto.

Ejemplo de programación de scripts

Nueva versión

async function main () {
  // your code starts here
}

Note: 
#### Supported built-in functions: (no need to import again)

## Variable Get/Set:
var_get()(string); var_set(string, string); global_var_set(string, string)

## Http Requests:
req.get(url(, config)); req.delete(url(, config)); req.head(url(, config)); req.options(url(, config))
req.post(url(, data(, config))); req.put(url(, data(, config))); req.patch(url(, data(, config)))

## Logging
log.debug(string), log.info(string), log.warn(string), log.error(string)

Versión antigua

// Using Lambda

const log = require('./utils/log');
const req = require('axios'); // this is needed only if you plan to use Axios in your function
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

module.exports = async () => {

// add your script logic. See two examples above.

return
}

Nota: El widget Javascript Script actualmente solo proporciona acceso al módulo externo de Axios, que es el único disponible en este momento.

Cómo utilizar el registro

Mediante el uso de la siguiente función, podrá importar la dependencia:

constante registro = require(‘./utils/log’);

Nota: Hay un nuevo versión del motor de secuencias de comandos que ya incluye esto, por lo que no necesita importarlo nuevamente ya que está integrado

Ejemplo de registro

Las siguientes funciones se pueden utilizar para implementar el registro en su aplicación:

log.debug(“depurando activado”) log.error(“error detectado”) log.info(“información: sí”) log.warn(“ADVERTENCIAS: “)

Cómo implementar solicitudes HTTP

Las solicitudes HTTP se pueden implementar mediante Axios mediante la biblioteca de solicitudes HTTP. Puede encontrar más información sobre Axios Support en el sitio web de la empresa.

Mediante el uso de la siguiente función, podrá importar la dependencia:

const req = require('axios');

Nota:

• No tiene que volver a importarlo porque esto ya está integrado en el nuevo versión del motor de secuencias de comandos.

• El widget de llamada HTTP es un widget estándar que le permite realizar solicitudes HTTP con la ayuda de funciones de JavaScript sin tener que escribir JavaScript. Para casos de uso más avanzados, puede usar el módulo Axios junto con un script que también ejecuta solicitudes HTTP.

Cómo obtener variables dentro del widget Script

1. Su flujo debe incluir un widget de script que pueda agregar y configurar.

2. La importación de dependencia variable debe agregarse al archivo JavaScript.

   Ejemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set}
      = require('./utils/variable');

Nota: No es necesario volver a importarlo porque ya está integrado en el nuevo versión del motor de secuencias de comandos.

1. Para saber cuál es el valor de una variable, puedesetLa función var_get. Se puede acceder tanto a las variables locales del widget como a las variables globales mediante la función var_get. Además de las variables del sistema definidas globalmente, debe definir sus propias variables globales antes de poder usarlas.
   Ejemplo:

var_get()("global_system.Consumer.firstName")

Nota: VaLos riables dentro de los flujos tienen un alcance limitado al compromiso activo, aunque las variables globales se definen globalmente en el sistema. A el valor de la variable global es spespecficamente establecido fo un compromiso específico cuando se establece/cambia dentro de un flujo. El valor de la variable global actualizado setuberculosisy otro compromiso no estará disponible para otros consumidores simultáneamente o posteriormente en el mismo flujo.

Cómo establecer variables locales dentro del widget Script

1. Agregue el widget Script a su flujo y configúrelo. El widget de secuencia de comandos debe cambiarse de nombre a Script1 en este ejemplo.

2. La dependencia de la variable debe importarse a un archivo JavaScript. Es necesario agregar la importación de dependencia.
   Ejemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Nota:No hay necesidad de importar esto nuevamente ya que está construido en el nuevo versión del motor de secuencias de comandos.

1. Establece el valor de una variable local usando la función var_set. Las variables locales se nombran usando sus nombres completos y sus valores se identifican por sus valores.

   Ejemplo:

var_set("account_number", “99999")

Dentro de este flujo, se puede acceder a Script1.account_number como el valor de esta variable

Cómo establecer variables globales dentro del widget Script

1. El widget de script debe agregarse y configurarse en su flujo.

2. La importación de dependencia variable debe agregarse a un archivo JavaScript.
   Ejemplo:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Nota: No es necesario volver a importarlo, ya que está integrado en el nuevo versión del motor de secuencias de comandos

1. Establezca el valor de una variable global mediante la función global_var_set. El nombre completo de una variable global es el primer parámetro y el valor es el segundo.
   Ejemplo:

global_var_set("global_system.Consumer.firstName", "Your Name")

Nota: Los flujos tienen un alcance limitado, mientras que las variables globales se pueden definir globalmente en el sistema.