Aquí describiremos el comportamiento de cada actividad

BotStartActivity

Esta actividad es la primera del flujo, siempre debe estar incluida en todos los flujos creados, la misma indica al bot por dónde comienzan las actividades.

• name incluirá el nombre que poseerá el bot

• botTimeout es el tiempo en minutos que espera el bot sin recibir respuesta para terminar la interacción y darla por abandonada, por default son 30 minutos.

SendMessage

Con esta actividad interactuamos con el cliente, permite enviar un mensaje luego de cada vez que escribe el cliente.

Este campo puede funcionar de 3 formas:

Enviar un mensaje simple

• message
  Escribimos el mensaje que se desea enviar, cuando se ejecute la actividad enviará el texto de este campo.

Enviar opciones

• message
  Para enviar un menú de opciones, en este campo cada línea debe comenzar con número y guión (Ej: 1- o 1 -)

IsOnTime

Esta acción permite evaluar una respuesta y activar un recorrido u otro dependiendo el horario que le sea introducido.

• schedule
  El formato del horario debe ser
  mon,tue,wed,thu,fri,sat,sun;09:00-18:00

Ejemplo:
El cliente escribe al bot y selecciona para hablar con un agente.
Tras leer la respuesta, puede decidir enviarlo a una campaña u otra dependiendo del horario en que se encuentre.

Evaluate

Permite evaluar una respuesta y basándose en ella decidir por un camino u otro, los evaluate pueden encadenarse uno tras otro en caso de que tengamos multiples opciones y por cada una se realicen acciones diferentes.

• Área en blanco
  Aquí es donde introduce código Js para evaluar opciones.

ReadMessage

Con esta opción el bot leerá la respuesta enviada por el cliente para guardarla en una variable y así utilizarla en otras actividades.

• variable
  Nombre de la variable que poseerá la respuesta.

• timeout
  Tiempo de espera para continuar el flujo, si se excede este tiempo el contenido de la variable será:
  ““.

ReadFileMessage

Esta opción es similar a la anterior solo que se utiliza para guardar una imagen luego de solicitarla y así llegará con éxito al agente.

• variable
  Nombre de la variable que poseerá el archivo.

Procedure

Esta actividad permite ejecutar código JavaScript.

• Área en blanco
  Aquí es donde introduce código Js.

ExecWebService

Permite ejecutar un web service.

• variable
  Nombre que poseerá la variable que contenga la respuesta del WS.

• method
  Método que utilizará el WS, estos pueden ser: Get, Post, Put y Delete.

• url
  Dirección en la cual se encuentra el WS.

• body
  Contenido del body del WS.

• headers
  Todos los headers que lleve el WS, estos se indican header:contenido.

• content-type
  El tipo de contenido que es enviado en el WS.

ExecQuery

Aquí podremos realizar consultas a la base de datos.

• variable
  Nombre que poseerá la variable que contenga el resultado de la consulta.

• área en blanco
  Aquí es donde se redacta la consulta SQL.

Disposition

Permite realizar una tipificación a la interacción con el bot, de esta manera se le puede dar seguimiento a los flujos recorridos por el cliente.

• level1
  Nivel 1 de la tipificación.

• level2
  Nivel 2 de la tipificación.

• level3
  Nivel 3 de la tipificación.

• comment
  Comentarios de la tipificación.

• extra
  Contenido extra para la tipificación.

TransferBot

Con esta opción podremos transferir la interacción desde un bot a una campaña del mismo canal en que se encuentra el bot.

• destination
  Debemos indicar el nombre exacto de la campaña a la que se desea transferir.

LogOp

Permite imprimir el contenido de una variable en el IntegraServer.

• log
  Se ingresa la variable que quiere imprimir con el formato ${variable}

FinishInteraction

Esta acción debe encontrarse al final de cada flujo ya que la misma le indica al bot que terminó su recorrido y cierra la interacción con el cliente.

Esta actividad no posee campos de configuración ya que su única función es terminar la interacción.

SetClientName

Esta actividad toma el contenido de una variable y lo asigna al nombre del cliente de la interacción y a su vez lo asigna a la variable global CLIENT_NAME del bot.

• name
  Nombre de la variable que se utilizará como CLIENT_NAME

Ejemplo:

1. En un mensaje se solicita al cliente que ingrese su nombre, seguido un ReadMessage que permita tomar su respuesta dentro de una variable, esa variable se ingresa en SetClientName, luego en el flujo si mandamos un mensaje con la variable global CLIENT_NAME, se utilizará el valor de la variable en SetClientName.

2. Cuando la interacción llega a un agente, será visible el nombre del cliente con el valor de la variable ingresada en SetClientName.

SendAttachment

A través de esta actividad se permite enviar archivos al cliente.

• url
  Los archivos serán subidos en la carpeta etc/IntegraServer/web/attachments y hay que indicar de que tipo son:

  • image

  • audio

  • video

  • application/pdf

SendEmail

Permite enviar emails.

• template
  Nombre del template de email que se desea utilizar.

• variables
  Dentro del template podremos tener variables a reemplazar ${ejemplo}, en este campo debemos indicar todas las variables del template a reemplazar y el valor que poseerán con el siguiente formato:
  ejemplo:valor

GoToFunction

Esta actividad permite anidar tanto bots como bots functions.

Suponga que se cuenta con un bot denominado B y un bot function denominado BF y B tiene la actividad GoToFunction y en el campo name tiene asignado name= “BF”.

Al momento de ejecutar la actividad GoToFunction se detiene la ejecución del bot B y se comienza a ejecutar BF. Luego de que termine de ejecutar BF, se retornará a B para seguir ejecutando las actividades siguientes.

Es de esta forma que se logra anidar varios bots o bots functions a un bot inicial.

• name
  Campo que contiene el nombre del bot o del bot function al cual se pasará el control una vez que se ejecute esta actividad.

Hay ciertos datos del cliente que se obtienen de la interacción, los mismos pueden ser utilizados en distintas actividades.

Las variables globales son:

Para todos los canales

• CHANNEL
  Canal por el cual se contacta el cliente.

• CAMPAIGN
  Campaña de la interacción.

• GUID
  Guid único de la interacción.

• CLIENT_ID

  • SMS/WhatsApp
    Número de teléfono del cliente.

  • Webchat
    Contenido del campo Email de webchat.

  • Messenger

Webchat

• PHONE_NUMBER
  Contenido del campo Teléfono de webchat.

• CLIENT_NAME
  Contenido del campo Nombre de webchat.

• INITIAL_MESSAGE
  Contenido del campo mensaje.

SMS/WhatsApp

• SMS_PROVIDER_TYPE
  Proveedor de SMS por el cual llega la interacción.

• INITIAL_MESSAGE
  Mensaje que inició la interacción.

Messenger

• CLIENT_NAME
  Nombre del cliente en facebook.

• PAGE_NAME
  Nombre de la página por la cual llega la interacción.

• INITIAL_MESSAGE
  Mensaje que inició la interacción.

Email

• EMAIL_SUBJECT
  Contiene el texto correspondiente al asunto del email recibido.

• EMAIL_BODY
  Contiene el cuerpo del email recibido.

En los BotFunctions se pueden utilizar todas las actividades de bots, pero iniciarán con BotFunctionStartActivity en lugar de BotStartActivity.

BotFunctionStartActivity

Para poder crear un bot function se cuenta con la actividad BotFunctionStartActivity. 

Esta actividad, a diferencia de la BotStartActivity, únicamente posee el campo ‘nombre’.

Es decir, la actividad inicial de un bot function no posee el campo ‘bot_timeout’, ni tampoco el campo ‘timeout_message’, lo que significa que el timeout que se tomará en cuenta es el del bot que llama al bot function.

GoToFunction

Esta actividad permite anidar tanto bots como bots functions.

Suponga que se cuenta con un bot denominado B y un bot function denominado BF y B tiene la actividad GoToFunction y en el campo name tiene asignado name= “BF”.

Al momento de ejecutar la actividad GoToFunction se detiene la ejecución del bot B y se comienza a ejecutar BF. Luego de que termine de ejecutar BF, se retornará a B para seguir ejecutando las actividades siguientes.

Es de esta forma que se logra anidar varios bots o bots functions a un bot inicial.

• name
  Campo que contiene el nombre del bot o del BotFunction al cual se pasará el control una vez que se ejecute esta actividad.

Comenzaremos por agregar la acción de BotStartActivity y ponerle un nombre al bot.

Este nombre es el mismo que se mostrará en el menú desplegable de configuraciones.

Luego agregaremos dos SendMessage que se enviarán seguidos.

El primero será nuestra presentación. En él advertimos al usuario de que debe seleccionar una de las opciones que le daremos a continuación.

En el segundo daremos las opciones, haciendo una por línea y comenzando con numero y guión.

En esta instancia el bot espera la respuesta del cliente, para ello debemos agregar la actividad ReadMessage y nuestro flujo será como el siguiente:

Ahora le agregamos los Evaluate para analizar la respiuesta obtenida. Cómo colocamos cuatro opciones, utilizaremos cuatro.

En cada uno indicaremos la condición que debe tener la variable para que sea válido.

Para cada opción le agregamos su destino, es decir, en el segundo y cuarto Evaluate utilizaremos ExecQuery y en el tercero un TransferBot.

En el primer ExecQuery escribiremos un insert, en el desplegable seleccionamos la base de datos en la que se realiza y en la variable le pondremos un nombre para utilizar luego en la respuesta, en este caso es result.

En el segundo realizará una consulta por versión del sistema, en el desplegable seleccionamos la base de datos en la que se realiza; y en la variable pondremos el mismo nombre que se utilizará luego en la respusta, en este caso es result.

En el TransferBot pondremos el nombre de la campaña a la cual será transferido el cliente.

Hasta aquí solo resta agregar un SendMessage devolviendo la respuesta y seguido un FinishInteraction.

Ahora solo resta unir nuestros flows, o ajustarlo a nuestras necesidades agregando tipificaciones logs o WS y les quedaría algo similar a lo siguiente:

Si deseas enviar un correo desde una campaña específica y un destinatario específico, debes configurar lo siguiente:

• Añade la aplicación ExecWebService a tu workflow:

  

• Ingresa a la configuración del mismo:

• Llena el body con la siguiente información:
  

  body={"campaign": "Email","to": "adress@ucontactcloud.com","cc":"example@example.com",
  	"cco":"example@example.com,example2@example2.com",
  	"subject": "Subject",
  	"body": "This is an email body can be HTML",
      "attachments": ["020212/738hbjk-h73894algo.jgp", "020212/738hbjk-h73894algo.jgp"],
      "reports":["<generated_report_guid>.pdf"],
  	"schedule": {
  		"title": "Date title",
  		"organizer": "Myself",
  		"from": "2018-08-24 00:00:00",
  		"to": "2018-08-24 01:00:00"
  	},
  	"template": "templateName",
  	"variables": {
  		"var1":"value",
  		"var2":"value2"
  	}
  }&agent=nombreAgente

Ejemplo:

body={"campaign": "Comercial","to": "gmorales@integraccs.com","cc":"mauricio@cleverideas.com.mx","subject":"Cliente en espera de ser atendido","template": "CleverBOToffline","variables": {"cliente": "${CLIENT_ID}", "texto": "${msgoffline}"}}&agent=generalBot

Y en la URL debemos setear lo siguiente:

http://localhost:8085/IntegraChannels/resources/Forms/SendMailv2

Por último, setear POST en nuestro método y x-www-form-urlencoded para el content type.