Variables de entrada y salida de script

Las variables de cadena, numéricas y booleanas tienen Aporte y Producción propiedades. Cuando una variable Aporte la propiedad es sí, su valor puede ser establecido por una fuente de datos externa. Cuando una variable Producción la propiedad es sí, su valor se guarda en el objeto de conversación y se puede recuperar mediante programación después de que finalice la llamada. Estas propiedades no son mutuamente excluyentes. Se puede habilitar uno o ambos para una variable.

Las variables con estas propiedades habilitadas se denominan variables de entrada, variables de salida o ambas. He aquí cómo entender esos términos:

Una variable es una variable de entrada si su propiedad Input es Yes. Su valor puede ser entrada de una fuente externa, como un flujo de llamadas de Architect.
Una variable cuya propiedad de salida es Sí es una variable de salida. Cuando se ejecuta el script, cualquier valor asignado a la variable se guarda para su uso fuera del script. Su valor es salida a almacenamiento externo cuando se ejecuta el script.
Dado que ambas propiedades pueden tener el valor de Sí, una variable puede ser tanto de entrada como de salida.
Una variable de lista cuando se utiliza como entrada tendrá el valor de la conversación dividido por comas.
Una variable de Lista cuando se utiliza como salida tendrá su lista unida por coma en la conversación.

No puede utilizar variables dinámicas como variables de entrada o salida.

Para las nuevas variables, tanto la entrada como la salida están por defecto en no. Si tiene scripts existentes que usan variables, entonces Genesys Cloud establece la entrada y salida en sí para esas variables para que los scripts sean compatibles con versiones anteriores.

Propiedad de salida

los Producción permite almacenar el valor de una variable de secuencia de comandos para su uso después de que finaliza una llamada, sin tener que configurar una acción de datos o agregar columnas suplementarias a una lista de contactos. Cuando Salida se establece en Sí, el valor de esta variable de secuencia de comandos se escribe en el objeto de conversación. Su valor guardado puede recuperarse mediante programación mediante un proceso externo del cliente. Para usar una variable como variable de salida, habilite Producción. Cuando el valor de esta variable cambia durante la ejecución de un script, el objeto de conversación se actualiza en 3 segundos.

Pares clave / valor en el objeto de conversación

Las variables se escriben en el objeto de conversación como pares clave / valor. Puede recuperarlos utilizando las API de la plataforma Puntos finales de conversaciones. Consulta el objeto de atributos de participante de la conversación utilizando el nombre de la variable como clave:

"participants": [
  {
    "attributes": {
      "scripterOutputVariable1": "value",
      "scripterOutputVariable2": "value"
    },
],

Si la variable solo es de salida, Genesys Cloud aplica el valor de esa variable al agente participante a menos que vea esos datos variables en otro participante; en ese caso, para mantener los datos sincronizados, Genesys Cloud actualiza al otro participante.
Si la variable es tanto de entrada como de salida, entonces el script adjunta los datos al participante en el que encontró los datos, que en la mayoría de los casos es el participante del cliente. De lo contrario, la ubicación predeterminada es el agente participante.

Por ejemplo, si los vienen los datos de Arquitecto mediante una variable de entrada, luego El arquitecto coloca el datos variables sobre los participante del cliente, y actualizaciones futuras para ese anulación variable los valor sobre los participante del cliente.

Nota: Genesys Cloud agrega variables de salida a v2 / conversations, no v2 / analytics / conversations.

Acciones de datos vs. Variables de salida

El método de acción de datos externos para guardar datos de scripts es apropiado para clientes que necesitan generar información compleja y luego enrutarla a través de procedimientos almacenados a una base de datos. La propiedad Output proporciona una forma más sencilla de guardar los datos recopilados en un script.

Cuando Salida se establece en Sí, las variables de cadena, numéricas o booleanas se escriben en el punto final de las conversaciones de la API pública como pares clave / valor que se pueden buscar, extraer y correlacionar fácilmente.
Las variables dinámicas y de objeto no se pueden almacenar mediante este proceso. Para guardar datos de objetos complejos o variables dinámicas, utilice una acción de datos en su lugar.

Propiedad de entrada

los Aporte propiedad indica si esta variable El valor puede ser establecido por una fuente externa, como un flujo de llamadas de Architect. Establezca Entrada en Sí para cualquier variable para la que desee recibir datos entrantes. Cuando Input se establece en No, la variable no aceptará valores externos, incluso si la fuente externa envía un valor. Para usar una variable como variable de entrada, habilite Aporte.

Datos protegidos del cliente

Ajustes de conversación de salida para Obtener datos seguros y Establecer datos seguros

Cuando el Producción opción para la variable está habilitada, el valor de esta variable de secuencia de comandos se escribe en el objeto de conversación. El cliente puede recuperar mediante programación el valor de la variable para permitir que se generen datos confidenciales durante las interacciones con el cliente. Asegúrese de deshabilitar el Producción opción para la variable para que los datos ingresados en esta variable no se utilicen de manera insegura durante las interacciones con el cliente. Para más información, ver Acciones de script disponibles. Él Obtenga datos seguros y Establecer datos seguros de El Datos protegidos del cliente La función es la forma correcta de consultar y actualizar los datos confidenciales del cliente. Para más información, ver Obtener acción de datos protegidos y Establecer acción de datos protegidos.