Transferencia a un agente humano

La función de transferencia a un agente humano permite a los desarrolladores de agentes integrar sistemas de atención al cliente de terceros para gestionar solicitudes de soporte humano de los usuarios del agente. Actualmente, se admite la integración con Intercom, Webhook y otros métodos flexibles para conectar sistemas adicionales de soporte humano.

Cómo habilitar la transferencia a un agente humano

1. Hacer clic en el botón "Enable" para activar la transferencia a un agente humano en Configuración del agente - Human handoff.
2. Seleccionar el sistema de atención al cliente requerido; se admite Intercom, Webhook, etc.
3. Completar la configuración de autenticación del sistema de atención al cliente de terceros seleccionado para garantizar una comunicación de mensajes correcta.
4. Ajustar la configuración relacionada con la transferencia a un agente humano según la situación real del soporte de la empresa.
5. Iniciar una solicitud de transferencia a un agente humano en la ventana de conversación del agente para invocar el servicio con normalidad.

Modos de servicio humano

La función de transferencia a un agente humano admite dos modos: External Platform → Help-Desk y Help-Desk → Help-Desk. A modo de ejemplo, cuando el sistema de help desk es Intercom:

flowchart TD
    A["Human Handoff Feature"] --> B["Other to Help-Desk System"] & C["Help-Desk System to Help-Desk System"]
    B --> D["User initiates conversation from Agent-integrated channels"]
    D --> E["Platforms such as WhatsApp/Iframe/Widget/Share/LINE"] & G["Intercom Platform"]
    E --> F["Intercom help-desk system receives and processes"]
    G --> Q["Cannot be received or processed by Intercom system"]
    C --> H["User initiates request from help-desk system platform"]
    H --> I["Intercom Platform"] & K["Non-Intercom Platform"]
    I --> J["Intercom help-desk system receives and processes"]
    K --> L["Cannot be received or processed by Intercom system"]
     A:::Peach
     B:::Sky
     C:::Aqua
     D:::Sky
     E:::Sky
     G:::Sky
     F:::Sky
     Q:::Sky
     H:::Aqua
     I:::Aqua
     K:::Aqua
     J:::Aqua
     L:::Aqua
    classDef Sky stroke-width:1px, stroke-dasharray:none, stroke:#374D7C, fill:#E2EBFF, color:#374D7C
    classDef Aqua stroke-width:1px, stroke-dasharray:none, stroke:#46EDC8, fill:#DEFFF8, color:#378E7A
    classDef Peach stroke-width:1px, stroke-dasharray:none, stroke:#FBB35A, fill:#FFEFDB, color:#8F632D

Configurar la autenticación de "Other to Help-Desk System" (otras plataformas → sistema de help desk)

Los usuarios pueden iniciar solicitudes de servicio humano desde cualquier plataforma compatible con el módulo de integración del agente, y el sistema de help desk seleccionado recibirá y gestionará dichas solicitudes. Por ejemplo:

• Cuando un usuario inicia una conversación y solicita servicio humano en plataformas como WhatsApp, iframe, Widget, Share o LINE, el sistema de help desk de Intercom recibirá y procesará la solicitud de servicio humano.
• Si un usuario inicia una solicitud de servicio humano en la propia plataforma de Intercom, el sistema de help desk de Intercom no podrá recibir ni procesar la solicitud en este modo.

Autenticación de Intercom

Guía tutorial completa para proporcionar transferencia a un agente humano mediante Intercom

1. Crear una app
   En primer lugar, registrarse en Intercom y seguir la guía para completar la creación del espacio de trabajo. Acceder a la página Developer Hub mediante Account Avatar > Settings > APPS & INTEGRATIONS. En Developer Hub, hacer clic en "New app" para crear una aplicación. Si la aplicación ya está creada, seleccionar directamente la aplicación de destino para acceder a su página de configuración.
   
2. Obtener el access token y añadirlo en GPTBots

• Seleccionar el elemento de menú "Authentication" y copiar la información del Access token.
  
• Introducir la información del token en el cuadro de entrada Access token en "Human handoff - Intercom Authentication".
  
• Completar en Intercom la dirección de recepción de mensajes de transferencia a un agente humano.
  Copiar la dirección URL en "GPTBots Message Receiving Address" y completar esta URL en Endpoint URL del elemento de menú Webhooks.
  
• Suscribirse a eventos clave del negocio en Intercom.
  En el área de funciones Topics del elemento de menú Webhooks, utilizar "Select a topic..." para seleccionar 4 eventos de suscripción y hacer clic en el botón "save" para guardar la configuración.
  • conversation.admin.closed
  • conversation.admin.replied
  • conversation.admin.snoozed
  • conversation.read

En este punto, la configuración de Intercom se ha completado. Se puede solicitar la transferencia a un agente humano en la ventana de conversación del agente. Cuando el agente inicia correctamente una solicitud de transferencia a un agente humano, el sistema de help desk de Intercom recibirá el mensaje del usuario. Cuando se responda a este mensaje, la conexión de transferencia a un agente humano quedará establecida oficialmente.

Autenticación de Livedesk

1. Iniciar sesión en la Livedesk Developer Console.
2. Acceder al producto Livedesk, seleccionar la página "Project Settings - API Management - API Key" y copiar API Key y API Secret.
   
3. Introducir el secreto del proyecto en el cuadro de entrada "Access token" en "GPTBots - Human Handoff - Other to Livedesk" y guardar para completar la configuración de autenticación.
   

Autenticación de Webhook

Guía tutorial completa para proporcionar servicios de transferencia a un agente humano mediante Webhook

1. En primer lugar, se debe crear en el entorno de servidor un servicio receptor de Webhook que proporcione las tres interfaces siguientes para recibir solicitudes de servicio humano iniciadas por el agente y para recibir mensajes. Para obtener detalles, consultar Human Handoff Service - Webhook.

   • Create Session: /conversation/establish
   • Chat: /chat
   • Close Session: /conversation/close

2. A continuación, se deben configurar la dirección URL, el nombre de usuario y la contraseña del servicio receptor de Webhook en Agente - configuración de servicio humano, de modo que el agente pueda enviar mensajes al servicio receptor de Webhook.
   

   URL Address: obligatorio, se utiliza para recibir mensajes enviados por los usuarios en el lado del agente.
   Username: opcional, depende del servicio webhook creado por el desarrollador.
   Password: opcional, depende del servicio webhook creado por el desarrollador.

3. Por último, habilitar la función API en "Agent-Integration-API" y configurar la dirección de recepción de mensajes de GPTBots como la dirección URL de envío de mensajes del Webhook, utilizada para enviar el contenido del mensaje de respuesta humana a la ventana de chat del agente. Para obtener detalles, consultar Human Handoff Service - Webhook.
   
   En este punto, la configuración de autenticación de Webhook se ha completado. Ahora se puede solicitar servicio humano en la ventana de chat del agente. Cuando el agente inicia correctamente una solicitud de servicio humano, el servicio receptor de Webhook recibirá el mensaje del usuario.

Autenticación de LiveChat

1. Se debe crear una cuenta propia de LiveChat para obtener el organization_id. Create livechat account
   

2. Se debe crear una APP, añadir Blocks, seleccionar App Authorization y configurarla como una app del lado del servidor. En esta página, se puede obtener el clientId. Create APP
   

3. Añadir Blocks, seleccionar APP webhook y completar la dirección de recepción de mensajes de GPTBots en el portal como la URL del webhook.
   

4. Añadir Blocks, seleccionar Chat webhook y completar la dirección de recepción de mensajes de GPTBots en el portal como la URL del webhook. Seleccionar incoming_event y chat_deactivated.
   
   

5. Hacer clic en Private Installation para acceder a la página e instalar la APP.
   

6. Introducir en la tarjeta el organization_id y el liveChatClientId obtenidos en la preparación previa y hacer clic en "OK" para completar la configuración. En este punto, la configuración de LiveChat se ha completado.
   

Autenticación de Sobot

Consultar Sobot Integration Configuration para configurar el servicio humano correspondiente. Los servicios humanos de Sobot solo están disponibles en el widget de Sobot.

Autenticación de Zoho Sales IQ

1. Se debe iniciar sesión en la cuenta de Zoho y acceder a Zoho API Console.

   Nota: si la cuenta no es de la región de EE. UU., se debe cambiar el dominio. Para obtener detalles, consultar: Prerequisite - Generate Org OAuth Token.

2. Completar el nombre de dominio del servicio actual en Homepage URL y, en Authorized Redirect URIs, introducir el nombre de dominio del servicio actual + /api/console/bot/zoho/salesiq/org/redirect. Hacer clic en CREATE. Tras crearse correctamente, el sistema generará un Client ID y un Client Secret. Copiar el Client ID y el Client Secret correspondientes; se utilizarán en la configuración del servicio manual.
   
3. Iniciar sesión en GPTBots, introducir el Client ID y el Client Secret obtenidos desde Zoho API Console, completar el Screen Name y seleccionar la Server Region.
   • Client ID y Client Secret: obligatorio, se obtiene durante la fase de preparación.
   • Screen Name: obligatorio, se obtiene de la página en la que se ha iniciado sesión. Se debe tomar la primera cadena de ruta tras el nombre de dominio. Por ejemplo, en la dirección https://salesiq.zoho.com/gptbos/mychats/000000000000003, el Screen Name es gptbots.
   • Server Region: seleccionar la región de la cuenta de Zoho.
     Tras configurar la información, hacer clic en Authorize.
4. Tras hacer clic en Authorize, aparecerá una ventana emergente de estado de autorización. Hacer clic en Accept.
5. Public Key: opcional. Si se habilita "Secure your webhook" en la configuración posterior del webhook, se debe completar este campo. Si no se habilita, no es necesario. Para la configuración del webhook, consultar: Zoho Sales IQ Integration Configuration.
6. Seleccionar un grupo adecuado de servicio manual de Zoho. Tras seleccionar el grupo, la conversación será asumida por el grupo de atención al cliente manual correspondiente.
   

   Nota: en este escenario, el bot no puede recibir archivos enviados desde Zoho. Los archivos enviados desde Zoho no se mostrarán en el bot.

Configurar la transferencia a un agente humano

1. Human handoff
   
   Service Status: muestra la disponibilidad del sistema de transferencia a un agente humano de terceros

• Not Configured: cuando nunca se ha completado la información de autenticación del sistema de transferencia a un agente humano de terceros
• Service Available: cuando la información de autenticación se completa y se verifica correctamente
• Service Unavailable: cuando la información de autenticación ya completada falla/caduca durante la llamada
  Trigger Timing: admite descripciones personalizadas del momento de activación para ayudar al LLM a determinar correctamente cuándo invocar la transferencia a un agente humano

2. Mecanismo de tiempo de espera
   Timeout Waiting: valor predeterminado 60 S, tiempo máximo de espera tras iniciar una solicitud de transferencia a un agente humano. Si se supera el tiempo, se solicitará al usuario que finalice la solicitud actual o que siga esperando.
   Session Timeout: valor predeterminado 180 S, tras el último mensaje del agente humano, si no hay respuesta del usuario en N segundos, el sistema saldrá automáticamente del servicio humano.
3. Periodo de servicio de transferencia a un agente humano
   
   Se admite la configuración personalizada de hasta 10 periodos horarios de servicio humano

• Weekly: en este modo, se puede seleccionar de lunes a domingo y establecer el periodo de servicio humano, que se ejecutará semanalmente
• Custom: en este modo, se debe seleccionar una fecha absoluta y establecer el periodo de servicio humano, que se ejecutará solo una vez
  Cuando existen varios periodos horarios de servicio humano:
• En primer lugar, se filtran todas las reglas de "Human service time period" del día natural en función de la dimensión de día natural
• Se calculan los parámetros de todas las reglas de tiempo superpuestas en función de la regla de ventana temporal más amplia. Si no se superponen, no participarán en el cálculo.
• Si existen varias ventanas temporales más amplias que no se superponen, habrá varios periodos horarios efectivos de servicio humano para ese día natural.

  Por ejemplo, el 12 de diciembre de 2024, existen 4 reglas horarias efectivas de servicio humano: 09:00 ~ 12:00, 10:00 ~ 12:00, 13:00 ~ 18:00, 15:00 ~ 17:00.
  La ventana horaria efectiva del sistema será: 09:00 ~ 12:00, 13:00 ~ 18:00

4. Responder fuera del periodo de servicio
   Cuando el servicio humano actual esté fuera del periodo de servicio, al invocar el servicio humano se responderá automáticamente con el "texto predefinido".
5. Transferir el contenido de la conversación
   Cuando se invoca correctamente el sistema de servicio de terceros, se envían al sistema de transferencia a un agente humano N rondas de registros de chat + la última pregunta del usuario para ayudar al agente humano a comprender el contexto.

Iniciar una solicitud de servicio humano

1. El usuario inicia una solicitud de transferencia a un agente humano
   Cuando el usuario desea obtener transferencia a un agente humano, el LLM determinará si debe activar la transferencia a un agente humano. Si el LLM decide activarlo, invocará las herramientas de transferencia a un agente humano y solicitará al usuario que proporcione una dirección de correo electrónico. Si el sistema ya dispone de la información de correo electrónico del usuario, se omitirá el paso de "introducir correo electrónico" y se iniciará directamente el proceso de solicitud de transferencia a un agente humano.
   
   • Cuando el usuario ha iniciado sesión y la cuenta está verificada por correo electrónico, el sistema dispone de la información de correo electrónico del usuario.
   • Cuando el desarrollador configura el correo electrónico del usuario mediante el comando window.ChatBot.setEmail("somebody@mail.com") en el escenario del componente burbuja, el sistema dispone de la información de correo electrónico del usuario.
   • Cuando el desarrollador configura el correo electrónico del usuario mediante iframe_url + ?email=somebody@mail.com en el escenario de iframe, el sistema dispone de la información de correo electrónico del usuario.
2. Cuando el sistema de transferencia a un agente humano de terceros recibe el mensaje del usuario y responde al primer mensaje del usuario, la sesión de transferencia a un agente humano comienza oficialmente.
3. El usuario puede enviar un número ilimitado de mensajes al sistema de transferencia a un agente humano. Tanto el usuario como el personal de atención al cliente humano pueden cerrar activamente la conversación actual de transferencia a un agente humano.

Conectar con cualquier sistema de atención al cliente de terceros, como Intercom, Webhook, LiveChat, etc. Todas las funciones mencionadas anteriormente son aplicables.

Configurar la autenticación de "Help-Desk System to Help-Desk System"

En este modo, los usuarios solo pueden iniciar solicitudes de servicio humano desde la propia plataforma del sistema de help desk, y el mismo sistema de help desk recibirá y gestionará dichas solicitudes. Por ejemplo:

• Cuando un usuario inicia una conversación y solicita servicio humano en la plataforma de Intercom, el sistema de help desk de Intercom recibirá y procesará la solicitud.
• Si un usuario inicia una solicitud de servicio humano desde una plataforma que no sea Intercom, el sistema de help desk de Intercom no podrá recibir ni procesar la solicitud en este modo.

Intercom to Intercom

Consultar Intercom Integration Guide para ver los pasos de configuración.

Zoho Sales IQ to Zoho Sales IQ

Consultar Zoho Sales IQ Integration Configuration para ver las instrucciones de configuración.

Nota: en este escenario, debido a las limitaciones de capacidad del modelo OpenAI-GPT-4o-mini, pueden producirse problemas por los que no se pueda invocar el servicio de atención al cliente manual. Se recomienda utilizar otros modelos.

Livechat to Livechat

Consultar Livechat Integration Guide para ver los pasos de configuración.

Livedesk to Livedesk

Consultar Livedesk Integration Guide para ver los pasos de configuración.