Cómo utilizar variables en Atmosphere® SmartFlows

Las variables son una herramienta muy poderosa en SmartFlows y pueden utilizarse para varios propósitos. Una variable es un marcador de posición para información, con un nombre. Se puede utilizar para personalizar mensajería, construir la lógica del negocio en los flujos, o enviar datos a sistemas externos o analíticos.

 

La mayoría de las acciones tienen una sección en la navegación de la derecha llamada ‘Available Variables’. Esta sección enumerará las variables que pueden utilizarse en esa acción. Cuando se invoca una variable en el transcurso de un flujo en ejecución, se sustituirá por el valor que contenga en ese momento. A continuación, varios ejemplos:

 

  • Cuando una persona llama a un número de teléfono con un activador de llamada entrante, su número de teléfono se almacena en una variable llamada $ANI. Utilice la variable $ANI para enviar un SMS de seguimiento a la persona que llama después de que finalice la llamada.
  • Cuando alguien envía un mensaje de texto a un flujo de SMS entrante, el mensaje se almacena en una variable como esta: $ISMS_1.message. Utilice esta variable como ‘Text Feed’ en la acción Sentiment para analizar si el mensaje contiene un sentimiento positivo o negativo.
  • Añada variables al cuerpo de una solicitud Post en la llamada Web externa para enviar la información que contenga a otro sistema; utilícelas para construir una URL en una solicitud GET para retornar información específica sobre un registro en particular (por ejemplo, encontrar el saldo de la cuenta del cliente basado en el $ANI).


 

Variables a nivel de sistema

SmartFlows ofrece algunas variables listas para usar en cualquier flujo, como $DateTime.currentDateText, que suministra el flujo con la fecha actual en forma de texto para poder enviarse a otros sistemas o leerse en funciones de texto a voz.

 

*Nota: Las variables específicas de fecha y hora se pueden personalizar para una zona horaria específica, al asegurarse de que la zona horaria deseada esté configurada para el flujo en la sección Flow Configuration (haga clic en cualquier lugar del lienzo para abrirla).

 


Dónde encontrar variables
Variables de arrastrar y soltar en la sección Available Variables

La mayoría de las veces, las variables aparecerán en la sección Available Variables del panel de configuración de una acción, para soltarlas en campos de entrada o mensajes de formato libre.

 

 
Desplegables de variables

En algunos casos, las variables no se arrastran y sueltan, sino que deben seleccionarse en un menú desplegable. Este será el caso para las acciones Switch y Condition.

 


Configuración de variables

Existen varias áreas en SmartFlows que permiten o requieren que los usuarios configuren sus propias variables. Al configurar las variables, recuerde tener en cuenta estas restricciones:

 

  • No puede haber espacios
  • No puede haber guiones bajos
  • Sensible a mayúsculas y minúsculas
  • Si la variable se actualiza, deberá actualizarse manualmente en cualquier otro lugar que se utilice en el flujo; los cambios en los nombres de las variables no se propagan automáticamente.

Acción Set Variable

La acción ‘Set’ ofrece a los usuarios la posibilidad de crear sus propias variables personalizadas o renombrar variables existentes.

 

 

Esto puede aprovecharse de distintas formas:

 

  • Cree una variable ’store address’ para no tener que escribir de nuevo el mismo valor en múltiples áreas de texto a voz
  • Renombre $DateTime.currentDateText a $date para evitar reescribir
  • Para los controles de texto a voz, tales como ‘breathiness’ o ‘pace’, establezca las etiquetas como variables para que puedan controlarse a través de todos los TTS en el flujo desde un mismo lugar, para obtener un sonido de voz consistente.

Configuración de variables en la llamada web externa

También hay otras áreas de la aplicación donde los usuarios deben crear variables. Un ejemplo de esto es cuando se utiliza el tipo de solicitud GET en la llamada web externa, que está diseñada para recuperar información de una fuente externa. La sección ‘Response variables’ solicita al usuario que almacene la información recuperada en una variable. El siguiente diagrama muestra que la expresión de consulta (cuadro de entrada a la derecha) es el texto JSON escrito para trabajar con el sistema externo; el nombre de la nueva variable va a la izquierda.

 


Configuración de variables en la API de entrada

La API de entrada también puede configurarse para aceptar entradas de una fuente externa y almacenarlas en variables que pueden utilizarse en otras partes del flujo. Para hacer esto, la solicitud POST que entre a SmartFlows debe incluir el ID de flujo para el flujo que está siendo llamado por la API (que se encuentra en la sección Flow Configuration) y los valores requeridos en el formato seleccionado (JSON o XML). Además, la API de entrada requiere actualmente un valor para un ANI y un DNIS en la solicitud, aunque no es necesario utilizarlos en el flujo.

 

Cualquier valor necesario en el flujo debe configurarse en la sección Expected Input de la API de entrada, tal y como se muestra en el diagrama siguiente (FIRSTNAME, LASTNAME, PHONE, BIRTHDAY).

 

 
Configuración de variables en las acciones Jump To y Jump From

Las variables de un flujo fuente (un flujo que contiene una acción Jump To) pueden pasarse a un flujo de destino (un flujo que contiene una acción Jump From, conectado a un flujo fuente). Deben configurarse explícitamente en la sección ‘Send Variables’ del flujo fuente (a), y también deben configurarse explícitamente como ‘Expected Variables’ en la acción Jump From en el flujo de destino (b).

a.

b.