TABLA DE CONTENIDO

1. VISIÓN GENERAL

El BOT conversacional de Oct8ne permite atender a los usuarios de forma automática sin la intervención de un agente. A través de flujos de decisión, puede guiar a sus clientes con una navegación de preguntas y respuestas hasta dar con la solución que necesitan, transferir esa consulta a un agente, guardar datos del visitante, y mucho más.

Oct8ne soporta dos tipos de Bot conversacional, en función del entorno en el que van a ser utilizados:

2. Bot Conversacional para la Web destinado a atender visitantes de su sitio web ("Bot Web").
3. Bot Conversacional para canales de mensajería ("Bot Messaging"), cuyo objetivo es prestar atención vía aplicaciones como WhatsApp o Messenger.

Ambos tipos de Bot comparten bastantes conceptos y herramientas, por lo que estas instrucciones serán, en su mayor parte, válidas para los dos casos. Sin embargo, dado que las capacidades disponibles en el mundo web y en las aplicaciones de mensajería son diferentes, determinadas secciones o apartados serán descritas de forma individual. 

Recuerde: no todas las funcionalidades son válidas en ambos tipos de Bot. Preste atención al tipo de Bot que está diseñando y considere únicamente la información específica para éste, y la que es común para Bots Web y Messaging.

1. El diseñador de conversaciones

Independientemente del tipo de Bot, el flujo de interacción con los usuarios se define diseñando conversaciones. Mediante un diseñador visual incluido en el dashboard de Oct8ne, podrá modelar el comportamiento de su Bot decidiendo los mensajes que serán enviados a los usuarios, capturando sus respuestas, tomando decisiones, o incluso podrá realizar transacciones completas gracias a sus capacidades de integración con sistemas externos vía API HTTP o los plugins nativos con las plataformas e-commerce más populares.

Puede consultar las conversaciones almacenadas en su cuenta desde la opción Management > Chatbot del dashboard de Oct8ne. Para ver las conversaciones específicamente diseñadas para Bot Web, seleccione la pestaña "Conversacional"; si desea ver las conversaciones para canales de mensajería, seleccione la pestaña "Messaging":

Importante: las conversaciones para Web y Messaging son independientes, puesto que cada tipo de Bot tiene sus particularidades.

Puede entrar a editar una conversación simplemente pulsando con el ratón sobre su nombre en la lista de conversaciones. Al hacerlo, accederá al diseñador de conversaciones de Oct8ne, una herramienta visual que le permitirá definir el comportamiento de su Bot de forma realmente sencilla. 

El comportamiento del Bot se modela añadiendo sucesivos módulos (cajas) enlazados entre sí, que representan las acciones que irá realizando el Bot durante la conversación. El módulo inicial, donde comenzará la conversación, siempre está identificado con el icono de una casa.

Las acciones pueden ser tareas sencillas, como enviar un texto de chat al visitante, hasta funciones más complejas como solicitar la introducción de información, transferir a agentes humanos, o incluso la toma de decisiones en función de datos obtenidos durante la conversación. Como podrá comprobar más adelante, Oct8ne incluye un rico conjunto de acciones que permitirán diseñar workflows para dar cobertura tanto a Bots puramente informativos como a Bots capaces de completar transacciones y realizar prácticamente cualquier tipo de operación.

Puede añadir módulos a una conversación partiendo de puntos de enlace que presentan otros módulos, arrastrando el botón "+" hacia la posición de la superficie del diseñador donde desea ubicar el nuevo elemento. Al soltar el botón del ratón, aparecerá el menú donde puede elegir la siguiente acción que se llevará a cabo en la conversación.

Nota: los módulos disponibles son distintos dependiendo de si está diseñando la conversación para Bot Web o Bot Messaging.

La siguiente captura de pantalla muestra cómo, al arrastrar el botón "+" de la acción inicial del árbol hacia la derecha de la superficie, se muestra el menú de selección de módulos. Seguidamente aparece el resultado de seleccionar el módulo "Opción múltiple" del menú, donde vemos que el módulo ha quedado enlazado con el primer paso y, por tanto, será la siguiente acción en ejecutarse después del saludo inicial:

Al seleccionar un módulo sobre el diseñador haciendo clic sobre el mismo, se abrirá en el lateral su ventana de propiedades, donde podrá configurar detalladamente el comportamiento de la acción.  Como se describe más adelante en este documento, las opciones a configurar dependen de cada tipo de módulo; por ejemplo, en el caso del módulo "Chat" será posible indicar el mensaje a enviar al visitante, o en "Opción múltiple" se podrá configurar el mensaje a enviar al visitante y las opciones entre las que deberá elegir.

También desde ese punto será posible modificar el nombre de la acción, que puede ser interesante para más adelante facilitar su identificación. Generalmente, al añadir un nuevo módulo a la conversación se le asignará un nombre que por defecto coincidirá con el nombre de la acción seguida de un número correlativo (como "Chat 1", "Chat 2", …, "Multiple choice 1", "Multiple choice 2",  …). Puede modificarlo con facilidad seleccionando el módulo y editando sus propiedades:

Los módulos pueden ser arrastrados sobre la superficie de diseño para cambiarlos de ubicación. Puede, además, usar los controles de zoom para ampliar o reducir la superficie visualizada, y desplazarse por ella usando drag&drop.

Consejo: para facilitar el posterior mantenimiento y legibilidad, es una buena idea mantener el diagrama de la conversación ordenado y limpio. Y si una conversación crece demasiado, no dude en trocear el diálogo en distintas conversaciones y utilizar el módulo "Enlace" para vincularlas.

En la esquina superior derecha de cada módulo encontrará un menú contextual identificado por los tres puntos "…", cuyas opciones permiten:

6. Abrir la ventana de propiedades del módulo. 
7. Establecer como inicial, de forma que sea la primera acción a ejecutarse cuando la conversación se inicie. Una vez pulsado, el icono con forma de casa se ubicará en el módulo actual.
8. Copiar al portapapeles. Los elementos copiados pueden pegarse más tarde sobre la superficie del diseñador usando el menú contextual (botón derecho del ratón). Si desea seleccionar más de un módulo, puede hacerlo haciendo clic sobre ellos mientras mantiene pulsada la tecla Control.
9. Eliminar el módulo de la conversación.

Una vez haya terminado de modelar la conversación, puede utilizar el botón de la barra de herramientas superior para salvar los cambios.

2. BOT WEB: PRIMEROS PASOS

2. Crear una conversación

Las conversaciones para el Bot Web permiten modelar el comportamiento del Bot durante su interacción con los visitantes de su página web. 

Para crear una nueva conversación, acceda a la opción Management > Chatbot del panel de Oct8ne, seleccione la pestaña "Conversacional" y pulse el botón “Crear conversación”:

A continuación, debe rellenar alguna información básica sobre la nueva conversación: 

3. El nombre de la conversación
4. Una breve descripción de la misma
5. El idioma utilizado en las interacciones con el usuario

Si identifica esta conversación como principal, será la utilizada por defecto para todos sus visitantes. Podrá ver rápidamente cuál de sus conversaciones es la principal porque aparece destacada con el icono de una casa:

Oct8ne pone a su disposición un conjunto de plantillas predefinidas. Puede partir de ellas para crear su conversación y modificarlas posteriormente para adaptarlas a sus necesidades, o bien partir de una conversación en blanco.

Si define distintas conversaciones con el mismo nombre que la inicial, pero con un idioma distinto, será utilizada aquella cuyo idioma coincida con el del usuario actual. Por ejemplo, en el siguiente caso, los visitantes que se encuentran en la     página en español iniciarán la segunda conversación llamada “Initial BOT”,     mientras que el resto utilizarán la primera:

Una vez creada la conversación, se abrirá automáticamente el diseñador visual, permitiéndole comenzar a modelar el comportamiento del Bot de forma inmediata.

3. Herramientas específicas en el diseñador de conversaciones

Una vez haya terminado de modelar la conversación para Bots Web, puede utilizar los botones de la barra de herramientas superior, específicos para este tipo de bots, para realizar las siguientes acciones:

5. Guardar los cambios realizados. Pulsando este botón, la configuración de la conversación será salvada, aunque aún no estará disponible para los visitantes hasta que sea publicada.
6. Previsualizar la conversación. Pulsando este botón, el sistema abrirá un navegador desde el cual podrá iniciar una sesión como visitante, con el fin de probar directamente la conversación actual.
   
   

Importante: El modo Preview no soporta todas las funcionalidades, pues se trata de un entorno de ejecución simulado. No funcionarán acciones como enlazar con otra conversación, los envíos de transcripciones o emails, transferencias hacia agentes o departamentos, guardado de contactos, consulta de estado de pedidos o el etiquetado de conversaciones.

7. Publicar la conversación, de forma que pueda ser utilizada cuando el Bot esté activo. Este paso es necesario para que una conversación pueda ser utilizada por los visitantes del sitio web.
8. Retirar la conversación, deshace la publicación y hace que la conversación no esté disponible para los visitantes.

4. Encender y apagar el Bot

En entorno Web, el Bot de Oct8ne se comportará como un agente más, por lo que tiene sentido poder configurar su disponibilidad a la hora de atender visitantes. Esto puede conseguirse mediante un switch disponible en la zona superior de la pantalla de configuración de Bot conversacionales para la web:

Sólo si el botón está en posición conectado (color verde), el Bot podrá atender a los visitantes de la web. En este caso, además, será posible establecer configuraciones adicionales pulsando el enlace "Ver opciones de disponibilidad":

Las opciones avanzadas de configuración de disponibilidad permiten establecer los criterios con los que Oct8ne asignará al Bot visitantes de su sitio web. Pueden establecerse a través del siguiente cuadro de diálogo:

Las opciones disponibles, que puede activar de forma independiente, son:

8. Sólo cuando haya agentes conectados. Si habilita esta opción, el Bot sólo atenderá a visitantes mientras existan agentes humanos conectados. Esto puede ser útil si queremos que el horario de atención del Bot coincida con el de los agentes humanos encargados de la atención; esto puede ocurrir, por ejemplo, si nuestra conversación acaba siempre en la transferencia a personas para que completen la asistencia a los visitantes. Resumidamente:

2. Si está activado (posición verde), el Bot sólo estará disponible mientras haya agentes humanos conectados.
3. Si está desactivado (posición roja), el Bot estará disponible siempre, independientemente de si hay o no humanos conectados.

9. Priorizar agentes. Puede habilitar esta opción si desea que el Bot sólo intervenga cuando no haya agentes disponibles. Resumidamente:

2. Si está activado (posición verde), el Bot no atenderá a los visitantes inicialmente si existen agentes disponibles. En su lugar, los visitantes serán asignados directamente a los agentes.
3. En caso contrario (posición roja) el Bot atenderá a todos los visitantes de manera inicial, independientemente de la existencia de agentes disponibles.

Adicionalmente, es posible establecer criterios de filtrado, de forma que el Bot sólo esté disponible cuando se cumplan las condiciones especificadas, básicamente en función de la página e idioma del visitante. Por ejemplo, en la siguiente captura se puede observar una configuración que conseguirá que el Bot esté disponible únicamente cuando la URL de la página en la que se encuentra el visitante contenga el texto "/computers/":

Puede utilizar el botón "Añadir nueva condición" para insertar nuevos criterios.

3. BOT MESSAGING: PRIMEROS PASOS

5. Crear una conversación

El proceso de creación de una conversación para Bots de canales de mensajería es muy similar a la vista anteriormente. Resumidamente, basta con acudir a la sección Management>Chatbot del dashboard de Oct8ne, seleccionar la pestaña "Messaging" y pulsar el botón "Crear conversación":

A continuación, se mostrará un cuadro de diálogo en el que deberá introducir información básica sobre la conversación que se dispone a crear: 

12. El nombre de la conversación
13. Una breve descripción de la misma
14. El idioma utilizado en las interacciones con el usuario

Una vez cumplimentado el formulario, se abrirá automáticamente el diseñador de conversaciones, donde podrá empezar a definir el comportamiento del Bot.

A diferencia de los Bots conversacionales para el entorno Web, en Messaging no es necesario configurar una conversación como inicial, pues la selección de la conversación a iniciar en cada caso es algo que se configura desde la sección Messaging Setup del dashboard de Oct8ne, donde cada cola de una instancia puede ser asignada a una conversación. 

Por ejemplo, la captura de pantalla lateral muestra la configuración de una cola Messaging atendida por Bots, que ha sido configurada para que su conversación inicial sea la llamada "Black Friday default conversation".

Por tanto, en este caso, cuando un visitante sea asignado o movido a la cola "Default queue", el Bot iniciará la conversación "Black Friday default conversation".

6. Herramientas específicas en el diseñador de conversaciones

Una vez haya terminado de modelar la conversación para Bots Messaging, puede utilizar los botones de la barra de herramientas superior, específicos para este tipo de bots, para realizar las siguientes acciones:

15. Guardar los cambios realizados. Pulsando este botón, la configuración de la conversación será salvada, aunque aún no estará disponible para los visitantes hasta que sea publicada.
16. Publicar la conversación, de forma que pueda ser utilizada cuando el Bot esté activo. Este paso es necesario para que una conversación pueda ser utilizada por los usuarios que escriban a su canal de mensajería.
17. Retirar la conversación, deshace la publicación y hace que la conversación no esté disponible para los visitantes.

Un aspecto importante a tener en cuenta es que, a diferencia de lo que ocurre en la Web, los Bots para Messaging no disponen de un modo de previsualización, por lo que deben ser publicados para poder ser testeados. Sin embargo, puede utilizar el siguiente procedimiento para probar sus conversaciones:

1. Diseñe la nueva conversación que desea probar.
2. En una de las instancias de Messaging que tenga configurada, cree una nueva cola gestionada por Bots y asígnele la nueva conversación.
3. Acceda desde su aplicación de mensajería a la instancia donde haya configurado la cola.
4. Como agente, desde el dashboard de Oct8ne, mueva a su usuario a la cola creada en el segundo paso.
5. El Bot tomará el control e iniciará la conversación configurada para dicha cola.

Truco: mientras prueba un Bot Messaging, puede reiniciar por completo su conversación desde la aplicación (WhatsApp, Messenger, etc.) enviando el texto "/reset" (sin las comillas). Esto devolverá la conversación al punto de partida y eliminará todos los datos recogidos hasta el momento.

4. MÓDULOS DISPONIBLES

En esta sección recorreremos los módulos que Oct8ne pone a su disposición para modelar las conversaciones del Bot:

18. Los módulos comunes a Bot Web y Messaging y que, por tanto, puede utilizar en cualquier tipo de Bot.
19. Los módulos disponibles exclusivamente para Bots conversaciones de Web.
20. Los módulos disponibles exclusivamente para Bots de canales de mensajería.

La siguiente tabla resume el conjunto de módulos y su disponibilidad en cada tipo de Bot:

Módulo	Disponible en Bot Web	Disponible en Bot Messaging
Chat	✔	✔
Request data	✔	✔
Agent Available	✔
Transfer	✔
Multiple choice	✔	✔
Media	✔	✔
Link	✔	✔
Tag	✔	✔
Analytics event	✔
Save contact	✔	✔
Show order details	✔
Send transcription	✔	✔
Send email	✔	✔
Additional Info	✔
Privacy policy	✔	✔
Delay	✔	✔
End	✔	✔
Run script	✔
HTTP Request	✔	✔
Assignment	✔	✔
Condition	✔	✔
Conditions List	✔	✔
Loop	✔	✔
Multiple choice array	✔	✔
CRM Integration	✔	✔
IFrame	✔
Product Search	✔	✔
Form	✔
Chat GPT	✔	✔
Map JSON	✔	✔
Move to queue		✔
Set pending status		✔
Status change		✔

Nota: dependiendo del plan contratado con Oct8ne, algunos de estos módulos podrían no estar disponibles. Si necesita usar módulos que no estén incluidos en su plan, consulte con su asesor comercial.

7. Módulos básicos

1. Chat

Este módulo se utiliza para enviar mensajes al usuario, que serán mostrados en forma de “bocadillos” o burbujas en su interfaz del chat en los Bots Web, o como mensajes en aplicaciones de mensajería como WhatsApp o Messenger.

Para configurar esta acción, simplemente deberá añadir tantos mensajes como desee enviar al visitante. Estos mensajes podrán utilizar formatos de texto básicos, como negrillas o cursivas, usando los botones situados en la barra de herramientas del editor. 

En Bots para la Web también es posible incluir enlaces e imágenes integrados en el texto, aunque para esto último se recomienda utilizar el módulo Media, especialmente diseñado para ello.

Será posible asimismo insertar en el cuerpo del mensaje el valor de variables previamente definidas en la conversación, cuyos valores serán reemplazados en tiempo de ejecución. Puede utilizar para ello el botón {x} de la barra de herramientas:

Chat
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

2. Request data

Puede usar este módulo cuando desee que el Bot solicite algún tipo de información al visitante, como su nombre, su email, o el identificador del pedido que desea consultar, entre otros. La información suministrada por el usuario será introducida en una variable que, posteriormente, puede ser utilizada en módulos o acciones posteriores. 

Al introducir esta acción, deberá configurar los siguientes aspectos:

19. El texto o cuestión que será enviada al usuario 

para solicitarle la información, 

como por ejemplo “¿Cuál es su nombre?”

. Puede usar las mismas herramientas de edición que en el módulo "Chat".

20. El nombre de la variable en la que será 

depositado el valor introducido por el usuario. Las variables pueden ser cualquier palabra o identificador que comience por una letra y contenga exclusivamente letras y dígitos, como “nombre” o “apellido1”.

21. El tipo de datos esperado, a elegir entre los siguientes:

3. Texto (texto plano o alfanumérico)
4. Email
5. Número (un valor numérico)

Cuando el tipo de datos recibido no sea correcto, se volverá a solicitar la información al usuario.

Nota: Los números de teléfono, ZIP, códigos postales o cualquier tipo de referencia, como el código de un pedido, son normalmente del tipo “Texto”. Utilice el tipo de datos “Número” exclusivamente cuando piense realizar operaciones matemáticas con el valor.

Request data
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

3. Agent available 

Esta acción permite comprobar la disponibilidad de un agente o grupo de ellos y bifurcar hacia distintos módulos en función del resultado de la comprobación. 

Dependiendo de la configuración del módulo, se comprobará la disponibilidad de:

24. Cualquier agente, independientemente de su departamento.
25. Agentes de un departamento específico, seleccionado mediante un control desplegable.
26. Un agente concreto, seleccionado igualmente a través de un desplegable.

Este módulo puede ser conectado con dos posibles acciones distintas, en función del resultado de la comprobación de disponibilidad. Por ejemplo, si existe disponibilidad de agentes, podría conectarse con el módulo Transfer para transferir la sesión a un agente físico; en caso contrario, podría modelarse la conversación de forma que se solicitaran al usuario sus datos de contacto para escribirle más adelante.

Agent Available
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇

4. Transfer 

Este módulo transfiere la conversación a un agente disponible, según los criterios especificados.

Para configurar esta acción, deberá indicar en primer lugar un texto, que será mostrado al agente receptor de la transferencia.

Seguidamente, se definirá el destino de la transferencia, a elegir entre:

27. Cualquier agente y departamento, lo que indica que la transferencia se realizará al primer agente disponible, independientemente del departamento en el que se encuentra.
28. Agentes de un departamento específico, seleccionado mediante un control desplegable.
29. Un agente concreto, seleccionado igualmente a través de un desplegable.

Es habitual encontrar este módulo justo a continuación del módulo Agent available.

Transfer
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇  Como alternativa, puede utilizar el módulo ‘Move to queue’ para transferir el chat a una cola concreta gestionada por un agente.

5. Multiple choice

Esta acción permite enviar al usuario una lista de opciones, de las que éste debe seleccionar una para continuar la conversación. 

Su configuración consiste en especificar la siguiente información:

31. El texto mostrado al usuario como encabezado de las distintas opciones seleccionables.
32. El tipo de selector, sólo disponible en Bots Web, a elegir entre una lista de botones o un menú desplegable. Es recomendable utilizar este último cuando el número de opciones es elevado, para que sea más fácilmente legible para el usuario.
33. Variable de salida, opcional, que permite asignar a una variable el valor seleccionado por el usuario.
34. Las opciones entre las que debe elegir el usuario.

Cada una de las opciones facilitadas al usuario deberá estar conectada con la acción o módulo será ejecutado cuando el usuario la seleccione. Por ejemplo, en la siguiente conversación se configura un módulo Multiple choice, y cada de las opciones se enlaza con un módulo de chat posterior que permitirá continuar la conversación: 

Normalmente no es buena idea mostrar al usuario listas de opciones demasiado extensas, porque dificultará su lectura y hará más compleja su decisión. En estos casos, resultará más recomendable trocear la pregunta y utilizar varios Multiple choice encadenados hasta llegar a la respuesta que interesa obtener del usuario:

🛇 NO RECOMENDABLE			✔ RECOMENDABLE

Multiple choice
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

6. Media 

Este módulo tiene como objetivo enviar al usuario un video, imagen o audio. En Bots Web, los recursos serán mostrados en la zona del covisor, mientras que los Bots Messaging los enviarán como mensajes independientes en la conversación.

Para configurar este módulo será necesario indicar:

3. El tipo de recurso que se mostrar al usuario, que puede ser: Imagen, audio o video.
4. La dirección en Internet (URL) del recurso que desea ser compartido. Se puede introducir un enlace existente o se puede hacer clic en el botón “Upload” para añadir un nuevo recurso sobre la marcha.
5. Opcionalmente, se puede introducir un título o texto descriptivo, que será enviado junto al recurso.

Nota: La dirección en Internet (URL) debe hacer referencia a un archivo físico, y no a la dirección de páginas de servicios que lo muestran. Por ejemplo, no sería válida la dirección a una página de YouTube.

Media
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

7. File

Este módulo tiene como objetivo enviar al usuario un archivo o un documento. En Bots Web, los recursos serán mostrados en la zona del covisor, mientras que los Bots Messaging los enviarán como mensajes independientes en la conversación.

Para configurar este módulo será necesario indicar:

5. Carga del archivo en cuestion del recurso que desea ser compartido. Se debe hacer clic en el botón “Upload” para añadir un nuevo recurso sobre la marcha.
6. Label: Opcionalmente, se puede introducir un título o texto descriptivo, que será enviado junto al recurso.

Nota: Este módulo solo acepta carga de archivo en el momento. No se podrá hacer uso de una dirección en Internet (URL)

File
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

8. Link

Este módulo permite enlazar la conversación con otra conversación creada en el sistema, o con otro módulo dentro de la misma conversación. 

Para configurar esta acción será necesario seleccionar la conversación de destino, usando para ello un menú desplegable donde aparecerán todas las conversaciones creadas en el panel de Oct8ne previamente publicadas, y el módulo de destino dentro de dicha conversación.

De esta forma, cuando el diálogo con el usuario llegue a esta acción, el flujo saltará hacia el módulo especificado como destino, continuando la conversación con el visitante justo en ese punto.

Nota: no puede enlazar una conversación del Bot Web con una del Bot Messaging, ni viceversa. También, tenga en cuenta que sólo podrá enlazar con conversación que haya sido publicada.

Link
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

9. Tag

El etiquetado es una fórmula sencilla para clasificar sesiones y permitir su posterior seguimiento, análisis estadístico y obtención de datos agregados.

El módulo Tags permite etiquetar sesiones de forma automática cuando el diálogo con el visitante pase por el punto de la conversación donde ha sido insertado. 

En su configuración, el único dato necesario es la selección de la etiqueta a utilizar, que debe haber sido definida previamente desde las herramientas de administración de su cuenta.

Para crear una etiqueta nueva debes ir a la sección Management > Tags del panel de control de Oct8ne. También, si teclea una etiqueta inexistente, al salvar los cambios realizados en las propiedades de este módulo, será creada automáticamente.

Tag
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

10. Analytics events

De forma similar al módulo Tags, esta acción permite enviar a Google Analytics eventos personalizados que permitirán el seguimiento y posterior explotación estadística de los puntos clave de su conversación. 

Para configurar esta acción será necesario introducir el evento y, opcionalmente, el subevento que desea enviarse a Analytics.

Puede crear los eventos y subeventos a trackear desde Oct8ne en su panel de Google Analytics.

Analytics event
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇  Como alternativa para tracking puede usar el módulo Tag.

11. Save contact

Este módulo permite guardar en Oct8ne información sobre un contacto cuyos datos han sido almacenados previamente en variables del sistema: 

3. Utilizando un módulo como Request data para solicitarlo al usuario,
4. Usando el módulo de asignación,
5. U obteniéndolos desde una API externa mediante la acción HTTP Request.

La configuración del módulo consiste en especificar las variables donde se encuentra la información de los campos principales del contacto:

7. Email, de carácter obligatorio
8. Nombre
9. Apellidos
10. Número de teléfono

La selección de variables se realiza mediante un selector desplegable, por lo que éstas deben haber sido definidas previamente en la conversación.

Estos datos se guardarán correctamente en la sesión y será posible exportarlos desde el apartado Estadísticas del panel de control de Oct8ne.

Save contact
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

12. Send transcription

Este módulo envía la transcripción de la sesión actual a la dirección de correo especificada en su configuración. 

Es posible configurar el asunto del mensaje, así como indicar uno o varios destinatarios del email, que pueden ser direcciones fijas o bien nombres de variable escritas de la forma <var>NombreVariable</var>.

El contenido de este email no es configurable, y contiene exclusivamente la transcripción del diálogo con el usuario. Si desea enviar texto personalizado, utilice el módulo Send Email, que le permitirá también añadir la transcripción.

Send transcription
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

13.  Send email

Este módulo permite enviar un texto arbitrario a las direcciones de correo electrónico que sean configuradas como destinatarios del mensaje, opcionalmente, junto con la transcripción de la conversación. 

Es posible configurar el asunto del mensaje, así como indicar uno o varios destinatarios del email, que pueden ser direcciones fijas o bien nombres de variable escritas de la forma <var>NombreVariable</var>.

Es posible asimismo configurar el cuerpo del mensaje, así como indicar si se desea que, adicionalmente, se añada de forma automática la transcripción de la conversación con el usuario.

Si el mail puede ser respondido, se puede configurar el receptor de la respuesta mediante el campo ‘Reply to’.

Send email
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

14.  Show order details

Este módulo, sólo disponible para Bots Web, realiza una consulta a la plataforma de comercio electrónico para obtener detalles de un pedido cuyo identificador o referencia está almacenada en una variable del sistema, y muestra dicha información mediante un texto personalizado. 

Para ello, en primer lugar, es necesario seleccionar la variable donde se guarda el código del pedido a obtener. Esta variable puede haber sido rellenada solicitando al usuario su valor mediante una acción Request data, o a través de cualquiera de los mecanismos proporcionados por Oct8ne. A continuación, debe indicarse el texto a mostrar al usuario cuando los datos del pedido hayan podido ser recuperados. En dicho texto pueden usarse las siguientes variables internas, que serán sustituidas por el valor real obtenido desde la plataforma:

{date}, {reference}, {total}, {currency}, {labelState}, {deliveryDate}, {carrier}, {trackingNumber}, {productNumber}, {trackingUrl}

Así, si usamos por ejemplo un texto como “Su pedido {reference} se encuentra en estado ‘{labelState}’”, un usuario podría obtener en el chat un mensaje como “Su pedido 2293X39 se encuentra en estado ‘En reparto’”.

Por último, es posible mapear el valor de estas variables internas a variables utilizables en cualquier otro punto de la conversación. Esto se consigue en la última sección de la configuración del módulo, añadiendo correspondencias entre variables de la conversación y los valores del estado del pedido obtenidos.

El uso de este módulo está restringido a los plugins que tengan implementada la API de estado del pedido, así como las implementaciones personalizadas de la API 2.4 de Oct8ne.

Show order details
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇  Como alternativa, normalmente podrá usar acciones Http Request para obtener los datos desde el backend para posteriormente mostrarlos mediante módulos Chat

15.  Additional info

El objetivo de esta acción, disponible exclusivamente para Bots Web, es mostrar al usuario información extensa, utilizando para ello la zona del covisor, disponible en la interfaz web de visitantes de Oct8ne. 

El módulo mostrará en la ventana de chat un mensaje corto, identificado como “Link” en la configuración, cuya pulsación provocará que se abra el visor en forma de popup mostrando el título y el cuerpo completo del mensaje.

Additional info
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇  Como alternativa, puede utilizar módulos Chat con texto extenso, o incluso enlaces externos a webs donde se muestre la información.

16.  Privacy policy

El objetivo de esta acción es mostrar al usuario un texto y un enlace hacia las políticas de privacidad de la compañía, ofreciendo la posibilidad de aceptarlas o rechazarlas. 

Asimismo, en Privacy policy deberá configurar dos conexiones con otros módulos:

7. La primera, que será el camino tomado por la conversación si el usuario acepta las políticas de privacidad.
8. La segunda, que definirá los siguientes pasos de la conversación cuando el usuario decida no aceptarlas. Habitualmente, enlazará una acción Chat para enviar un mensaje de despedida, y un End para finalizar la conversación.

Privacy policy
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

17.  Delay

El módulo Delay permite introducir un retardo en la conversación, que puede resultar útil para darle tiempo al usuario a que lea mensajes consecutivos, o para hacer más humana la interacción simulando el tiempo que tardaría una persona en teclear entre distintos mensajes. 

En Bots Web, en la configuración de este módulo es posible especificar tanto el tiempo de la pausa como si debe mostrarse al usuario el mensaje “Typing…” mientras está siendo aplicado el retardo.

Delay
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

18.  End

Este módulo permite finalizar la conversación entre el Bot y el visitante. 

En Bots Web, esto dará por finalizada la conversación, quedando almacenada como completada en el historial de Oct8ne. En este caso, el único aspecto configurable del módulo es la aparición o no de un botón para que el visitante pueda enviar sus datos de contacto en ese momento.

En Bots Messaging, la sesión se dará por finalizada y el visitante será movido a la cola por defecto.

End
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

8. Módulos avanzados

1. Run script

Este módulo, exclusivo para Bots Web, permite ejecutar un código script arbitrario como parte de una conversación entre un visitante y el Bot de Oct8ne. Esto puede ser utilizado para lanzar alguna acción en la página de su sitio web donde se encuentra el usuario, o bien un código personalizado en el interior del visor de Oct8ne. 

La acción permite configurar los siguientes aspectos:

10. El script que se desea ejecutar, que puede incluir llamadas a funciones u objetos presentes en el host donde se procesará. Por ejemplo, podría incluirse una llamada a una función de la página que muestre un mensaje popup personalizado. 
11. El host o ubicación donde se ejecutará el script; seleccionando “Run inside Oct8ne”, el código se ejecutará en la ventaja del chat; en caso contrario, se ejecutará sobre la página que está siendo visitada por el cliente.
12. Si la conversación debe continuar o debe darse por finalizada. Es importante tener en cuenta que este módulo ejecuta el script de forma asíncrona, lo que implica que no esperará a que dicha ejecución finalice para continuar o cerrar la sesión.

Importante: Oct8ne no realiza ningún tipo de control de seguridad sobre el script a ejecutar, por lo que es responsabilidad del creador de la conversación asegurarse de que el código suministrado es válido y no supone ningún riesgo para el usuario o la plataforma.

Run script
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇

2. HTTP Request

Este módulo permite que, durante una conversación, el Bot de Oct8ne puede comunicarse mediante llamadas HTTP con sistemas externos que dispongan de una API pública basada en JSON. Esta comunicación podría realizarse en dos sentidos: 

12. Ascendente, es decir, enviar datos desde el Bot hacia sistemas externos.
13. Descendente, usar la API externa para obtener información e integrar los datos recogidos dentro de la conversación.

La especificación de una llamada HTTP consiste en indicar los siguientes datos:

5. Método o verbo HTTP: GET, POST, PUT, PATCH o DELETE.
6. URL: dirección del endpoint de la API.
7. Encabezados de la petición: pares clave-valor en los que pueden ser añadidos encabezados arbitrarios que formarán parte de la petición.
8. Cuerpo de la petición (excepto en llamadas GET): contenido a enviar al servidor externo.  Normalmente se tratará de una estructura JSON (application/json), pero se soporta también codificación de formulario (application/form-www-urlencoded).
9. Mapeo de respuesta: permite extraer información de la respuesta JSON retornada por la API externa y mapearla a variables asociadas la conversación actual con el usuario.

Las propiedades URL, cuerpo y encabezados soportan la sustitución de variables en tiempo de ejecución, usando la sintaxis <var>NombreVariable</var>.

Para mapear las respuestas hay que indicar dos aspectos:

7. El nombre de la variable de la conversación donde se introducirá la información.
8. El origen del valor, o la ruta hacia el mismo en el interior de la respuesta JSON recibida.

Por ejemplo, para extraer el nombre de la siguiente respuesta JSON se utilizaría el origen name, mientras que para obtener la ciudad debería utilizarse address.city:

{   "name": "John Smith",   "address": {      "city": "New York",      "street": "5th Ave"   } }

HTTP Request
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

3. Assignment

Este módulo permite crear y asignar valores a variables que pueden ser utilizadas posteriormente durante la conversación. A diferencia de otros módulos como Request data, que permite asignar a variables valores obtenidos directamente desde el usuario, el módulo Assignment permite realizar asignaciones de valores que son calculados en el interior de la propia conversación.

El módulo Assigment permite especificar una o varias asignaciones, estableciendo en cada una de ellas el valor de una variable de la conversación. Por cada asignación será necesario especificar: 

2. El nombre de la variable donde queremos almacenar el valor. Debe usar identificadores que comiencen por una letra y, opcionalmente, pueden contener números. Ejemplos válidos serían: total, name, phone1, etc.
3. Expresión (constante, variable o función) que especifica el valor a asignar a la variable. 

Ejemplos de asignación de valores constantes a variables:

Variable	Expresión	Comentarios
Name	"Peter"	Asignamos a la variable Name el texto “Peter”
Age	18	Asignamos a Age el valor numérico 18
Weigth	24.56	Asignamos a Weight el valor numérico 24.56
IsValid	true	Asignamos IsValid el valor lógico cierto

Ejemplos de asignación de expresiones:

Variable	Expresión	Comentarios
Count	Count+1	Incrementamos el valor de Count
Sum	A + B	Asignamos a Sum el resultado de sumar A y B
FullName	FirstName + " " + LastName	Asignamos a FullName el resultado de concatenar el valor de FirstName, un espacio en blanco, y LastName
Rnd	Random(1,10)	Asignamos a Rnd un número aleatorio entre 1 y 10
Len	StrLen(Name)	Asignamos a Len la longitud del contenido de la variable Name
Arr	Array(1, 2, 3)	Asignamos a Arr un array con los elementos 1, 2 y 3

Puede revisar la referencia completa de expresiones y funciones siguiendo este enlace: https://bot.oct8ne.com/expressions/reference

Assignment
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

4. Condition

Este módulo permite que el Bot tome decisiones por sí mismo, en base a la información disponible durante la conversación. De alguna forma, es la acción que permite dotar de cierta inteligencia a las conversaciones y hacerlas mucho más interactivas y útiles para el usuario. 

La acción Condition permite modificar el flujo de la conversación en función del cumplimiento de la condición o condiciones especificadas. 

Cuando se especifica más de una condición, éstas pueden combinarse según se indica en la casilla “modo de ejecución”:

2. Todos los criterios deben cumplirse (el Y lógico)
3. Algún criterio debe cumplirse (el O lógico)

En cada uno de los criterios incluidos en una acción condicional se debe indicar:

1. Si la condición debe cumplirse o no (negación 

lógica).

2. Operador izquierdo, que puede ser cualquier tipo 

de expresión (cadenas de texto entrecomilladas,

números, variables o llamadas a funciones).

5. Condición (igual, mayor que, menor que, contiene, comienza por, etc.) Oct8ne proporciona por defecto una veintena de condiciones prediseñadas que contemplan los casos más frecuentes.
6. Operador derecho, que también puede ser cualquier tipo de expresión.
7. En caso de tratarse de comparaciones de texto, si la operación debe realizarse distinguiendo entre mayúsculas y minúsculas.

Finalmente, deberá enlazar la condición a los módulos que continuarán la conversación cuando la condición se cumpla y no se cumpla, respectivamente, como en el siguiente ejemplo:

Condition
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

5. Conditions list

Cuando en una conversación hay que introducir varias condiciones de forma consecutiva, el diagrama puede crecer bastante; por ejemplo, considere la siguiente conversación, donde encadenamos tres condiciones para mostrar un mensaje dependiendo del número solicitado al usuario:

Como puede observar, el número de módulos Condition será proporcional al de las opciones a gestionar, dando lugar a workflows extensos y difíciles de gestionar.

La acción Conditions List propone una fórmula más compacta para conseguir el mismo resultado, concentrando en un único punto la toma de decisiones y la bifurcación hacia los distintos puntos de la conversación que interese. De esta forma, el ejemplo anterior podría modelarse de la siguiente manera:

Este módulo dispone de dos modos de configuración: básico y avanzado. 

El modo básico es la opción más sencilla y apropiada cuando la conversación necesita tomar diferentes rutas en función del valor exacto de una variable o expresión.

Su configuración consiste en indicar la expresión a evaluar y luego los valores de las distintas ramas de ejecución. Por ejemplo, en el ejemplo anterior, la expresión a evaluar sería la variable number, y los tres casos serían los valores 1, 2 y 3, que se insertarían de forma individual, para luego actuar como los puntos de enlace a la continuación de la conversación para cada uno de ellos.

En el modo avanzado, en cambio, podrá añadir distintas condiciones independientes entre sí. Estas condiciones se configuran exactamente igual que en el módulo Condition, especificando el operador izquierdo, la condición y finalmente el operador derecho. Cada una de estas condiciones definirá un punto de enlace con el siguiente paso en la conversación.

Nota: una vez que el módulo cambia al modo avanzado, no será posible volver al modo básico. En este caso, será necesario eliminar la acción y volver a crearla.

Nota: Independientemente del modo elegido, si no se cumple ninguna de las condiciones indicadas en la configuración, la conversación continuará por la rama por defecto (default).

Condition
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

6. Loop

Puede utilizar este módulo para crear un bucle que itere entre dos valores especificados en su definición, permitiendo realizar asignaciones en su interior. Es la fórmula ideal para procesar conjuntos de datos o arrays (colecciones de valores).

La configuración de la acción Loop se realiza indicando los siguientes valores:

15. From index, el valor inicial de la variable de control del bucle, llamada $index. Puede ser una constante o una expresión.
16. To index, establece el valor superior (inclusive) que puede tomar la variable de control a $index.
17. Step, valor numérico constante que indica el incremento que será aplicado a $index en cada iteración del bucle.

Dado que en Step puede introducir valores positivos o negativos, es posible crear bucles tanto en sentido ascendente como descendente.

Adicionalmente, deberá introducir una o varias asignaciones, que serán procesadas tantas veces como iteraciones sean ejecutadas en el bucle.

Ejemplo: La siguiente conversación solicita al usuario un número, mostrándole a continuación su número factorial (por ejemplo, el factorial de 5 = 5*4*3*2 = 120)

Loop
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

7. Multiple choice array

Este módulo es muy similar a la acción Multiple choice descrita en este documento, pues su objetivo es igualmente enviar al usuario una lista de opciones de las cuales éste debe seleccionar una para continuar la conversación.

La principal diferencia respecto a Multiple choice es que, en este caso, las opciones que serán mostradas al usuario no serán especificadas directamente en las propiedades del módulo, sino, en su lugar, en variables o expresiones de tipo array.

Para configurar este módulo será necesario indicar:

19. El texto mostrado al usuario como encabezado de las distintas opciones seleccionables.
20. La variable o expresión de tipo array que contiene el texto de las opciones mostradas al usuario.
21. Opcionalmente, la variable o expresión de tipo array, paralelo al anterior, que contiene el valor de cada una de las opciones mostradas.
22. La variable donde se almacenará el valor de la opción seleccionada por el usuario.

El array de valores es opcional; si se omite, el valor almacenado en la variable de salida será el texto mostrado al usuario.

Por ejemplo, la siguiente conversación muestra al usuario un menú para seleccionar un color (rojo, verde o azul), y muestra posteriormente el valor hexadecimal de dicho color. Para ello, se han utilizado dos arrays paralelos, uno para el nombre del color y otro para su valor hexadecimal:

Multiple choice array
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

8. CRM Integration

Este módulo permite que su Bot genere tickets automáticamente en su sistema de gestión de relaciones con clientes (Customer Relationship Management o CRM). 

Cuando el flujo de la conversación llega a esta acción, el sistema obtendrá la configuración actual de su CRM (establecida en la sección Settings > Integrations > CRM del dashboard de Oct8ne) y la usará para insertar un ticket con información sobre la sesión actual.

Tras llevar a cabo esta tarea, la conversación continuará por el punto de enlace "Success", si la información pudo ser enviada a su CRM, o "Failture" en caso contrario.

Para configurar el módulo debe introducir los datos que compondrán el nuevo ticket, dependientes del tipo de CRM que esté utilizando. Por ejemplo, si utiliza Zendesk será necesario que introduzca información sobre el estado en el que desea almacenar el nuevo ticket, su prioridad o su asunto, así como el email y nombre del cliente al que será asociado. En todos estos casos, podrá rellenarlos introduciendo directamente los valores que se desean enviar al CRM, o bien insertar en ellos variable usando la habitual sintaxis <var>NombreVariable</var>.

Si cambia su configuración de CRM, puede resetear los campos del módulo haciendo clic en la parte del encabezado: “Click here to load all fields again”.

CRM Integration
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

9. IFrame

Este módulo, exclusivo para Bot Web, tiene como objetivo mostrar marcos HTML tanto en el chat como en el covisor, lo que permitiría incrustar contenidos arbitrarios tanto en el chat como en el covisor de Oct8ne. Ejemplos de uso podrían ser la incrustación de un Mapa de Google con una ubicación, un vídeo de YouTube, o una web de reserva de citas online.

Para configurar este módulo será necesario:

22. Indicar el enlace o ruta (atributo "src") de la aplicación o página web que será incrustada en el IFrame.
23. Dónde se va a mostrar el marco. Puede visualizarse únicamente en la superficie del chat (la misma ocupada por los mensajes) o en el chat y el covisor, de forma que también aparecería, con una mayor superficie disponible, en el covisor de Oct8ne.
24. Opcionalmente, es posible establecer estilos adicionales para el tag <iframe> que será insertado. Aquí puede insertar estilos CSS válidos en el atributo style de las etiquetas HTML. 

Un aspecto importante a tener en cuenta es que muchas aplicaciones web ofrecen la posibilidad de compartir su contenido mediante la generación de un código HTML para insertar en un sitio anfitrión. Es, por ejemplo, lo que ocurre si pulsa el botón "Share" sobre un vídeo de YouTube, donde podría generar un código como el siguiente:

<iframe width="560" height="315" src="https://www.youtube.com/embed/k3ftlbnbwuc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

En estos casos, debe ignorar todo el código y extraer exclusivamente la dirección del recurso (el valor del atributo src de la etiqueta <iframe> resaltado en el código anterior), introduciéndola en el campo Url la configuración del módulo.

Nota: por motivos de seguridad, no todos los contenidos web están preparados o permiten su incrustación en sitios de terceros. En caso contrario, el contenido aparecerá vacío, pero la conversación continuará funcionando. También puede usar herramientas de comprobación como https://iframetester.com/.

IFrame
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇

10.  Product search

El objetivo de este módulo es mostrar sugerencias de productos a los usuarios. Puede configurar este módulo para hacer una búsqueda de productos basadas en el catálogo de Oct8ne o de su tienda, usando como criterios de consulta palabras clave o bien referencias de productos.

Para configurar este módulo será necesario indicar:

26. El origen de los productos desde donde se hará la búsqueda. Puede ser “Catalogo de Oct8ne” o “Catalogo de la tienda”.
27. El tipo de búsqueda que se va a realizar, esta puede ser “palabra clave” o “referencia” de un producto.
28. Texto a buscar. Si busca por palabra clave, los productos retornados deberán contener ese texto; en cambio, si realiza la búsqueda por referencia, en este campo deberá introducir la referencia de un producto. En ambos casos podrá insertar el valor de variables usando la sintaxis <var>VariableName</var>.
29. Puedes seleccionar el número de productos a mostrar al usuario independientemente del resultado de la búsqueda. Este campo solo estará disponible si el tipo de búsqueda es por palabra clave.

En Bots Messaging será necesario especificar adicionalmente dos campos:

28. Perfil de búsqueda, que define el origen de los datos.
29. Opciones de visualización, que configura cómo será mostrado el producto.

Nota: puede consultar y modificar tanto los perfiles de búsqueda como las opciones de visualización disponibles accediendo desde el dashboard de Oct8ne al menú Messaging Setup, pestaña "Products".

Product search
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

11.  Form

Este módulo, exclusivo para Bots Web, permite mostrar formularios personalizados a los usuarios en la interfaz del chat.

Para configurar este módulo será necesario indicar:

31. Cabecera del formulario: Es el texto que aparecerá en la parte superior del formulario
32. Si el usuario podrá cancelar (ignorar) el formulario o no. En caso de que habilitarlo, el usuario podrá pulsar un enlace para continuar la conversación sin necesidad de cumplimentar el formulario.
33. Los campos a solicitar formulario. Cada campo del formulario se define mediante:

6. El tipo de dato del campo, que puede ser “Text area”, “Number”, “Email”, “Text”, “Checkbox”, “Select”, “Upload” o “Date”. 
7. La etiqueta de texto que acompañará al formulario 
8. El valor por defecto o inicial que tiene el campo si el usuario no interacciona con él. 
9. La longitud máxima del campo en caso de que sea algún tipo texto. 
10. Si es requerido o no. (Si es requerido el usuario debe rellenar este campo para poder entregar el formulario) 
11. En caso de usar el tipo "Select", las opciones que aparecerían en la lista desplegable, separadas con una barra vertical. Por ejemplo, una lista para seleccionar tres números sería "1|2|3".

Form
Disponible en Bot Web	Disponible en Bot Messaging
✔	🛇 Como alternativa, podría usar la acción Request Data para solicitar los datos del usuario

12.  GPT Chat

Este módulo, permite integrar Oct8ne con un robot IA. Concretamente, la integración se realiza con OPENAI. A pesar de que existen otros robots y empresas dedicadas a Inteligencia artificial, Oct8ne solo se integra con OPENIA.  https://openai.com/chatgpt/pricing

El cliente deberá tener una cuenta en OpenIA para poder integrarse correctamente.

Para configurar este módulo será necesario indicar:

35. Token de OpenAi: Es el token que proporciona la herramienta OpenAi para cada cliente, para poder integrarse con herramientas de terceros
36. Prompt: Són las instrucciones de configuración del chatGPT; es decir, qué debe decir y como debe comprtarse. 
37. Variable de entrada: La variable con el texto que previamente ha introducido el visitante para que la IA lo interprete y genere una respuesta.
38. Variable de salida: El texto de respuesta de la IA quedará almacenada en esta variable.

	Nota: El prompt es la parte más importante de la configuración. Los promts consumen tokens y los tokens son de pago en función del modelo de OPENAI que se use. Una mal prompt puede llevar a consumos excesivos por parte de OpenIA. Consulte con nuestros asesores comerciales.
	Enlaces de interés Promts https://help.openai.com/en/articles/6654000-best-practices-for-prompt-engineering-with-openai-api https://platform.openai.com/docs/guides/prompt-engineering Modelos https://platform.openai.com/docs/models/overview Errores https://platform.openai.com/docs/guides/error-codes/api-errors

En parámetros avanzados podemos modificar ciertos aspectos del módulo:

40. Modelo: El modelo o versión de la IA de GPT que se está usando.
41. Formato de respuesta: El formato del texto de respuesta, ya sea texto o incluso JSON. 
42. Límite de Tokens: Límite de tokens generado en la respuesta.
43. Temperatura, Top_p, Presence Penalty, Frecuency Penalty
44. Memory: Número de intervenciones anteriores que tiene el bot para generar o ‘entender’ el contexto del que se está hablando.

Links de interés: https://platform.openai.com/docs/api-reference/chat/create

GPT Chat
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

13.  Map JSON

Este módulo permite mapear estructuras de datos en formato JSON y asignarlas a variables propias del BOT para poder mostrarlas en conversación.

Para configurar este módulo será necesario indicar:

42. Variable de entrada: Será el nombre de la variable que contiene el JSON que deseamos mapear.
43. Mapeo de respuesta: permite extraer información de la variable JSON retornada por cualquier API externa (incluido GPT) y mapearla a variables asociadas a la conversación actual con el usuario.

Para mapear las respuestas hay que indicar dos aspectos:

44. El nombre de la variable de la conversación donde se introducirá la información.
45. El origen del valor, o la ruta hacia el mismo en el interior de la respuesta JSON recibida.

Map JSON
Disponible en Bot Web	Disponible en Bot Messaging
✔	✔

14.  Move to queue

El módulo Move to queue, disponible exclusivamente en Bots Messaging, permite mover a un usuario a la cola especificada en su configuración. Si la cola de destino es atendida por humanos, el usuario quedará a la espera de que algún agente continúe la atención; en cambio, si es atendida por un Bot, éste comenzará la conversación que tenga configurada.

A la hora de seleccionar la cola a la que será movido el usuario, dispone de dos opciones:

46. Moverlo a la cola a la cola por defecto de la instancia de Messaging asociada a la conversación
47. Moverlo a una cola específica seleccionándola de la lista desplegable o bien introduciendo la etiqueta (tag) con la que se ha identificado la cola.

Puede consultar las etiquetas de las colas disponibles a través del dashboard de Oct8ne, en la sección "Colas" de las propiedades de las instancias de Messaging:

Nota: tenga en cuenta que este módulo es finalizador, es decir, la conversación actual se detendrá justo en el momento en que llegue a este punto del diálogo y se mueva al usuario a la cola de destino, y la sesión con el usuario continuará en dicha cola.

Move to queue
Disponible en Bot Web	Disponible en Bot Messaging
🛇	✔

15.  Set pending status

Básicamente, los usuarios que se comunican con los agentes de Oct8ne a través de Messaging pueden estar en dos estados:

48. Pendientes de responder, cuando el usuario escribió un mensaje, pero aún no fue respondido. Es decir, el último en enviar un mensaje fue el usuario.
49. No pendiente, cuando algún agente respondió al último mensaje del usuario.

El módulo Set pending status permite modificar el estado del usuario actual, marcándolo como pendiente o no pendiente de responder, según nos interese. Esto puede ser útil, por ejemplo, si desde el Bot queremos mover al usuario a una cola gestionada por humanos y forzar su estado a pendiente de atender para que un agente pueda retomar la conversación.

Set pending status
Disponible en Bot Web	Disponible en Bot Messaging
🛇	✔

16.  Status change

Aparte de los estados Pendiente/No pendiente, Oct8ne permite asignar a las conversaciones estados personalizados, normalmente más cercanos a las necesidades de gestión del negocio o procesos de atención al cliente. Por ejemplo, podría usar estados como "Pendiente de revisar" o "Esperando almacén" para identificar de forma rápida el estado de su conversación y, de esta forma, poder organizar más eficientemente las interacciones con los usuarios.

La acción Status change permite que el Bot establezca el estado de la conversación. Para ello, deberá seleccionar el estado deseado de la lista desplegable mostrada en la configuración del módulo.

Nota: puede gestionar los estados disponibles en su cuenta desde el menú Messaging Setup, pestaña Status, del dashboard de Oct8ne.

Change pending status
Disponible en Bot Web	Disponible en Bot Messaging
🛇	✔

5. BLOQUES (BLOCKS)

Los bloques son grupos de módulos proporcionados por Oct8ne que, trabajando conjuntamente, definen comportamientos específicos. Puede insertarlos en sus conversaciones, y configurarlos posteriormente para adaptarlos a sus necesidades.

9. Detalles de pedido

Disponible únicamente en Este bloque consiste en 4 módulos que definen un workflow para obtener los detalles del pedido de un visitante:

34. En primer lugar, se solicita al visitante el identificador del pedido.
35. Si el pedido existe, se muestran sus detalles y se continúa la conversación.
36. En caso contrario, se pregunta al usuario si desea intentarlo de nuevo, llevándolo al módulo inicial si la respuesta es afirmativa.

6. VARIABLES DE CONTEXTO

Al iniciar el diálogo con un usuario, es posible precargar un conjunto de variables obteniendo sus valores desde la información de contexto de la conversación. Estas variables debe definirlas desde la configuración de la conversación, añadiendo las variables que vaya a necesitar durante el diálogo con el usuario.

Puede acceder a la configuración de la conversación pulsando el botón con forma de rueda dentada situado en la zona inferior de la superficie del diseñador de conversaciones.

Las variables de contexto actúan exactamente de la misma forma que el resto de variables establecidas a través de módulos como Request Data o Assignment, es decir, pueden ser utilizadas como parte de cualquier expresión. La diferencia es que, en este caso, sus valores serán suministrados automáticamente por Oct8ne al iniciarse el diálogo con el usuario.

Las variables de entorno que puede añadir a la conversación de forma predeterminada en función del tipo de Bot utilizado son las reflejadas a continuación.

10. Variables de contexto del Bot Web

Nombre de la variable	Valor cargado por Oct8ne
$url	URL completa de la página actual. Puede ser útil, por ejemplo, para que el bot tome decisiones en función de la ruta actual.
$locale	Idioma y cultura de la página actual.
$productId	Identificador del producto (sólo si el usuario está visualizando la página de un producto específico).
$enterType	Forma de entrada a Oct8ne (apertura de chat, trigger, invitación…).
$timeOffset	Desplazamiento del usuario respecto a la zona horaria UTC+00 expresado en minutos (positivos o negativos).
$triggerId	Id del trigger lanzado. En caso de que el chat no se haya abierto por trigger (apertura manual), será 0.
$firstAccessPage	Primer acceso a la página.
$urlHash	Propiedad hash de la url en la que se encuentra el cliente.
$userAgent	Información del navegador del cliente.
$isDevice	Indica si el cliente está usando un dispositivo móvil. True/False

Adicionalmente, es posible especificar variables de contexto totalmente personalizadas. Estos valores deben suministrarse desde la página en la que se encuentra Oct8ne, estableciéndolos como propiedades del objeto oct8ne.options.context de la página, como en el siguiente ejemplo:

<script type="text/javascript">    var oct8ne = document.createElement("script");    oct8ne.type = "text/javascript";    oct8ne.async = true;    ...        // Bot context variables:    oct8ne.options = {       context: {          userName: "John Smith"       }    };    ...    var s = document.getElementsByTagName("script")[0];    s.parentNode.insertBefore(oct8ne, s); </script>

Tras asegurar que el valor ha sido insertado en la página, es necesario añadir en el conjunto de variables de contexto una nueva variable de tipo “Custom” desde el diseñador de bots del dashboard de Oct8ne, indicando:

2. El nombre de la variable, por ejemplo “Name”.
3. La ruta hacia la propiedad donde se encuentra el valor dentro del objeto oct8ne.options.context; en el ejemplo anterior, sería necesario introducir “userName” para que el valor pueda ser recuperado.

11. Variables de contexto del Bot Messaging

Nombre de la variable	Valor cargado por Oct8ne
$clientName	Nombre del cliente en la plataforma de mensajería, o el establecido por los agentes usando las herramientas de Messaging.
$locale	Idioma y cultura de la instancia utilizada en la conversación.
$messagingApp	Nombre de la aplicación usada por el cliente, como "Whatsapp" o "Messenger".
$license	Código de licencia de su cuenta en Oct8ne.
$messagingPlatform	Código de la plataforma utilizada por la instancia actual. Por ejemplo, recibirá 1 para Messenger o 4 para Whatsapp vía 360Dialog.
$instanceId	Identificador de la instancia actual.
$queueId	Identificador numérico de la cola en la que se encuentra actualmente la conversación.
$queueTag	Tag o identificador textual de la cola actual.
$clientId	Identificador del usuario actual. En caso de usar Whatsapp, coincidirá con su número de teléfono; en Facebook o Instagram, su identificador interno en dichas redes sociales.
$clientCulture	En caso de usar Whatsapp, el país de origen del cliente actual, basado en el prefijo de su número de teléfono. En otros casos, no existirá el dato.  Los códigos que se muestran son ISO 3166 A-2: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
$currentMessage	Último mensaje enviado por el usuario
$currentMessageType	Tipo del mensaje enviado por el usuario. Se puede usar para distinguir reacciones, menciones de instragram…

También en Bots Messaging puede especificar variables de contexto totalmente personalizadas. Los valores para las mismas son definidos por la cola en la que se encuentra actualmente el usuario. Puede configurar los valores por cada cola editando sus propiedades e introduciendo un objeto JSON válido en el campo Variables (JSON):

Una vez hecho, debe añadir a la conversación las variables presentes en el objeto JSON suministrado por la cola. Para ello, debe insertar una nueva variable de contexto de tipo “Custom”, especificando el nombre de la variable, que debe coincidir con el nombre de la propiedad en el JSON.

Por ejemplo, si en la cola configuramos un JSON como {"userName": "John"}, deberemos configurar la variable de contexto con el nombre "userName", tal y como se muestra en la captura adjunta.

Recomendación: utilice siempre en el JSON de contexto nombres de propiedad que no entren en conflicto con los nombres de variables usados en la conversación.