Saltar al contenido
AurionAI

Añade el widget web a tu sitio

6 min de lecturaPor Emmanuel Yazbeck

El widget web incorpora el soporte de AurionAI en tu propio sitio web. Los visitantes lo abren desde un botón situado en una esquina de la página. En la página Widget puedes activar el widget, elegir los sitios web que pueden mostrarlo, cambiar su apariencia y copiar el código de inserción.

Disponibilidad: todos los perfiles. La voz en el widget requiere el perfil AI Voice o el perfil AI Voice + Helpdesk. Solo para administradores.

Requisitos previos

  • Tienes el rol Propietario o Administrador. Los demás usuarios ven Acceso denegado.
  • Puedes añadir un script a las páginas de tu sitio web, o puedes pedirle a tu equipo web que lo haga.
  • Conoces la dirección web de cada sitio que mostrará el widget, por ejemplo https://portal.northwind.example.

Abrir la página del widget

  1. En la barra lateral, selecciona Configuración.
  2. Abre la categoría Integraciones.
  3. Selecciona Widget.

La página contiene las tarjetas Estado y seguridad, Apariencia y Código de inserción. Con el perfil Helpdesk o el perfil AI Voice + Helpdesk, también aparece la tarjeta Configuración de chat.

La página Widget con la tarjeta Estado y seguridad.

Chat, voz o ambos

Tu perfil de producto determina lo que ofrece el widget. La tarjeta Estado y seguridad lo indica:

  • AI Voice: Este widget está configurado para modo solo voz según su plan AI Voice.
  • Helpdesk: Este widget está configurado para modo solo chat según su plan Helpdesk.
  • AI Voice + Helpdesk: Este widget admite tanto chat como voz según su plan.

La parte de voz utiliza el mismo agente de IA que tu línea telefónica. Consulta Nombre del agente, saludo y comportamiento. La parte de chat utiliza la persona de atención al cliente de tu agente y responde a partir de los artículos publicados en tu Centro de ayuda. Para los artículos del Centro de ayuda, consulta Escribir y publicar artículos y Configuración de la base de conocimiento.

Activar el widget y establecer los sitios permitidos

  1. En la tarjeta Estado y seguridad, activa Habilitar widget web.
  2. En Orígenes permitidos, introduce cada sitio web que puede mostrar el widget. Escribe un sitio por línea, con https://, el nombre de host y, si es necesario, el puerto. No añadas una ruta.
  3. Selecciona Guardar ajustes del widget web.

Cómo comprueba AurionAI los sitios permitidos:

  • El sitio de la página debe coincidir exactamente con una entrada: el mismo http o https, el mismo nombre de host y el mismo puerto. https://northwind.example y https://www.northwind.example son dos sitios diferentes.
  • Las rutas no se tienen en cuenta. Una entrada cubre todas las páginas de un sitio.
  • Puedes introducir hasta 50 sitios.
  • En cualquier otro sitio, AurionAI rechaza iniciar el widget.
  • Tu Centro de ayuda de AurionAI siempre muestra el widget, tanto en su dirección aurionai.net como en tu propio dominio una vez que dicho dominio esté verificado. No es necesario añadirlos, y no dependen de Habilitar widget web. Consulta Usar tu propio dominio.

Para el inicio de sesión único en el widget, consulta Inicio de sesión único para usuarios finales.

Cambiar la apariencia del widget

En la tarjeta Apariencia:

  1. Selecciona el Posición del lanzador: Abajo a la derecha o Abajo a la izquierda.
  2. Selecciona un Tema de acento. Para usar tus propios colores, activa Usar colores personalizados y establece el Color primario y el Color de acento.
  3. En Idioma a editar, selecciona un idioma. A continuación, introduce el Título del widget, el Etiqueta del lanzador, el Texto de bienvenida y el Mensaje de burbuja del lanzador para ese idioma. Repite el proceso para cada idioma que necesites.
  4. Opcional: en Logotipo de la empresa, sube un archivo PNG, SVG o JPG de 200 KB o menos.
  5. Opcional: configura Tema del widget, Acciones rápidas y Mostrar insignia "Powered by".
  6. Selecciona Guardar ajustes del widget web.

El widget muestra los textos en el idioma del navegador del visitante. Cuando un idioma no tiene texto, utiliza el texto en inglés.

Añadir el widget a tu sitio web

  1. En la tarjeta Código de inserción, selecciona el Idioma del widget. Detección automática (idioma de la página) sigue el idioma de la página.
  2. Selecciona Copiar fragmento.
  3. Pega el código en las páginas de tu sitio web, o entrégaselo a tu equipo web.

El código contiene tu Clave pública del widget. Si seleccionas Regenerar clave, AurionAI crea una nueva clave de inmediato. Regenerar la clave invalida los fragmentos antiguos que usan la clave anterior. Copia el nuevo código en tu sitio web después de regenerar la clave.

Resultado

En un sitio permitido, el botón del widget aparece en la esquina que hayas elegido. Los visitantes pueden chatear, hablar con el agente de IA, o ambas cosas, según tu perfil. El widget lee su configuración cada vez que se carga una página que lo contiene, por lo que los cambios guardados se muestran en la siguiente carga de página.

Si algo va mal

  • Se requiere al menos un origen permitido cuando el widget está habilitado. Introduce al menos un sitio o desactiva el widget.
  • El guardado falla con un mensaje sobre un origen permitido. Cada línea debe comenzar con http:// o https:// y contener un nombre de host. Elimina rutas, cadenas de consulta y nombres de usuario.
  • El guardado falla con un mensaje que comienza con «Widget GA gate checks failed». AurionAI comprueba algunos ajustes de seguridad cuando el widget se vuelve utilizable por primera vez en un sitio. Si el mensaje menciona recording_consent, desactiva la grabación de llamadas o introduce un texto de consentimiento. Consulta Grabación de llamadas. Para los demás nombres, contacta con el soporte de AurionAI. Consulta Obtener ayuda.
  • El widget no aparece en tu sitio. Comprueba que Habilitar widget web esté activado, que el sitio figure en Orígenes permitidos con el https, el nombre de host y el puerto correctos, y que la página utilice el código actual. Tras usar Regenerar clave, el código antiguo deja de funcionar. El widget también se detiene cuando tu cuenta está suspendida.
  • El logotipo debe ser PNG, SVG o JPG. Usa un archivo PNG, SVG o JPG.
  • No se pudo cargar la configuración del widget web. Actualice la página e inténtelo de nuevo. Recarga la página.
  • Error al guardar la configuración del widget de voz Inténtalo de nuevo. Si el error persiste, contacta con el soporte de AurionAI.

Artículos relacionados

¿Sigue con dudas? Envíe una solicitud o .