Widget Integrable

El widget de Queria es una interfaz de chat completa que puedes incrustar en cualquier sitio web, portal o aplicacion. Ofrece las mismas funcionalidades IA de la plataforma principal en formato compacto y personalizable.

Que es el widget

El widget es una ventana de chat que aparece en una esquina de tu sitio web. Los visitantes pueden interactuar con la IA de Queria directamente desde tu pagina, sin necesidad de acceder a la plataforma. El widget usa la arquitectura Cog-RAG para proporcionar respuestas basadas en tus documentos empresariales.

Casos de uso

• Atencion al cliente: respuestas automaticas basadas en la documentacion empresarial
• Busqueda documental: permite a los usuarios buscar en tus archivos mediante lenguaje natural
• Soporte tecnico: manuales y guias accesibles mediante preguntas conversacionales
• FAQ inteligentes: sustituye las FAQ estaticas con un asistente IA dinamico
• Portales internos: integra la busqueda IA en intranet y herramientas empresariales

Como integrar el widget

Snippet HTML

Anade el siguiente codigo antes del cierre de </body> en tu sitio:

<script
  src="https://tu-dominio-queria/widget/embed.js"
  data-api-key="TU_API_KEY"
  data-theme="light"
  data-position="bottom-right"
  async>
</script>

Parametros de configuracion

Parametro	Valores	Descripcion
data-api-key	String	API key de tu empresa (obligatorio)
data-theme	light, dark, auto	Tema grafico del widget
data-position	bottom-right, bottom-left	Posicion en pantalla
data-primary-color	Codigo hex	Color principal del widget
data-title	Texto	Titulo mostrado en la cabecera
data-placeholder	Texto	Placeholder en el campo de entrada
data-welcome	Texto	Mensaje de bienvenida inicial
data-language	it, en	Idioma de la interfaz

Funcionalidades del widget

El widget ofrece un subconjunto enfocado de las funcionalidades de la plataforma:

• Conversacion IA: mismas capacidades de comprension y generacion que la plataforma completa
• Respuestas basadas en topic: limita las respuestas a los topics configurados para el widget
• Citas trazables: cada respuesta incluye referencias a las fuentes utilizadas
• Badges de fuente: identificacion visual del origen de la informacion
• Responsive: se adapta automaticamente a desktop, tablet y smartphone
• Historial de sesion: la conversacion persiste durante la sesion del navegador

Autenticacion

El widget se autentica mediante una API key especifica para tu empresa:

• La key se genera desde el panel de administracion de Queria
• Cada key esta asociada a una empresa y sus documentos
• Puedes regenerarla en cualquier momento por seguridad
• La API key determina que documentos y fuentes son accesibles desde el widget

Personalizacion

Aspecto grafico

Adapta el widget al look de tu sitio:

• Color primario: boton, cabecera y acentos
• Tema claro u oscuro: coherente con el diseno de tu sitio
• Modo auto: sigue las preferencias del sistema del usuario
• Titulo personalizado: muestra el nombre de tu servicio

Comportamiento

Configura el comportamiento del widget:

• Mensaje de bienvenida: primer mensaje mostrado al abrir
• Topics predefinidos: limita las respuestas a areas tematicas especificas
• Idioma: interfaz en italiano o ingles

Endpoints API publicos

El widget se comunica con la plataforma mediante endpoints publicos dedicados:

• Chat streaming: envio de mensajes y recepcion en streaming
• Sesiones: gestion de la sesion conversacional
• Upload: subida de documentos temporales para analisis

Todos los endpoints requieren la API key en la cabecera de la peticion.

Consideraciones tecnicas

• El widget se carga de forma asincrona y no ralentiza tu sitio
• Las comunicaciones estan cifradas via HTTPS
• El widget es compatible con todos los navegadores modernos
• El peso del script es contenido para no impactar en el rendimiento de la pagina

TIP

Configura un topic especifico para el widget, asi las respuestas se centraran en los temas relevantes para los visitantes de tu sitio. Sube al Knowledge Base asociado al topic las FAQ y los documentos mas importantes para tus usuarios.

---

Queria v3.5.0 -- Arquitectura Cog-RAG