Embeddable Widget

The Queria widget is a complete chat interface that you can embed in any website, portal or application. It offers the same AI features of the main platform in a compact and customizable format.

What it is

The widget is a chat window that appears in a corner of your website. Visitors can interact with the Queria AI directly from your page, without logging into the platform. The widget uses the Cog-RAG architecture to provide answers based on your company documents.

Use cases

• Customer support: automated answers based on company documentation
• Document search: let users search your archives via natural language
• Technical support: manuals and guides accessible via conversational questions
• Smart FAQs: replace static FAQs with a dynamic AI assistant
• Internal portals: integrate AI search into intranet and company tools

How to embed the widget

HTML snippet

Add the following code before the closing </body> tag on your site:

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

Configuration parameters

Parameter	Values	Description
data-api-key	String	Your company's API key (required)
data-theme	light, dark, auto	Widget visual theme
data-position	bottom-right, bottom-left	On-screen position
data-primary-color	Hex code	Widget primary color
data-title	Text	Title shown in the header
data-placeholder	Text	Placeholder text in the input field
data-welcome	Text	Initial welcome message
data-language	it, en	Interface language

Widget features

The widget offers a focused subset of the platform features:

• AI conversation: same understanding and generation capabilities as the full platform
• Topic-based answers: limit answers to topics configured for the widget
• Traceable citations: every answer includes references to the sources used
• Source badges: visual identification of information provenance
• Responsive: automatically adapts to desktop, tablet and smartphone
• Session history: the conversation persists through the browser session

Authentication

The widget authenticates via a company-specific API key:

• The key is generated from Queria's admin panel
• Each key is associated with a company and its documents
• You can regenerate the key at any time for security
• The API key determines which documents and sources are accessible from the widget

Customization

Look and feel

Adapt the widget to your site:

• Primary color: button, header and accents
• Light or dark theme: consistent with your site design
• Auto mode: follows the user's system preferences
• Custom title: shows your service name

Behavior

Configure widget behavior:

• Welcome message: first message shown on open
• Default topics: limit answers to specific thematic areas
• Language: interface in Italian or English

Public API endpoints

The widget communicates with the platform via dedicated public endpoints:

• Chat streaming: message sending and streaming response
• Sessions: conversational session management
• Upload: temporary document upload for analysis

All endpoints require the API key in the request header.

Technical considerations

• The widget loads asynchronously and does not slow down your site
• Communications are encrypted via HTTPS
• The widget is compatible with all modern browsers
• The script weight is contained to not impact page performance

TIP

Configure a specific topic for the widget, so answers focus on topics relevant to your site visitors. Upload to the Knowledge Base associated with the topic the FAQs and most important documents for your users.

---

Queria v3.5.0 -- Cog-RAG Architecture