` element. ### Access Control In **Allowed Domains / IPs**, list every site where the widget may run, one per line. You can enter: | Entry | Example | Matches | | ---------- | ---------------- | ------------------------------------------------------------- | | Hostname | support.acme.com | That exact host only | | Wildcard | \*.acme.com | Any subdomain, such as help.acme.com, but not acme.com itself | | CIDR range | 192.168.1.0/24 | Sites opened by an IPv4 address in that range | If you paste a full URL, such as `https://acme.com`, only the hostname is used. Requests from unlisted sites are rejected, so the widget won't load there. A widget with no allowed domains is **blocked everywhere**. When you save one, you'll see _No allowed domains/IPs set — all requests will be blocked. Continue?_ Add `acme.com` and `*.acme.com` separately to cover both the main domain and its subdomains. ### Appearance | Field | Default | Notes | | ------------------- | ------------------- | ------------------------------------------------------------------------------------ | | **Widget Title** | AI Assistant | Shown in the chat header. | | **Primary Color** | #3e55ff | Pick a color or type a hex value. Used for the header, button, and visitor messages. | | **Welcome Message** | How can I help you? | The first message visitors see. | The **Preview** on the right updates as you type. It uses sample messages to show your title, color, and welcome message; it doesn't send real questions to the assistant. Floating widgets use the logo from [Settings](https://docs.vinsi.ai/ai-assistant/widgets#widgets-settings) for the chat button. ### Status When you edit a widget, the **Widget active** switch appears. Turn it off to pause the widget without deleting it. _Inactive widgets reject all chat requests._ Turn it back on to restore the widget, and you won't need to change the embed code. ## Embed Code After saving, copy the code from the **Embed Code** box (or use the code icon on the Widgets list) and add it to your site. **Floating**: paste before the closing `` tag. Floating widget ``` ``` **Inline**: paste where you want the chat to appear, and change the `height` as needed. Inline widget ``` ``` The embed code stays the same when you edit the widget. The widget loads its title, color, welcome message, and logo each time a page opens, so saved changes show up on your site without re-pasting the code. ## What the Widget Knows Every widget answers from your organization's whole AI Assistant [Knowledge Base](https://docs.vinsi.ai/ai-assistant/knowledge-base). To change what it knows, add, update, or remove documents there. All of your widgets pick up the changes. - Answers can include a **Sources** list with the documents used. - Greetings like "hi" or "hello" get your welcome message back. - The widget stays on topic. It answers questions about your organization, its products and services, and the VINSI.AI platform. It politely declines unrelated requests, such as recipes, homework, or trivia. Anyone on an allowed site can see what the widget knows. Don't upload internal-only documents to the Knowledge Base if your organization has a public widget. ## What Visitors See - A chat header with your **Widget Title** and a _Type a message..._ box. - The notice: _AI Generated Answers May Be Inaccurate._ - If they send messages too quickly, they'll see _Too many messages. Please slow down._ By default, each visitor can send up to 10 messages a minute. - Long messages are rejected with _Message is too long_. The default limit is 1,000 characters. - Each widget has a daily message limit. After it's reached, visitors see _This assistant has reached its daily limit. Please try again tomorrow._ ## Assistant Settings Click **Settings** in the AI Assistant sidebar to customize how the assistant presents itself and behaves for your organization. These settings apply to the whole organization. Saving and uploading require write permission for AI Assistant settings. | Setting | What it does | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Assistant name** | Shown in the sidebar and used when the assistant refers to itself in Chat. Up to 255 characters; defaults to _AI Assistant_. | | **Assistant logo** | Replaces the chat icon on **floating widgets** and appears next to the assistant name. Click **Upload logo** to add one (JPEG, PNG, GIF, WebP, or SVG, up to 10 MB) or **Remove** to clear it. Square images work best. | | **Persona / instructions** | Optional tone and behavior guidance, e.g. _Be concise, friendly, and professional. Avoid jargon._ Up to 4,000 characters. Applies to your team's Chat conversations. | | **Rate limit (messages per minute, per user)** | Caps how many messages each signed-in user can send per minute in Chat. From 1 to 600; default 40. | Click **Save settings** to apply changes. Logo uploads and removals save right away. Only the logo carries over to widgets. Each widget uses its own **Widget Title** and **Welcome Message**, and the Persona and Rate limit settings apply only to Chat.