Guía de configuración de Livedesk

Guía de integración de Livedesk

Iniciar sesión en la Consola de desarrolladores de Livedesk, seleccionar el proyecto de destino en el producto Livedesk y seguir los pasos siguientes:

Ir a «Project Settings > API Management > API Key» y copiar el API Key y el API Secret.
Cambiar a GPTBots, abrir «Agent → Integrations → Livedesk», pegar la clave en Access Token y hacer clic en Integrate. Se recomienda habilitar el conmutador del canal de Livedesk para que el agente pueda recibir y responder mensajes.
Una vez vinculado el agente, se puede ver o gestionar en «Livedesk → AI Agents».
En «Livedesk → Channels», seleccionar el canal de destino, abrir su configuración, elegir AI Agent, seleccionar el agente que se acaba de añadir y guardar.

Eso es todo: el agente de IA ya está activo en Livedesk.
Para permitir que el agente asuma las conversaciones de los usuarios, se configura el modo de servicio humano como Livedesk to Livedesk en la configuración del agente.

Gestión del agente de IA

Eliminar: Ir a «Livedesk → AI Agents», seleccionar el agente y hacer clic en Delete.
GPTBots eliminará automáticamente el registro de autenticación y deshabilitará el canal.
Sincronizar información: Cada vez que se actualice el nombre, la descripción o el avatar del agente en GPTBots, los cambios se enviarán a Livedesk de forma inmediata.

Funciones avanzadas de Livedesk

Etiquetado automático (Auto-Tagging)

Al habilitar esta opción, el sistema escuchará todos los eventos seleccionados en el proyecto y puede consumir créditos adicionales.
Una vez completada la autenticación inicial, se puede activar Auto-Tagging:

Eventos desencadenantes
– Close conversation: se activa cuando el visitante cierra el chat de forma activa.
– Transfer chat: se activa cuando el chat se transfiere a otro agente.
Etiquetas
El sistema obtiene la lista de etiquetas existente del proyecto de Livedesk.
Cuando se produce un evento seleccionado, el agente de IA lee la transcripción, elige la etiqueta más relevante y llama automáticamente a la API de etiquetado de Livedesk, lo que ayuda a los agentes humanos a identificar las necesidades del cliente con mayor rapidez.

Filtrado por origen (Source Filtering)

Una vez autenticado, se puede habilitar Source Filtering:

El sistema carga todas las etiquetas definidas en el proyecto de Livedesk.
Seleccionar una o varias etiquetas como criterio de filtrado.
Cuando un visitante inicia un chat, GPTBots comprueba las etiquetas del chat.
– Si coinciden, el mensaje se envía al agente de IA.
– En caso contrario, el mensaje se ignora.

Asignación de ID de usuario (User ID Mapping)

Al utilizar Livedesk para atender a los usuarios, los desarrolladores pueden realizar el seguimiento de identidades entre plataformas mediante la configuración de un User ID. Al llamar al SDK/API de Livedesk para establecer un User ID mientras el usuario ha iniciado sesión, GPTBots asigna automáticamente esta información al campo user_id. Esto ayuda al agente de IA a identificar a los usuarios rápidamente y a mejorar la eficiencia del servicio.

Campo de Livedesk	Campo en la API de Livedesk	Descripción
identifier	user_id	Cuando una conversación de Livedesk incluye el campo `identifier`, GPTBots establece `user_id` con ese valor.
contact id	anonymous_id	Cuando una conversación de Livedesk incluye el campo `contact_id`, GPTBots establece `anonymous_id` con ese valor.
email	email	Cuando una conversación de Livedesk incluye el campo `email`, GPTBots establece `email` con ese valor.

Asignación de campos del navegador (Browser Field Mapping)

Cuando se envía al agente una conversación desde el widget de Livedesk, GPTBots asigna automáticamente los metadatos del navegador a los campos browser correspondientes en GPTBots. Los desarrolladores pueden utilizar estos atributos del navegador para la referencia de variables y la lógica condicional.

Asignación de variables personalizadas (Custom Variable Mapping)

Cuando se envía una conversación de Livedesk al agente, GPTBots analiza automáticamente los atributos de la conversación en los metadatos. Si un nombre de campo coincide con una variable personalizada (Custom Variable) en GPTBots, el valor se asigna automáticamente. Los desarrolladores pueden utilizar estas variables para la lógica y la referencia.

Asignación de atributos de usuario (User Attribute Mapping)

Cuando se envía una conversación de Livedesk al agente, GPTBots analiza automáticamente los atributos de contacto (atributos de usuario) en los metadatos. Si un nombre de campo coincide con un atributo de usuario (User Attribute) en GPTBots, el valor se asigna automáticamente. Los desarrolladores pueden utilizar estos atributos para la lógica y la referencia.