Chat Widget¶
The chat widget is what your website visitors see and interact with. It appears as a floating button on your site that opens a chat window when clicked.
How It Appears¶
The widget consists of two parts:
- Toggle Button — A round button (with optional text) fixed to a corner of the screen
- Chat Window — Opens when the visitor clicks the toggle button
The Inqyra chat widget as visitors see it on your website
Starting a Conversation¶
- The visitor clicks the chat toggle button
- The chat window opens and displays the greeting message (if configured)
- The visitor types a question and presses Enter or clicks the send button
- A typing indicator appears while the AI generates a response
- The response appears in the chat window
A typical conversation flow in the chat widget
Message Formatting¶
The chatbot supports rich text formatting in its responses:
| Format | Syntax | Result |
|---|---|---|
| Bold | **text** |
text |
| Italic | *text* |
text |
Code |
`code` |
Inline code |
| Code block | ```code``` |
Multi-line code block |
| Links | [text](url) |
Clickable link |
| Lists | - item or 1. item |
Bulleted or numbered lists |
| Headings | ## Heading |
Section headings |
| Blockquotes | > text |
Quoted text |
URLs, email addresses, and phone numbers in responses are automatically converted to clickable links.
Session Persistence¶
The widget remembers the conversation within the same browser session:
- Same page — The conversation continues without interruption
- Different page on the same site — The conversation history is automatically restored
- New browser session — A fresh conversation starts
Info
Conversation history is tied to the browser's session storage. Once the visitor closes the browser (not just the tab), the session ends and a new conversation will begin on the next visit.
Mobile Experience¶
On mobile devices (screen width below 480px), the chat window expands to fill the entire screen for a better typing and reading experience.
On mobile, the chat window expands to fullscreen
The widget can be hidden on mobile devices entirely via the Widget configuration.
Keyboard Shortcuts¶
| Shortcut | Action |
|---|---|
| Enter | Send message |
| Shift + Enter | New line (without sending) |
Performance¶
The chat widget is designed to be lightweight and fast:
- The widget JavaScript and CSS only load on pages where the widget is enabled
- The AI embedding model loads only when the visitor opens the chat for the first time, not on page load
- This lazy loading ensures the widget does not affect your page's load speed or SEO
Customization¶
All visual aspects of the widget can be customized in the Widget configuration, including:
- Colors and branding
- Position on the page
- Header text and icons
- Greeting message
- Which pages show the widget