Scripts de creación

Crear un script te permite ejecutar un script manualmente. También se usa para iniciar un script a partir de otros scripts o procesos externos. También puede usarlo para probar un script. Al hacer pruebas, se puede usar junto con rastreos de scripts.

Para probar scripts, puede generar scripts desde Studio usando la opción de seguimiento.

Para iniciar scripts desde otros scripts o procesos.

  • Use la acción SPAWN en el script que hace la llamada.
  • Usando la API POST /scripts/start Un ícono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha.. Esta es la solución recomendada para crear un script desde cualquier proceso externo.

Las Unidades de negocios pueden ejecutar un máximo de 15.000 scripts, a menos que se configure lo contrario. Cuando se alcanza ese límite, no se pueden iniciar ni generar scripts adicionales utilizando ninguno de los métodos descritos en esta página hasta que uno o más scripts dejen de ejecutarse.

Parámetros de script

Los parámetros del script permiten que los datos se transfieran a los scripts. Los datos podrían venir de otros scripts, lo que incluye scripts del sistema, o de fuentes externas como CRMCerrado Sistemas de terceros que administran cosas como contactos, información de ventas, detalles de soporte e historiales de casos. o API. Se transfiere a los scripts en las pXvariables, p1 a través de pN, donde N es el número máximo de parámetros respaldados por el método de creación. Puede especificar los datos a transferirse al script cuando crea un script usando cualquiera de las opciones que se listan en la sección previa.

Si quiere cambiar los nombres de las variables de los parámetros, puede configurar la acción Begin en el script creado con los nombres nuevos. Cuando el script procesa la acción BEGIN, se convierten las variables pX para los nombres nuevos. Si no especifica los nombres nuevos, las variables retienen los nombres de pX.

Cuando se transfiere a un script, puede verlo en un rastreo. Seleccione la opción BEGIN para ver las variables de los parámetros en la lista de variables de salida de rastreo. Si ha configurado la acción BEGIN con los nuevos nombres de variables, seleccione la acción que aparece después de BEGIN en el rastreo del script para verlos. Las variables de parámetro solo están presentes si contienen un valor.

Parámetros personalizados:

  • Soportar un máximo de: 
    • 32 KB por valor cuando se crea usando la acción SPAWN.
    • 32 KB en total para todos los parámetros, incluyendo las delimitadores, cuando los crea un API.
  • Soportar la sustitución de variables. Ingrese el nombre de variable entre llaves( { } ).
  • Admite entre 1 y 20 parámetros al generarse mediante la acción SPAWNo API.
  • No soportar los objectos de datos dinámicos. Los objetos deben convertirse primero a una cadena de caracteres JSON.

Comparación de las Acciones Studio

Hay tres acciones Studio que inician un nuevo script desde el script actual. Sin embargo, hay algunas diferencias entre ellas:

  • Ejecuciónscript: Cuando activa otro script, no retorna el primer script desde el segundo.
  • Runsub: Cuando activa un subscript, el script puede volver al primero, en tanto que el subscript tenga una acción . La acción devuelve un valor a la acción cuando finaliza el subscript.
  • SPAWN: Inicia un segundo script que se ejecuta en paralelo con el primero. Los scripts creados no pueden transferir datos al primer script a menos que incluya una acción en el script creado.

Crear desde otro script usando la acción SPAWN

Si no requiere pasar los valores de los parámetros al script heredado, todo lo que necesita hacer es añadir y configurar la acción SPAWN en el script principal. Si requiere transferir los parámetros, necesita hacer las siguientes configuraciones:

  • Haga los siguientes cambios en el script principal:
    • Coloque la acción SPAWN en el punto donde desee crear el script heredero. Configure la propiedad de Parámetros en la acción SPAWN con cualquier valor que necesite transferir al script heredero. Los valores se transfieren en las variables p1 a p9.
    • Configure las otras propiedades de la acción SPAWN.

  • Hacer los siguientes cambios en el script heredero:

    • Configurar la propiedad Parámetros en la acción para cambiar el nombre de las variables de los parámetros personalizados. De no hacer nada, los valores de los parámetros personalizados permanecen en las variables .
    • Si requiere transferir valores nuevamente al script principal o llamar a una aplicación, agregar y configurar una acción.

Crear un Script por API

Use la API POST /scripts/inicio Un ícono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para crear un script.

Al usar esta API, es importante notar que:

  • Se requieren los siguientes parámetros: 
    • skillId: El valor debe ser un entero al enviar como JSON, pero no si se envía como parámetros de consulta. Las habilidades deben:
        • Estar activo.
        • Coincidir el tipo de medio del script. Por ejemplo, los guiones telefónicos deben correlacionarse con las habilidades de llamadas telefónicas. Puede encontrar el tipo de habilidad en la pestaña Detalles de una habilidad. Scripts con el tipo de trabajo Generic con cualquier habilidad activa.

    • scriptId o scriptPath: Se recomienda usar scriptPath. El ID del script cambia cada vez que se guardan los cambios al script, por lo que debe actualizarse en el parámetro.

  • Puede incluir hasta 20 parámetros.
  • Se deben enviar los parámetros en una lista delimitada por plecas.
  • La API soporta un máximo de 32 KB para todos los parámetros, que incluye los delimitadores por plecas.
  • Los parámetros no pueden incluir los caracteres por plecas a menos que sean delimitadores.
  • Si se envía la solicitud como JSON, debe escaparse adecuadamente de los caracteres reservados.
  • Si envía la solicitud mediante parámetros de consulta de URL, deben codificarse con URL los parámetros.