¿Qué plan tengo?
Complemento Agentes IA - Avanzado
Este artículo describe la funcionalidad heredada y solo lo deben usar los clientes que ya han instalado el Widget de chat Ultimate y necesitan información sobre su mantenimiento. Los clientes nuevos deberían implementar Agentes IA para la mensajería a través del Web Widget.

Con solo unos minutos de su tiempo, el Widget de chat Ultimate puede estar listo y funcionando en su sitio web. ¡Podrá proporcionar una atención al cliente de primer nivel en muy poco tiempo! El widget es altamente personalizable para adaptarse a la apariencia única de su marca: está diseñado para un rendimiento óptimo: su tamaño compacto no ralentizará los tiempos de carga de la página.

En concreto, se mencionan los siguientes:

  • Incrustar el widget
  • Cargar el widget
  • Captura de metadatos
  • Historial de conversaciones
  • Internacionalización y localización
  • Configuración de mensajes de UltimateGPT
  • Notificaciones
  • Métodos
  • Formularios
  • Localización
  • Privacidad de los datos
  • PREGUNTAS FRECUENTES

Plataformas admitidas:

  • Escritorio
  • Internet móvil

Tipos de contenido admitidos:

  • Mensajes de texto, incluido el formato HTML
  • Mensajes de UltimateGPT
  • Botones
  • Tarjetas y carruseles
  • Vínculos
  • Compatibilidad con imágenes y GIF

Derivaciones

  • Derivación por correo electrónico
  • Creación de tickets (requiere integración de API simple)

Incrustar el widget

Para agregar el widget, incruste el script en su sitio web o a través de un administrador de etiquetas.

Asegúrese de cambiar el botID por su identificador único de agente IA. Busque su botID en el URL: https://dashboard.ultimate.ai/bot/{botID}/ o bien https://dashboard.ultimate.ai/ultimategpt/{botID}.

Script incrustado - en archivo HTML

El script debe insertarse antes de cerrar la etiqueta del cuerpo: </body>

<script type="module"> import UltimateChat from 'https://widget.ultimate.ai/sdk/index.mjs'; const chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID_HERE', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: 'I\'m an AI agent and here to answer your questions.' }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); </script>

Incrustar script: Tag Manager (GTM o servicios similares) 

<script> function _onUltimateChatLoad() { var chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: "I'm an AI agent and here to answer your questions." }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); } </script> <script> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://widget.ultimate.ai/sdk/index.iife.js'; s.onload = _onUltimateChatLoad; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })(); </script>

Personalizaciones de estilo

Dentro del script del widget, hay varias opciones de colores que se pueden adaptar al tema del widget.

theme: { 
'actions-hover': '#4A48B0', 
'actions': '#5D5ADC', 
'header-text': '#ECECF9', 
'chat-button': '#15142d', 
'chat-border-radius': 12px, 
'header': '#000' 
},

Especificaciones de recursos:

Avatar - 172×172 px

Cargar el widget

Abrir al cargar

Esta opción de configuración controla el comportamiento del widget al cargarse. Cuando se establece en true, el widget se abre automáticamente tan pronto como esté completamente cargado. De manera predeterminada, esta opción está establecida en false lo que significa que el widget de chat permanece cerrado hasta que el usuario lo abra manualmente.

Solo se puede abrir el widget mediante programación (consulte Métodos: abrir widget) o a través del openOnLoad opción de configuración. De manera predeterminada, esta opción está establecida en false.

 

Botón Mostrar/Ocultar widget

Esta opción de configuración controla la visibilidad del “botón de bienvenida” del widget. Cuando se establece en true, el botón no se muestra en absoluto, ni en la carga inicial ni después de cerrar el widget.

 

Posición de chat

Esta configuración le permite controlar dónde desea ver el widget de chat en la pantalla. Puede configurarlo en Bottom-right o Bottom-left dependiendo de dónde se adapte mejor a su marca. Si no está definido, el widget se establecerá de manera predeterminada en Bottom-right.

Captura de metadatos

Los metadatos son datos que proporcionan contexto adicional para el agente IA. Los metadatos se pueden usar para enriquecer un chat al proporcionar información adicional sobre el cliente, su comportamiento y sus interacciones anteriores con la compañía.

Al aprovechar los metadatos, los Agentes IA pueden ofrecer una experiencia más personalizada y eficiente a los clientes, lo que puede conducir a una mayor satisfacción y lealtad de los clientes. Además, los metadatos pueden ayudar a los equipos de soporte a analizar y mejorar sus procesos de soporte con el tiempo.

En cualquier momento, un sitio web puede establecer y actualizar los metadatos disponibles durante la conversación.

Esto se hace agregando al código del widget los valores que desea recopilar.

Podemos aconsejarle sobre cómo adaptar el código del widget si desea utilizar esta funcionalidad.

Ejemplo de casos prácticos:

Información del cliente: Los metadatos pueden proporcionar información sobre el cliente, como su nombre, dirección de correo electrónico, número de teléfono, ubicación y otros detalles. Esta información puede ayudar al agente IA a personalizar la conversación y proporcionar una asistencia más pertinente.

Historial de compras: Si el cliente ha hecho compras anteriores a la compañía, los metadatos pueden proporcionar información sobre su historial de compras, como los productos que ha comprado, la fecha de compra y el precio pagado. Esta información puede ayudar al agente IA a comprender las necesidades del cliente y proporcionar asistencia específica.

Historial de interacción: Los metadatos también pueden proporcionar información sobre las interacciones anteriores del cliente con la empresa, como sus chats, correos electrónicos o llamadas telefónicas anteriores. Esta información puede ayudar al agente IA a comprender el contexto de la conversación actual y proporcionar una experiencia más fluida para el cliente.

Información del dispositivo: Los metadatos pueden proporcionar información sobre el dispositivo que el cliente está usando para chatear, como el tipo de dispositivo, el sistema operativo y el navegador. Esta información puede ayudar al agente IA a resolver problemas técnicos y proporcionar una asistencia más específica.

Metadata

Para proporcionar contexto adicional para el uso del agente IA:

setMetadata(Array<{
key: string;
value: string;
sanitize: boolean;
}> metadata)

Si sanitize está establecido en true el valor no estará disponible en los registros de conversación, aparece con un marcador de posición

Ejemplo:

            setTimeout(() => {
                chat.setMetadata([
                    { key: 'orderName', value: 'Jane Doe' },
                    { key: 'orderEmail', value: 'jane@ultimate.ai', sanitize: true }
                ]);
            }, 2000);

Recopilación automática de metadatos

El Widget de chat Ultimate puede recopilar automáticamente metadatos relacionados con el dispositivo del usuario.

Cómo configurarlo

Esta funcionalidad está activa de manera predeterminada.

Puede desactivarlo configurando autoMetadataCollection como false

Detalles de los metadatos recopilados.

Esta funcionalidad funciona según la configuración del dispositivo y no requiere cookies ni IP de usuario para funcionar correctamente.

Metadata Descripción
Idioma {{systemLanguage}}

El idioma predeterminado del dispositivo de un usuario.

Por ejemplo: en-GB, en-US

Puede encontrar una lista completa de los códigos de idioma aquí.

(Usando BCP 47 estándar)
Zona horaria {{systemTimezone}}

La zona horaria/región en la que se encuentra el usuario.

Por ejemplo: Europe/Berlin,

Puede encontrar una lista completa de las zonas horarias aquí en la columna ID de zona.
Tipo de dispositivo {{deviceName}}

El tipo de dispositivo utilizado por un usuario. Los dispositivos que detectamos son:

Dispositivos móviles: iPad, iPhone, Android, Windows Phone

Dispositivos de escritorio: Mac, Windows, Linux

URL de inicio

{{url}}

El URL de la página donde el usuario abrió el widget.

Por ejemplo: https://www.google.com
Nombre del navegador {{browserName}}

El nombre del navegador del usuario.

Por ejemplo: Chrome, Firefox, Opera, etc
Navegador y versión {{browserVersion}}

La versión del navegador del usuario.

Por ejemplo: 111, 113 etc

 

Historial de conversaciones

Todas las conversaciones con el widget se almacenan directamente en los registros de conversaciones.

Para una conversación fluida, sugerimos activar el historial de chat. Esto permite que los usuarios continúen donde lo dejaron, incluso después de volver a cargar la página o volver a abrir la pestaña del navegador.

Para que esto suceda, utilizamos el almacenamiento local del navegador para guardar la ID de la conversación. De esta manera, podemos recuperar los datos de la conversación cuando sea necesario.

Activación

Para recuperar el parámetro de cambio de conversación anterior recoverConversation a true.

Desactivación

Cuando se desactiva el historial de conversaciones (cambio del parámetro recoverConversation a false), el lastReadMessageId_{botId} y platformConversationId_{botId} se eliminan del almacenamiento local (LS) del navegador del usuario. Puede encontrar más detalles sobre el uso del almacenamiento local aquí.

recoverConversation was previously named isConversationPersistanceEnabled

 

Configuración de mensajes de UltimateGPT

Rótulo de respuesta de IA

A partir de ahora, cada respuesta generada IA mostrará un rótulo encima. Esto significa que los usuarios pueden distinguir fácilmente entre el contenido generado por IA y otras entradas de mensajes. Es un paso para hacer que la experiencia del usuario sea más clara e informada, y mantener al usuario al tanto de la naturaleza del contenido con el que está interactuando.

Configuración:

Mostrar/ocultar icono de información messageGeneratedAdditionalInfo (predeterminado false)

Orígenes de los mensajes

Cada respuesta generada por IA ahora mostrará las fuentes de la información, lo que le permitirá rastrear los orígenes de la respuesta. Esto no solo fomenta la credibilidad, sino que también permite al usuario explorar más a fondo el tema con referencias creíbles al alcance de la mano.

Configuración:

Mostrar/Ocultar fuentes de IA usando el parámetro showLlmSources (predeterminado true)

Notificaciones

Notificaciones visuales

Estas notificaciones actúan como una representación visual de los mensajes entrantes. Cada vez que se cierre o minimice el widget y se reciba un mensaje nuevo, una notificación en rojo mostrará el número de mensajes que se han recibido pero no se han abierto. 

Notificaciones de sonido:

Las notificaciones de sonido sirven como alertas audibles que llaman la atención del usuario y se activan bajo las siguientes condiciones:
  1. Escalar a agente: Cuando un agente se une a una solicitud de derivación.
  2. Alerta de pestaña de fondo: Cuando llega un mensaje mientras el usuario está viendo otra pestaña del navegador.
  3. Alerta de widget minimizado: Cuando llega un nuevo mensaje y el widget está minimizado.
Opciones de configuración
Activar/desactivar las notificaciones de sonidoLos clientes pueden configurar el estado predeterminado de las notificaciones de sonido usando el allowSoundNotifications dentro del script del widget:
  • Para activar las notificaciones de sonido de manera predeterminada, configure allowSoundNotifications a true.
  • Para desactivar las notificaciones de sonido de manera predeterminada, configure allowSoundNotifications a false.
Una vez configurados, los usuarios conservan la capacidad de activar o desactivar manualmente las notificaciones de sonido según sus preferencias.

Abrir/cerrar el widget

El widget se puede controlar fácilmente desde cualquier lugar del sitio web usando estos sencillos comandos:

  • Para mostrar el widget openWidget()
  • Para ocultar el widget closeWidget()

¿Eliminar el widget?

Ejemplo de casos prácticos:

Proporcione acceso al widget solo a los usuarios que han iniciado sesión y asegúrese de que el widget se cierre después de que un usuario haya cerrado la sesión.

Implementación:

Llamar a un método destroy()

Comportamiento:

  • Elimina el iframe del widget de chat del DOM (Document Object Model)

  • Desconecte la conexión de WebSocket

 

Formularios 

Los mensajes de formulario son un tipo de mensaje estructurado que le permite capturar los datos del usuario en una conversación en curso mostrando un formulario que puede contener entradas de texto, así como menús desplegables seleccionados. 

Uso de formularios con Agentes IA – Avanzado

Los formularios son una excelente manera de recopilar datos de los clientes sin que el bot haga varias preguntas. Los casos de uso típicos incluyen seguridad, preguntas de identificación o solicitudes de cambio de datos.

Para crear un formulario, vaya a Settings / Ultimate Chat Widget / Forms y cree un formulario según las instrucciones de la página.

Es posible crear campos de formulario como:

  • Texto
  • Correo electrónico
  • Seleccionar

Una vez creado el formulario, vaya al diálogo respectivo al que desea agregar el formulario y siga los pasos a continuación. 

Pasos:

  1. Agregue un mensaje de agente IA con el código abreviado para capturar el formulario e insertarlo. En la imagen a continuación, agregamos nuestro formulario lead_capture. Sin embargo, agregará el nombre del formulario entre template: y ))% en el fragmento a continuación.

    %((template: nameOfTemplate))%

  2. Agregar un mensaje del visitante (texto libre) justo después del mensaje del agente IA. Esto captura las respuestas del usuario.

  3. Agregue otro bloque de mensajes del bot después del mensaje del visitante con algún tipo de reconocimiento de que los clientes completaron el formulario, como un agradecimiento.

  4. Las respuestas del usuario están bloqueadas en los metadatos. Si desea usarlos más adelante en el chat, tendrá que recuperarlas; esto es completamente opcional. Hacemos esto con Acciones.

Expurgar las respuestas de los clientes

Expurgar las respuestas es algo que querrá hacer si está solicitando datos de PII a sus clientes. Esto es algo con lo que estará familiarizado por las entidades de contenido, por ejemplo, de manera predeterminada expurgamos las direcciones de correo electrónico y los números IBAN. Si desea más información sobre la expurgación, consulte los artículos a continuación.

Explicación del procesamiento de datos de Agentes IA – Avanzado

Receta: Expurgue los datos de información de identificación personal (PII) con entidades de contenido

Cómo expurgar los datos del formulario

Según el caso de uso que tenga para los formularios, es posible que desee expurgar la información. Esto es fácil de hacer. 

  1. Haga clic en la barra azul donde dice “si...” para abrir el panel de detalles.
  2. Haga clic en el cuadro “Expurgar la respuesta del usuario” para ocultar los detalles dentro de los Agentes IA – Avanzado

El resultado de esto significa que cuando revise la conversación dentro de los Agentes IA – Avanzado, se verá como se muestra a continuación.

 

Localización

Es posible ajustar la configuración regional del widget durante la ejecución. Para cambiar la localización del método de llamada del widget: setLocale(<string>)

Valor predeterminado: en_US

Otros idiomas admitidos: nl_NL

Probar la localización

Utilice el parámetro test para cambiar el idioma del widget. https://widget.ultimate.ai/demo/?botId={Your.Bot.ID}&locale={Your.Locale}
como https://widget.ultimate.ai/demo/?botId=65da6df65ab8b465b87222586&locale=nl_NL

Ejemplo de casos prácticos: Sincronice el idioma de la interfaz del widget con el idioma del sitio web. Llame a un método para actualizar el idioma del widget cuando cambie el idioma del sitio web.

Privacidad de los datos

Nuestro widget cumple con SOC2 y RGPD

  • No se utilizan cookies.
  • El almacenamiento local se usa para ofrecer la mejor experiencia de conversación.

URL de política de privacidad personalizada

Es posible agregar su propia política de privacidad accesible a través de nuestro widget agregándola a la sección de la barra de navegación.

privacyPolicyUrl: URL

Por ejemplo:, privacyPolicyUrl: https://www.ultimate.ai/security-privacy

Almacenamiento local

Nuestro widget no almacena cookies en el dispositivo de un usuario, pero se requiere almacenamiento en el lado del usuario para admitir la funcionalidad del widget. Estos se describen a continuación:

Nombre del parámetro Descripción
platformConversationId_{botId} Almacenamos la ID de la conversación para restaurar la conversación en la recarga de la página. (es posible desactivarlo; consulte esta sección)
lastReadMessageId_{botId}

Almacenamos la ID del último mensaje leído por el usuario. Más tarde, esto se usa para calcular el contador de notificaciones.

PREGUNTAS FRECUENTES

  1. ¿Tengo que conectarme a un CRM para probar el widget? No, la conexión de CRM no es necesaria, puede implementarla en un sitio web de sandbox o solicitarnos que proporcionemos un entorno si esto no es posible.
    Agregaremos nuestro widget a nuestra plataforma para complementar nuestra funcionalidad de agente IA de prueba. 

  2. ¿Podemos hacer seguimiento si se hizo clic en un vínculo? Lamentablemente, en este momento no es posible hacer el seguimiento de si se hizo clic en un vínculo. Evaluaremos agregar esta funcionalidad en el futuro.

  3. ¿Tenemos formato HTML en DLB? Desafortunadamente, no en este momento. Podría intentar usar un editor en línea, como HTML5 Editor - Free Online Content Composer

  4. ¿Podemos tener varias conversaciones? Esta función no está disponible actualmente

  5. ¿Usa cookies el Widget de chat Ultimate ? No, nuestro widget no almacena cookies en el dispositivo de un usuario. Consulte más arriba los detalles de los requisitos de almacenamiento del lado del cliente.

Tecnología de Zendesk