Tutorial de configuración de Livechat

Crear autenticación PAT en la consola de desarrolladores de Livechat

Iniciar sesión en la Consola de desarrolladores de Livechat con la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA, y seguir estos pasos:

• Ir a la página de configuración, seleccionar «Personal Access Tokens» y hacer clic en «Create new token +»
  

• Crear el PAT y seleccionar «select all» para todos los permisos de acceso
  

• Copiar y guardar «Account ID» y «Token», que se necesitarán más adelante para la configuración en «GPTBots - Agent Integration - Livechat».
  

Crear una aplicación en Livechat para recibir y enviar mensajes en la plataforma Livechat

• Ir a la página «Apps» y hacer clic en el botón «Build app» para iniciar la creación de la aplicación: Build app
  

• Introducir el nombre de la aplicación, seleccionar «livechat» en «Product» y hacer clic en «Create app» para crearla correctamente
  

• Hacer clic en la aplicación para entrar en la página de detalles, seleccionar la página «Blocks» y hacer clic en el botón «Add Building Blocks»
  

• En la ventana emergente «Add Building Blocks», seleccionar la opción «App Authorization» y hacer clic en «Add block»
  

• Seleccionar la opción «Server-side app» y hacer clic en el botón «Save» para crearla correctamente
  

• Copiar y guardar «Client Id» y «Client Secret», que se necesitarán más adelante para la configuración en «GPTBots - Agent Integration - Livechat».
  

Configurar la integración de Livechat en GPTBots

• En la página «GPTBots - Agent Settings - Integration - Livechat», configurar la información guardada y hacer clic en el botón «Submit» para completar la configuración.

  • AgentEmail: Dirección de correo electrónico de la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA. Este Agent debe ser una cuenta de atención al cliente humana dentro del mismo proyecto.
  • Account ID: El «Account ID» obtenido al crear el PAT en Livechat (para la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA).
  • Token: El «Token» obtenido al crear el PAT en Livechat (para la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA).
  • Client Id: El «Client Id» obtenido al crear la aplicación en Livechat.
  • Client Secret: El «Client Secret» obtenido al crear la aplicación en Livechat.

• Clave secreta: Introducir una clave personalizada y guardarla para la autenticación del webhook.
  

• Tras completar la configuración de «Livechat Integration» en GPTBots:

  • El Agent de IA tomará el control de la conversación del usuario de la cuenta AgentEmail y responderá directamente a las preguntas de los usuarios.
  • En función de las capacidades del Agent de IA, se puede admitir la entrada de información multimodal, como texto, imágenes y archivos, por parte de los usuarios.
  • La plataforma generará una dirección «Webhooks - Message and Event Reception URL», que se puede utilizar para crear un webhook en el backend de Livechat.

Configurar webhooks de chat para funciones avanzadas como transferencia/cierre de chats

Crear eventos «incoming_event» e «incoming_chat»

• Volver a la página «Blocks» y hacer clic en el botón «Add Building Blocks» para crear webhooks
  

• En la ventana emergente, seleccionar la opción «chat webhooks» (tener en cuenta que no son los app webhooks) y hacer clic en la opción «Add block»
  

• Copiar la dirección «GPTBots Webhook URL» desde «GPTBots - Agent Configuration - Integration - Livechat»
  

• Configurar las siguientes opciones en «Creating Chat Webhook» y hacer clic en «Save» para crearla correctamente

  • Webhook URL: Introducir en el campo la dirección «GPTBots Webhook URL» copiada.
  • Secret key: Introducir la clave personalizada guardada anteriormente
  • Type: Seleccionar la opción «License»
  • Webhook triggers: Seleccionar los eventos «incoming_event» e «incoming_chat» y marcar «chat_presence_user_ids»
    
    
    

Instalar la aplicación y verificar

• Ir a la página «Private Installation» y hacer clic en el botón «Install app».
  

• Por último, acceder a https://my.livechatinc.com/apps/settings/manage-apps/private para comprobar si la instalación se ha completado. Si hay un indicador de instalación, significa que la instalación se ha realizado correctamente.
  

Configurar Livechat Agent

Seleccionar «Team» - «Group» para crear un nuevo grupo. Añadir a este grupo la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA. Además, añadir una cuenta de LiveChat Agent que utilizará el servicio de atención al cliente humano.

• Configurar la cuenta de LiveChat Agent cuya conversación será tomada por el Agent de IA como: Primary agent.
• Configurar la cuenta de LiveChat Agent utilizada por atención al cliente humana como: Backup agent.
  

Funciones avanzadas de la integración de Livechat

Configuración de etiquetas

Nota: Tras habilitar esta función, el sistema supervisará todos los eventos de destino en el proyecto de Livechat y establecerá etiquetas (tags), lo que puede ocasionar un consumo significativo de créditos de la plataforma.
Una vez completada la configuración de autenticación de Livechat, se puede habilitar la función «Setting TAG». La configuración específica es la siguiente:

• Seleccionar escenarios de activación: El sistema permite que la operación «Setting TAG» se active mediante dos eventos: «Closing Conversation» y «Transferring Chat».
  • Closing Conversation: Cuando el usuario cierra activamente la conversación en la ventana de chat de Livechat.
  • Transferring Chat: Cuando la conversación en la ventana de chat de Livechat se transfiere a otra cuenta de atención al cliente.
• TAG: El sistema recuperará automáticamente la lista de TAGs ya configurados en el proyecto de Livechat.
  Cuando se produce el escenario de activación seleccionado, el Agent de IA elegirá el TAG más apropiado en función del registro de conversación y llamará automáticamente a la «Livechat TAG Setting API» para asignar un TAG a la conversación. Esto ayuda al equipo de atención al cliente a identificar rápidamente las necesidades de los usuarios y mejora la eficiencia operativa.
  

Estado de respuesta

Una vez completada la configuración de autenticación de Livechat, se puede habilitar la función «Replying Status». Tras habilitar esta función, cuando un usuario envíe un mensaje en la ventana de chat de Livechat, verá una «animación de respuesta», lo que mejora la experiencia general del usuario.

Formulario previo al chat

Cuando la función «Pre-Chat Form» está habilitada en el widget de Livechat, se solicitará a los usuarios que completen un formulario previo al chat después de enviar un mensaje en la ventana de chat de Livechat. Esto permite recopilar información del usuario.
Una vez habilitada la función «Pre-Chat Form» en la página «GPTBots - Settings - Integrations - Livechat», el Agent de IA podrá recibir la información enviada por el usuario en el formulario previo al chat. Esta información se utilizará como contexto conversacional, lo que ayuda al Agent de IA a comprender mejor las necesidades del usuario y a proporcionar respuestas más precisas.

Establecer el ID de usuario

Cuando los desarrolladores utilizan Livechat para prestar servicios a los usuarios del sitio web, se puede lograr la sincronización de identidad entre el usuario del Agent y el usuario autenticado del sitio web estableciendo un ID de usuario. Cuando un usuario del sitio web ha iniciado sesión, al llamar a la interfaz de API proporcionada por el LiveChat Widget SDK para establecer el ID de usuario, este ID de usuario puede ser utilizado posteriormente por el Agent de GPTBots. Esto ayuda al Agent de IA a identificar rápidamente al usuario, mejorando así la eficiencia del servicio.
Nota: El nombre de la variable para establecer el ID de usuario debe ser user_id, y el valor debe ser el identificador único del usuario.

• Web SDK: establecer ID de usuario

                      
                      LiveChatWidget.call("set_session_variables",{user_id: "your_user_id"});

                    

Tutorial de Livechat sobre cómo establecer el ID de usuario: https://platform.text.com/docs/extending-chat-widget/javascript-api#set-session-variables

• SDK de iOS: establecer ID de usuario

                      
                      LiveChat.setVariable(withKey:"Variable name", value:"Some value")

                    

Tutorial de Livechat sobre cómo establecer el ID de usuario: https://platform.text.com/docs/guides/installing-livechat/ios-widget#setting-custom-variables

• SDK de Android: establecer ID de usuario

                      
                      Map<String, String> customParams = new HashMap<>();
customParams.put("internalCustomerId", "ABC123");
LiveChat.getInstance().setCustomerInfo(
    "Joe", // Name
    "joe@mail.com", // Email
    "0", // Group ID
    customParams // Custom params
);

                    

Tutorial de Livechat sobre cómo establecer el ID de usuario: https://platform.text.com/docs/guides/installing-livechat/android-widget#customer-information