Website widget

The widget shows a chat button and conversation window to website visitors. Customers write from the website, while operators reply from EasyChat or the Android app.

The live widget on easychat24.ru uses the same runtime as an installed EasyChat widget. Open it on any EasyChat website page to preview the visitor experience before installing the module. On the desktop homepage, the demo window opens after three seconds. It stays collapsed on phones so it does not cover the page. On a customer’s website, automatic opening follows that site’s own widget settings.

See the illustrated EasyChat appearance guide.

Where The Widget Works

The widget works on the domain where EasyChat is installed and on allowed subdomains. For example, if EasyChat is installed for example.com, the widget can be used on example.com, shop.example.com and other subdomains.

If you need the widget on another domain, check license settings or contact EasyChat24 support.

Widget Language

Open widget settings in the EasyChat admin panel.

• Choose a fixed language when the website uses one language.
• Enable automatic selection when visitors come from different countries.

Automatic selection changes only the widget interface: buttons, hints and errors. Visitor messages are not translated automatically.

Button Position

Choose the screen side and offsets in settings. On desktop, the chat window opens near the button. On phones, the window takes almost the whole screen so visitors can read and type comfortably.

If a visitor manually drags the window on desktop, the browser may remember its position.

Greeting And Contacts

The top of the opened widget can show a greeting, operators and contacts. The visitor can collapse this block to see more of the conversation. On desktop, the block expands each time the widget is opened. On a small screen, it starts compact but can always be expanded with the arrow button. Loading older messages does not collapse it automatically.

If you have a single operator or prefer not to display operator avatars in the header, disable the “Display operators in widget header” option in widget settings. The widget will hide the operators block and stop background requests checking operator online status.

If you want to keep the team block but show only selected people, open Operators, edit the employee and turn off Display in widget header. This choice is separate for every operator and administrator and does not stop them from working in EasyChat.

Use a short greeting. It should help start the conversation, not repeat the company description.

Messages, Links And Formatting

Signed-in customers and orders

On supported CMS platforms, EasyChat recognizes the customer who is signed in to the website. The visitor does not need to enter their email again: the header shows Signed in as … ✓, while the operator receives the verified name, email and phone from the website profile. When order context is enabled, a first question such as “Where is my order?” already belongs to the exact customer.

If the visitor wrote as a guest and signs in later, EasyChat keeps one conversation. Signing out or switching to another website account never gives the new user access to the previous private history.

The widget header shows the operator and their status. A long operator name wraps neatly to no more than two lines, so it does not squeeze the conversation. It also gives visitors a response-time guide: values below ten minutes stay exact, while a longer average is shown calmly as ~10 min. EasyChat keeps the exact value in its internal analytics.

The widget supports regular messages, line breaks and clickable links. A plain https://... address becomes a link.

A Markdown link is displayed clearly too: for example, [link to our RuTube channel](https://rutube.ru/...) is shown as clickable text link to our RuTube channel.

Links open in a new tab and are processed safely. Unsafe HTML is not executed.

There is no separate link-color setting. EasyChat uses the accessible text foreground of the bubble that contains the link and keeps an underline, so the link remains readable immediately after a brand-color or theme change.

When a visitor has actually seen an operator reply, EasyChat can show the operator a Read receipt. Merely downloading the message is not enough: the widget must be open, the browser tab active, and the reply bubble visible for a short moment. A hidden tab or a quick scroll therefore does not create a false confirmation.

Files And Images

Visitors and operators can exchange images and PDF, DOC, DOCX, ODT, ODS and ODP documents. PDF previews open in the conversation viewer, while Word/OpenDocument files use clear format cards. The original file is downloaded only after an explicit user action.

If a file fails the type or size check, EasyChat shows a clear error.

If a legacy attachment has stale technical metadata, EasyChat identifies the image from its verified MIME type and extension. The widget falls back from a thumbnail to the available preview; if the file is temporarily unavailable, it shows a clear state instead of an empty card.

When EasyTokens is selected and the AI assistant is enabled, a photo can become part of the question: AI considers the image, caption and previous messages. For privacy, EasyChat prepares a smaller metadata-free copy and does not expose the file URL. Visual replies use the normal background queue, so closing the tab does not interrupt processing.

On the official EasyChat site, the support assistant starts preparing an answer immediately through a separate asynchronous request after a question is sent. It does not wait for a scheduled cron run; the widget keeps a clear preparing indicator until the verified answer is available.

Visitor Notifications

The widget header has a bell. A visitor can enable notifications after the first message, when EasyChat already knows which conversation the subscription belongs to.

Check:

1. Open the widget.
2. Send a test message.
3. Click the bell.
4. Allow notifications in the browser.
5. Reply from EasyChat.
6. Make sure the browser shows the notification.

Test notifications in a regular browser window. Browsers may behave differently in private or incognito mode.

Resource Saving

When the visitor is actively reading or typing, the widget refreshes the conversation quickly. It then enters background-tab saving mode: an open idle chat checks for replies about every 30 seconds, while a closed or hidden chat checks no more often than every 60 seconds. With notifications enabled, a hidden tab can sleep completely until a push arrives.

When the visitor returns to the tab, opens the widget or starts typing, fast synchronization resumes.

When a visitor clicks a push notification, EasyChat opens the chat. It requests new messages right away and places the cursor in the message field. If the AI reply uses a delay, the widget puts the delayed AI reply into the server queue, so closing the tab does not interrupt processing.

After sending text or multiple files, the widget immediately reconciles the conversation with the server. If an operator replied at nearly the same time, that reply remains in order and appears without reloading the page.

Check After Setup

1. Open the website in a new browser window.
2. Press the chat button.
3. Send a test message.
4. Reply from the admin panel or Android app.
5. Check that the reply appears in the widget.
6. If needed, check a file, link and notification.
7. Sign in with a test store account and send the first order-related message: the name should appear without an email form, and EasyChat should show the profile email and phone.
8. Test “guest message → sign in → another message” and confirm the admin panel still shows one conversation.

Common Situations

• The button is not visible. Check that the widget is enabled, the code is added to the right page and site cache is cleared.
• The widget uses the wrong language. Check fixed language or automatic selection in settings.
• Notifications do not turn on. Check HTTPS, browser notification permission and try a regular non-incognito window.
• A file is not sent. Check file type and size.
• Messages arrive with a delay. Check the EasyChat background task on hosting.

Quick Checklist

• The widget is enabled in the admin panel.
• The button is visible on the website.
• Language and position fit the website.
• A test conversation was created.
• The operator reply is visible to the visitor.
• Link, file and notification are checked if needed.