Settings
Settings has four tabs. This page covers three of them; the fourth, AI Providers, is large enough to have its own page.
Settings are saved with the save bar that appears once you change something, and they take effect on the storefront immediately.
AI Assistant
How the assistant thinks and speaks.
| Setting | Description |
|---|---|
| Preferred Language | The language the assistant prefers. The list holds 65 languages. Note that the assistant answers each customer in the language that customer wrote in regardless of this setting; it is the fallback and the default voice, not a restriction. |
| Base Prompt | The top-level framing of the assistant's role. Keep it short. Leave it empty to use the built-in default, which is the right choice for most stores. |
| Instructions | Your business description, rules, prohibited topics, and any other standing context. This is the field to use for anything that must always apply. |
| Tone of Voice | A free-text description of how replies should read, for example friendly and casual, professional and formal, or concise and direct. |
| Email me when the AI chat stops working | Sends an email when the assistant is disabled because every configured provider is failing - an invalid key, an exceeded quota, and so on. At most one email per day, and at most three per outage. Add the recipients underneath; each one is validated as an email address. |
For per-scenario procedure rather than standing rules, use Guidance.
Widget
How the chat looks and what it says before the customer types anything.
Availability
| Setting | Description |
|---|---|
| Enable widget | Turns the widget on or off for this workspace. |
| Hide the chat until the knowledge base has content | Keeps the widget hidden on the storefront until your catalog is synced. Without a knowledge base the assistant cannot answer catalog questions, so this avoids a first impression made by an assistant that knows nothing about your store. |
Conversation
| Setting | Description |
|---|---|
| Assistant Name | The name shown on the assistant's messages. |
| Assistant avatar | An image for the assistant. Upload, replace, or remove it. |
| Welcome Message | The greeting shown when the chat window opens. |
| Default questions | Suggested questions offered to the visitor, one per row. Add and remove rows freely; blank rows and duplicates are dropped on save. |
Chat Window
| Setting | Description |
|---|---|
| Primary Color | The accent color of the chat window. Pick from the presets or enter your own. |
| Position | Bottom Right or Bottom Left. |
| Title | The heading of the chat window. |
| Subtitle | The line under the heading. |
| Invitation Message | The message that invites a visitor to start chatting. |
| Link Target | How links in the assistant's messages open: New Tab or Same Window. |
Chat Button
| Setting | Description |
|---|---|
| Primary Color | The color of the launcher button. |
| Position | Bottom Right or Bottom Left. |
| Title | The label on the launcher button. |
Anything not on these lists - the distance from the screen edge, the width of the chat window, its stacking order against your own fixed elements - is done with CSS in your theme, against the widget's stable selectors. See Customize widget appearance.
Which storefront pages the widget loads on is not set here - it is a Magento-side setting, because on an excluded page no widget script is injected and no request reaches eChat at all. See General Settings.
Workspaces
One Magento installation can connect several store views, and each connection is a workspace. This tab groups them under one account so you can see and manage them together.
Each workspace keeps its own knowledge base, its own settings, and its own conversations. Grouping is for management only - it does not merge any data.
Each workspace card shows its name, its storefront domain, the Magento admin URL it was registered from, its live status, whether its Mirasvit license is active, and when it was last used for a chat.
| Action | What it does |
|---|---|
| Rename | Gives the workspace a recognizable name instead of a bare domain. |
| Delete | Removes the workspace. Its knowledge base, settings, and conversations go with it. |
| Get a link code | Mints a code you paste into another workspace to group the two. The code is valid for 15 minutes and can be used once. |
| Add a workspace by code | Pastes a link code from another workspace and links it into this account. |
| Merge into this account | Appears as a warning banner when another account already holds workspaces for this store. Merging keeps every workspace for the store together. |
Stores connected before version 1.2.0 join their account automatically on the next sync. No reconnection is needed, and a change of domain is picked up the same way.