↑↓ selectEnter openEsc close

    1. Elbuz
    2. Website chat

    How to set up the chat widget on your website

    24 min readUpdated

    You set the chat's look, texts and behavior in one app window, and the site picks up changes on its own — no code edits. Six fields get you started; the rest has working defaults.

    When you need this:

    • The chat button clashes with your site — position, color and dark mode: “View” tab.
    • Visitors think they're talking to a person — the header shows a virtual assistant labeled “AI”.
    • The same questions daily — a quick action button opens the delivery page or asks the AI.
    • Endless conversations — past the message limit, the visitor gets your phone number.

    Where to start: minimum setup — six items.

    What you can configure

    • Chat visibility — turn the whole widget on or off, or hide only the chat button.
    • AI model and message limit — quality, cost and conversation length.
    • Appearance — position, color and dark mode of the button and window.
    • Texts and languages — the title and the lines in the header and footer, one custom text for all languages; store details come from the company details.
    • Consultants — the name and photo of whoever replies.
    • Quick action buttons — a link, a click on your site or a question to the AI in one action.
    • Articles from links — “Import” and “Refresh”.

    FAQ and the video avatar consultant are set up in the same window but covered separately: FAQ in the chat, video avatar consultant. The “Links”, “Prices”, “Limits”, “Events” and “Blocks” tabs are covered in the article about the smart assistant.

    What to fill in first

    The six steps below give you a working chat. Anything not on the list can be set up later or left alone.

    Minimum widget setup

    Store details (payment, delivery, warranty) are the main source the bot answers customers from; how to fill them in and where else the AI gets answers is explained in the article about the chat knowledge base. Pasting the code into your site is covered in the article about installing the widget.

    What you can leave alone

    Field or tabWhy you can skip it
    “Widget information”: “Name”, “Description”Internal; visitors don't see them
    “AI Model”GPT-6-Luna is the default; change it only if you're unhappy with the quality or cost
    “AI reply language”, “No operator”By default the AI writes in the page or contact language and hands complex cases to a manager
    “JS, CSS settings”, “CMS ID”, “CMS theme”For a front-end developer who needs to fit the widget to the site
    The “Placing orders in chat” and “Show shopping buttons” checkboxes, the AI answer rating blockOff by default; the chat works without them
    “Contextual AI suggestions”, “Proactive hints”Extra AI blocks (two checkboxes with the same name)
    The “Links”, “Prices”, “Limits”, “Events”, “Blocks” tabsNeeded when the chat shows products or is embedded in pages; see the article about the smart assistant
    “AI toolbar settings”Separate features that don't affect the chat

    How changes are saved

    The form has no “Save” button. As soon as you change a field and move to another one, the app sends the whole form to the server. The form is saved once more when you close the window.

    The exception is fields with a formatting toolbar: “Chat header text” and “Chat footer text”. Typing in them doesn't count as a field change, so their content is sent with the next edit of any regular field or when you close the window. If you edited only such text, close the window and the changes will be saved.

    You don't need to touch the site after making changes: the integration code doesn't contain your settings, the widget fetches them from the app itself.

    The question, section and quick action button forms work the same way, without a save button.

    How to turn on the chat and choose the model and limit

    “Activity” vs. “Show AI chat”: what's the difference

    Both switches sit at the top of the tab, both are on for a new widget, and both hide the chat from the site. The difference is what disappears along with it.

    • “Activity” turns the whole widget off. The app stops sending its settings to the site, and your blocks and the page panel disappear along with the chat. Also, a disabled widget isn't included in the integration code: if you copy the code in this state, nothing will appear on the site.
    • “Show AI chat” removes the chat button and, with it, the AI suggestions: both “AI blocks on pages” checkboxes on the “View” tab stop working. Blocks from the “Blocks” tab, if set up, keep working.

    Setting the button position to “Hidden” on the “View” tab has the same effect as “Show AI chat”: the widget checks both settings in one place, and the result is identical.

    The widget first checks “Activity”: if it's off, nothing is left on the site. The second check hides only the chat button and AI suggestions; blocks from the “Blocks” tab stay
    NoYesNoYesA site page with the integration codeloadsIs “Activity” on?The site doesn't get the widgetsettingsNo chat button, no blocks, no AIsuggestionsIs “Show AI chat” onand the position not “Hidden”?No chat button, both“AI blocks on pages” checkboxesdon't applyBlocks from the “Blocks” tab workThe chat is placed per “Buttonposition”AI suggestions per the “View” tabcheckboxes
    • Action or result
    • Decision: the path depends on the answer

    “AI Model”

    The list has three models: GPT-6-Sol, GPT-6-Luna and Gemini 3.8 Flash. GPT-6-Luna is the default. Below the field, the app shows an estimate: “1000 messages will cost €… if 1 message is 100 characters long.” Change the model and the figure is recalculated right away.

    “AI reply language”

    This field sits below “AI Model” and sets the language the AI uses with the customer. Options:

    • “Page or contact language” — the default: the website page language, or the contact's language in a messenger. Instagram and Facebook Messenger don't pass it, so there the AI writes in the store's main language;
    • “Automatic: language of the customer's message” — the AI replies in the language the customer wrote in. This option doesn't apply in voice mode;
    • a specific store language — all replies in that language.

    “No operator”

    A switch next to the language. When it's on, the AI replies on its own, doesn't promise a manager's reply and doesn't hand the chat over to a person. Turn it on when no live managers are available.

    • In messengers the AI doesn't hand the chat over to a person. The switch applies if it's on in the first active widget: channels take their settings from it. When the channel's AI mode is “By support policy (AI · Support)”, the switch has no effect.
    • On the website the widget shows no call-a-manager button and no operator photos, and the handover command doesn't work. A person who has already joined this chat on their own is still visible to the customer.
    • In voice mode the AI can't hand the chat over to a manager either.

    “Max. messages in chat”

    An empty field means 300. All messages in the conversation count — both the visitor's and the replies. Once there are more than the limit:

    • the visitor gets “The maximum number of messages has been exceeded! If you have any questions, please contact us by phone” and the phone number from the company details;
    • the input field and quick action buttons disappear: the visitor can no longer write in this conversation.

    The phone number in the company details is empty. Then the limit message ends with “please contact us by phone” — without a number.

    Buttons below the switches

    • “Consultants” — the employee list; which of them appear in the chat is explained below.
    • “FAQ” — “List of frequently asked questions”, see FAQ in the chat.
    • “List of buttons” — quick action buttons in the chat window.
    • “Channels & messengers” — Telegram and Viber connections, visible only to those allowed to change them. See the article about support bots.

    The “Text-to-speech mode” switch is on by default: a “Voice mode” toggle appears in the visitor's chat window menu.

    Working hours

    The widget has no schedule of its own: the website chat opens and replies around the clock. “Working hours” in the company details is text the AI can tell a customer, not a schedule. Live operators' working hours are set in the “Chat settings” window — see chat settings for your team.

    How to change the chat button's look

    SettingOptionsDefault
    “Button position”four corners, “Center left”, “Center right”, “Hidden”, “Sidebar - right”, “Sidebar - left”, “Sidebar - auto”“Bottom left”
    “Button theme”two options, chosen by imagethe second one
    “Button color”seven colors: purple, blue, red, orange, green, dark blue-gray, blackblack
    “Dark mode”“Auto (based on device settings)”, “Always light”, “Always dark”“Always light”
    “Use the site font”checkboxoff

    The button color also sets the color of the chat window header, so pick it to match your site's brand color rather than on its own.

    The “Placing orders in chat” checkbox lets the AI take orders right in the conversation, and a “Customer order” document appears in Elbuz — how this works is explained in the article about leads and orders from the chat.

    View tab: button position, button theme, button color and dark mode
    1Hidden
    2Button color
    3Dark mode
    1. Hidden — the button is not drawn, same as with Show AI chat turned off.
    2. Button color — also the color of the chat window header.
    3. Dark mode — set to Always light by default.

    The tab has two checkboxes with the same name, “AI blocks on pages”, and they are different settings. When you turn one on, make sure you didn't turn on the other one instead.

    • In the “Contextual AI suggestions” block — a changing hint next to the collapsed chat button. Hints for a page are generated once per language, after the visitor's first message on that page, and then everyone sees the saved ones. Each new page is a separate paid request to the .
    • In the “Proactive hints” block — AI blocks embedded in website pages according to rules set below the checkbox.
    Two AI blocks on pages checkboxes: under Contextual AI suggestions and under Proactive hints
    1AI blocks on pages (contextual suggestions)
    2AI blocks on pages (proactive hints)
    1. The hint next to the collapsed chat button, generated on every page.
    2. AI blocks embedded into site pages by rules.

    The “Contextual AI suggestions” block also has “Context card when opening a chat” — it's on by default and is built only when a visitor actually opens the chat on a product or category page. The “Number of question buttons” field sets how many questions the AI generates for a page: from 1 to 8, 2 by default.

    What texts visitors see and in which language

    You no longer fill in store details here: the chat takes the name, contacts, address, opening hours and terms from the company details, and the summary at the top of the “Information” tab shows with checkmarks and crosses what is filled in. The “Edit in the company card” button opens the company details. Change them there and the chat updates by itself.

    The tab itself keeps optional captions. An empty field means the standard text in the visitor's language, while your own text is shown the same in all languages.

    FieldWhere it appears
    “Chat window title”the header of the open window. Empty field — the standard title in the visitor's language
    “Chat header text”a pinned line above the conversation
    “Chat footer text”a pinned line below the input field, for example “AI may make mistakes”
    Information tab: widget information fields and the chat header text editor
    1Chat header text
    1. Chat header text — the pinned line above the conversation.

    Where the greeting comes from

    The AI writes the first message of a new conversation — one or two sentences, up to 30 words, on behalf of the consultant and in the page language:

    • on a product page it mentions the product and offers help with choosing;
    • on a category page it offers help finding what the visitor needs.

    The AI takes the store name from the company details, so that's what affects the greeting.

    Social networks in the chat header

    Messengers and social networks from the “Contacts” section of the company details do more than inform the AI. Each filled-in field — WhatsApp, Telegram, Viber, Facebook Messenger, Instagram — adds a separate participant labeled “Message a consultant” to the chat header. Clicking it takes the visitor to your messenger. The Microsoft Teams, Facebook and X (Twitter) fields don't go into the header.

    Which language the widget speaks

    The widget detects the language from the website page itself — first of all from the page's language attribute — and looks for that language among the store's languages. Store details in that language come from the “Texts for customers in other languages” block of the company details; an empty field falls back to the main language.

    • No translation in the company details — store details are shown in the main language. A window title without custom text shows the standard translation, while your custom title and header and footer lines are the same in all languages.
    • The page language isn't recognized — system captions are shown in English.
    • The widget's own captions (“FAQ”, “Call a manager” and so on) exist in eight languages: Ukrainian, Russian, English, Polish, German, French, Spanish and Italian; for other languages they're in English.
    The chat takes store details from the translation in the company details, or from the main language if there is none
    YesNoYesNoThe widget reads the pagelanguage:the language attribute, then metatagsIs there a translation in thislanguagein the company details?Store details in this languageStore details in the main languageIs a custom titleor chat lines set?Custom text, the same for alllanguagesStandard text in the visitor'slanguage
    • Action or result
    • Decision: the path depends on the answer

    Translations are filled in by the “Translate with AI” button in the “Texts for customers in other languages” block of the company details.

    Who appears in the chat header

    The chat window header shows who is talking to the visitor. This list isn't built in the widget form but from employee cards. The “Consultants” button on the “Setup” tab opens exactly that employee list.

    In the employee card, under “Preferences” → “Work modes”, there are two switches everything depends on:

    • “Chat manager” — the employee appears in the chat header among the consultants. A live employee is labeled “‹name›, live consultant”.
    • “Virtual assistant” together with “Chat manager” is the persona the AI replies on behalf of. For each new conversation the app picks one such assistant at random. In the header, “AI” is added to their name, and below the name is the text from the card's “Brief description” field; if it's empty — “AI assistant”.

    The photo comes from the “Photo” field, the name from the “First name” field in the visitor's language; an employee without a name in that language doesn't appear in the header. A disabled employee disappears from the header of new conversations, and if the assistant assigned to a conversation is disabled, the app assigns it another one.

    Who comes first in the header depends on whether there is a virtual assistant. Without one, the header shows a live manager or a messenger
    YesNoYesNoYesNoA visitor starts a new conversationIs there an active employeewith “Chat manager”and “Virtual assistant”?The app randomly assignsone of them to the conversationThe header shows their name withthe AI prefix,below it “Brief description”or “AI assistant”Is there an active employeewith “Chat manager”?A live manager comes first in theheaderlabeled “live consultant”Is at least one messenger filled inunder “Contacts”?A messenger comes first in theheaderHeader without a name or photo
    • Action or result
    • Decision: the path depends on the answer
    The Work modes switches in an employee card: Chat manager and Virtual assistant
    1Chat manager
    2Virtual assistant
    1. Chat manager — the employee appears in the chat header.
    2. Virtual assistant — the AI replies on behalf of this employee.

    If there is no virtual assistant with “Chat manager”, a live manager labeled “live consultant” comes first in the chat header, and the visitor will think they're talking to a person even though the AI is replying. Set up at least one virtual assistant before you put the code on the site.

    When there's nobody at all with “Chat manager” and no messenger is filled in, the header stays without a name or photo.

    Which live employees see tickets and how they're distributed is explained in the article about chat settings for your team.

    How to add quick action buttons

    “List of buttons” holds the buttons in the chat window, above the conversation. All active buttons are shown on all pages, sorted by the “Order” field, and by name when the order is the same. A new button is created with “Add” in the list and is active right away. Fill in “Name” and “Description” on each language's tab: in a language without a name the button will be blank.

    The key field in the button form is “Button click action”. It determines which other fields you need:

    ActionWhat happens on clickWhat to fill in
    “Message in chat”the chat opens, the button name is sent as the visitor's message, and the AI replies following your instruction“Name”, “Task for AI (prompt)”
    “Click on the button”the app clicks an element on your site. If the element isn't on the page, nothing happens“CSS selector”
    “Open link”the address opens in a new tab“Link”
    “Open link in window”the page opens in a pop-up window over the site; the visitor stays on the page“Link”

    “Description” is the tooltip shown when you hover over the button. The “Position” field (“Top” or “Bottom”) currently doesn't affect where the button sits in the chat window: all buttons are in one row above the conversation.

    Quick action button form: activity, position, click action and AI prompt
    1Button click action
    2Task for AI (prompt)
    1. Button click action — the chosen action decides which fields below are needed.
    2. Task for AI (prompt) — the instruction the robot follows for the "Message in chat" action.

    What article import overwrites

    The article import buttons change data without asking, so it's worth knowing what exactly will change before you click.

    “Import” and “Refresh” for articles

    “Import” creates an article from each link in the field. If an article with that link already exists, it's skipped with the “Already exists” status and its text isn't updated.

    “Refresh” ignores the links field. It goes through all articles ever imported from a link that are enabled and not in the Trash, downloads each page again and overwrites the article's name, heading, full and short text, meta title and meta description in the main language. Your manual edits to these fields are lost. “Refresh” doesn't touch disabled articles or articles in the Trash.

    Information tab: block for importing information pages by URL with the Import and Refresh buttons
    1URL field
    2Import
    3Refresh
    1. URL field — one link per line; only Import reads it.
    2. Import — creates articles from new links and skips pages already loaded.
    3. Refresh — reloads every article previously loaded by link and overwrites its text.
    • If the page was removed from the site or doesn't return code 200, the results table shows a row with the error “Failed to fetch: …”, and the article keeps its previous text. It isn't deleted or disabled automatically: you can only remove it manually.
    • If no title was found on the page, the row shows “Could not extract title” and the article doesn't change.
    • “Updated successfully” appears as soon as there is at least one result row, even if every row is an error. Check the Status column in the table.
    • The app waits up to 30 seconds for a page; the whole refresh is limited to 5 minutes.

    Scenarios

    Launch the chat today, no extras

    Go through the six steps on the list. “Activity” and “Show AI chat” are already on for a new widget, the model is set by default, and you don't need the product tabs. Visitors will see the button in the bottom left corner, a header with your virtual consultant and a greeting the AI writes for the page. Placing orders in chat and shopping buttons stay off — they're turned on with separate checkboxes on the “View” tab.

    Customers are used to writing in messengers

    Fill in the Telegram, Viber or WhatsApp fields in the company details. “Message a consultant” participants will appear in the chat header, and a visitor who doesn't want to talk to a bot can switch to your messenger with one click.

    A common request in one button

    In “List of buttons”, add a “Delivery” button with the “Open link in window” action and the delivery page address — the visitor reads the terms without leaving the product card. Make a second button, “Find a product”, with the “Message in chat” action and a task for the AI listing which questions to ask the buyer. Both buttons will be visible on all site pages: you can't show “Delivery” only on product cards.

    Cap endless conversations

    Set “Max. messages in chat” and fill in “Phone”. Once a conversation exceeds the limit, the visitor gets your number and the bot stops replying in that conversation: the input field and quick action buttons disappear. An empty limit field doesn't turn the limit off — 300 messages apply.

    What to do when the widget misbehaves

    What you see in the widget and what to do about it
    What you seeWhyWhat to do
    There is no chat button on the site even though the code is in place “Show AI chat” is off, the “Hidden” position is selected, or “Activity” is off Check all three settings; after turning “Activity” on, copy the code again (activity)
    The chat header has no consultant name or photo, or “live consultant” comes first even though the AI is replying There is no active employee with “Chat manager” and “Virtual assistant” Turn on both switches in the employee card and add a photo (consultants)
    “The maximum number of messages has been exceeded! If you have any questions, please contact us by phone” The conversation exceeded “Max. messages in chat” Raise the limit if conversations are cut off too early; fill in “Phone” (limit)
    A button with the “Click on the button” action does nothing There is no element with that “CSS selector” on this page Check the selector against the site page together with your front-end developer (buttons)
    The chat title and texts are in a different language from the page There is no translation for the page language in the company details, so the main language is used. Your custom title and chat lines are the same in all languages Fill in the language in the “Texts for customers in other languages” block of the company details, or clear your custom title (languages)
    An edit in a large text field was lost These fields are saved with the next edit of another field or when the window closes After editing the text, close the window, not the browser tab (saving)

    FAQ

    Why doesn't the welcome message work?

    There is no separate greeting field. The AI writes the first message of every new conversation for the page, using the store name from the company details (greeting).

    How do I change the consultant's name and photo in the chat?

    In the employee card, not in the widget form: the name, photo and “Brief description” come from there. The “Consultants” button in the widget form opens the employee list (consultants).

    How do I hide the chat from the site without removing the code?

    Turn off “Show AI chat” or choose the “Hidden” position — the chat button disappears, blocks keep working. Turn off “Activity” — the widget is disabled completely (what's the difference).

    Can I show the chat button only on mobile devices and not on desktop?

    No. There's no device choice either in the widget settings or in quick action buttons: whatever is on is visible on both phones and computers.

    Can I show a quick action button only on product cards?

    No. An active button is visible on all pages; you can only remove it from a page by disabling it completely (buttons).

    How do I make the AI always reply on its own without calling a manager?

    Turn on the “No operator” switch in the widget settings. The AI won't promise a manager's reply or hand the chat over to a person, and the call-a-manager button disappears from the site (details).

    How do I make the AI reply in the customer's language rather than the page language?

    In the “AI reply language” field, choose “Automatic: language of the customer's message”. You can also set one language for all replies there (options).

    Can a deleted quick action button be restored?

    No, a deleted button is gone for good. If you don't need a button for a while, turn off its “Activity”.

    Where to find it and who has access

    Menu
    Directories → Categories → “Catalog tools” block → “Widget settings - Smart Assistant” tile
    From the widget form
    “Setup” tab → “Consultants”, “FAQ”, “List of buttons”, “Channels & messengers” buttons
    Access right
    the form has no separate right; FAQ lists check their own rights
    Prepare
    a photo and a short intro for the virtual consultant, filled-in company details

    A store has one chat widget. When you open the window for the first time, the app creates the widget record itself, with “Activity” already on.

    Top of the chat widget settings window: tabs, switches and the row of list buttons
    1Activity
    2Show AI chat
    3Consultants
    4FAQ
    1. Activity — turns the whole widget off, including the blocks on pages.
    2. Show AI chat — hides only the chat button.
    3. Consultants — the list of employees the chat header is built from.
    4. FAQ — the list of frequent questions and their sections.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free