Estos métodos se pueden llamar desde las páginas web de los clientes a través de SU PROPIO JAVASCRIPT.

En esta pequeña documentación se recopilan todos los métodos que se pueden invocar.

MÉTODOS GENERALES

1. oct8ne.open(enterType: string, message: string)
   

Este método inicia el chat de Oct8ne con un ‘tipo de entrada’  y un primer mensaje de chat, enviado como agente.

Esta función soporta 2 parámetros opcionales:

enterType: Es un string que puede tomar los valores: ‘TRIGGER’, ‘CUSTOM’, ‘LIVECHAT’. Si no se especifica el tipo de entrada, será TRIGGER.

message: Corresponde al mensaje que se quiere dar al inicio de esa sesión.

* Esta función no devuelve nada como respuesta.

Este método consulta en los ajustes del cliente, si el chat está activo (o no) en la web. 

Esta función no soporta parámetros.

* Esta función devuelve un booleano como respuesta; ‘true’ en caso de estar activo y ‘false’ en caso de estar apagado.

1. oct8ne.getVisitorStatus()
   

Esta función conuslta el estado del visitante.

Esta función no soporta parámetros.

* Esta función devuelve un string. (‘Just Looking’, ‘Waiting’, ‘Attending’) dependiendo del estado en que se encuentre el visitante en el momento de realizar la llamada.

1. oct8ne.agentsAvailable()
   

Consulta la disponibilidad de agentes en el momento de ser invocada.

Esta función no soporta parámetros.

* Esta función devuelve un booleano; ‘true’ en caso de que agentes estén conectados y ‘false’ en caso de que no haya agentes conectados al panel de Oct8ne.

1. oct8ne.isMobile()
   

Consulta si el cliente está navegando a través de un dispositivo móvil (o no)

Esta función no soporta parámetros.

* Esta función devuelve un booleano; ‘true’ en caso de que sea un dispositivo móvil y ‘false’ en caso de que se trate de otro dispositivo (pc sobremesa)

1. oct8ne.updateTriggerValue(key: string, value: string)
   

Este método actualiza los valores de la propiedad de oct8ne.customData que le indiquemos y reevalúa los triggers.

Solo se usa en caso de que el objeto ‘oct8ne.customData’ esté insertado en la página.

Esta función soporta 2 parámetros:

key: Es un string que corresponde a la propiedad que queramos actualizar.

value: Es un string que contiene el valor nuevo que se quiere dar al trigger.

* Esta función no devuelve nada como respuesta.

1. oct8ne.restart()
   

Esta función recarga el api de Oct8ne, simulando un cambio de página. Útil para entornos SPA

Esta función no soporta parámetros.

Esta función no devuelve nada como respuesta.

1. oct8ne.updateOct8neOptions(object:object)

Ejemplo:

1. var object = {
   
2.       'id':'123456',
   
3.       'location':'Barcelona'
   
4. }
   
5. oct8ne.updateOct8neOptions(object);
   
6. 
   

---

MÉTODOS RELACIONADOS CON EL TAMAÑO DEL VISOR.

Modifican el tamaño del chat. 

Para que estos métodos funcionen correctamente, debe existir una sesión iniciada en el chat de Oct8ne anteriormente.

1. oct8ne.ui.showMinimized()
   

Método que minimiza el visor de Oct8ne.

Esta función no soporta parámetros.

* Esta función no devuelve nada como respuesta.

1. oct8ne.ui.showChat()
   

Abre Oct8ne, sólo con el tamaño del módulo del chat. 

Esta función no soporta parámetros.

* Esta función no devuelve nada como respuesta.

1. oct8ne.ui.showCoviewer()
   

Abre Oct8ne completamente; es decir, muestra el módulo del chat extendido , es decir con el covisor desplegado (si la configuración del cliente lo permite).

Esta función no soporta parámetros.

* Esta función no devuelve nada como respuesta.

1. oct8ne.bot.getContext()
   

Recoge los valores de las variables del visitante en el bot.

Esta función no soporta parámetros.

* Esta función no devuelve nada como respuesta.

1. oct8ne.bot.updateBotContext(updateVars: object)
   

Actualiza los valores de las variables de contexto del visitante en el Bot.

Solo se usa en caso de que el objeto ‘oct8ne.options’ esté insertado en la página.

Esta función soporta 1 parámetros obligatorio. Debe ser un objeto clave: valor con las variables a actualizar.

* Esta función no devuelve nada como respuesta.

Ejemplo:         

1. var newVars= {
   
2.        'sessionId':'XXXXXXXXX'
3. }
   
4. oct8ne.updateOct8neOptions(newVars);         
   

1. oct8ne.bot.gotoHome()
   

Al ejecutar este método, el bot  va al nodo inicial del árbol principal que tenga definido.

Esta función no soporta parámetros.

* Esta función no devuelve nada como respuesta.

1. oct8ne.bot.gotoAction(treeId: int, nodeId: string)
   

Al ejecutar este método, la conversación actual ‘se mueve’ a un nodo específico de algun árbol.

Esta función soporta 2 parámetros opcionales:

treeId: Es un int que hace referencia al árbol elegido.

nodeId: Corresponde al nodo/modulo al que se quiere dirigir

* Esta función no devuelve nada como respuesta.

•    Si sólo se indica el treeId, se va al nodo inicial del árbol especificado.

•    Si se indican treeId y nodeId, salta al nodo y árbol indicado.

•    Si se usa sin parámetros, va al nodo inicial del árbol principal (equivalente a 

oct8ne.bot.gotoHome.)

Si TODOS estos métodos se añaden al cargar la página, se deben añadir dentro de un callback de algún evento que asegure que Oct8ne ya ha sido cargado, como oct8ne.onReady.

Ejemplo:

1. oct8ne.onReady = function () {
2.     oct8ne.bot.gotoHome();
3. };