How the chat looks

In the project's «Widget» section you set how the chat looks and sounds to your visitors: colours and font, languages, the greeting, the hint and the sounds. Beside the fields is the preview: the real chat with your changes. On a phone, the preview comes right after the colours. Owners and admins change everything here; operators see the same values as text.

You don't touch your site's code. The chat takes its settings from the server, so the two lines of the install stay as they are (Install on a site). Visitors see a change within two minutes, on the next page they open.

Colours and font#

When you create the project, we read the colours and font from your site's home page, so the chat looks like part of the site. The block «Colours and font» shows the accent, «Light or dark» and the font; the background, text, corners and send button are under «Advanced settings»:

• Accent: the chat button, the visitor's messages, links to sources.
• Background and Text: the colours of the chat window itself.
• Font: font names separated by commas, as in CSS (Inter, sans-serif). If empty, the chat uses the visitor's system font.
• Corners: the window's corner radius, 0 to 24 px. If empty, the radius is taken from your site's buttons, and you see it in the field. Buttons and fields inside the window follow it, so their corners stay nested. It saves on its own when you stop typing.
• Send button: the icon on it, an arrow up (the default), a plane or an arrow right. Pick what suits your site. It saves at once.

Each colour has a picker and a field for its value (#ffd828). A colour saves on its own as soon as you pick it. The font saves when you leave its field. An empty colour field shows «Auto»: the chat picks that colour to match the background.

Whatever you set, the chat keeps text readable:

• if the text colour is too close to the background, the chat replaces it;
• if the accent is too light to read as text (a yellow, say), it stays on the buttons and links take the text colour.

Two more buttons in this block:

• «Read from the site again» reads your main site's home page again, for example after a redesign. If the home page gives nothing to read, the colours don't change.
• «Use the widget’s own colours» clears the colours and font, both those set here and those read from the site. The chat goes back to its own neutral colours. «Read from the site again» brings the site's colours back.

The main site is the first site in «Knowledge» (Knowledge base).

The preview#

The preview is the real chat: the same widget.js your site loads. It runs on a page our server signs for the values in the fields, saved or not.

Nothing is sent from the preview. A message typed there reaches nobody, starts no conversation and never counts in «Reports».

The «AI answers» mark always shows, here and on your site. You can't turn it off: a visitor always knows an AI is answering (How Tolkly answers).

The preview reloads a moment after you stop typing. If «Language» has more than one language, a switch appears above the preview. It shows the chat as a page in each language sees it.

Language#

In the block «Language» you say which languages your site is in. The chat speaks the page's language (its <html lang>) if it has an interface in that language. It has 15: English, Russian, Armenian, Kazakh, Uzbek, Azerbaijani, Georgian, Kyrgyz, Tajik, Ukrainian, Turkish, German, Spanish, French and Portuguese. Otherwise the chat speaks the primary language: a Polish page of a Russian site gets the chat in Russian, not English.

• «Primary language»: the language of most of your pages. If it is not set, the chat follows the page and speaks English in other languages. There is then one greeting for every page.
• «Other languages of the site»: the other languages, added with «Add». Each one gets its own greeting and hint below. If you remove a language, its texts are removed too, after you confirm.
• «Chat’s words» (under «Advanced settings»): «By the page’s language» or «Always in the primary language». You need the second one when your pages name the wrong language. For example, a template puts lang="en" on Russian pages.

The bot's answers don't depend on this block: the bot answers in the language of the question. The quotes under an answer stay word for word, in the language of the page they come from. If a conversation's language differs from the primary one, it shows in the inbox and in the Telegram topic (Inbox).

The greeting#

The greeting and the hint over the chat share one block, «Chat texts». Each field saves when you leave it.

The greeting is the chat's first line, in your words. Say what visitors can ask about, for example «Hello! Ask about exchange rates, limits and how long a transfer takes.» Up to 400 characters.

With other languages set, you write the greeting on a separate row for each language. If a row is empty, the chat shows its own line in the page's language, saying that an AI assistant answers. A page in a language not on the list gets the primary language's greeting.

The hint#

«Hint over the chat» is a short line beside the closed chat. It shows once per visit. Like the greeting, you write it separately for each language. An empty row means no hint in that language. A page in a language not on the list gets the primary language's hint. The teaser attribute on the tag wins over this setting (Attributes).

Frequent questions#

«Frequent questions» are buttons the visitor sees when the chat opens, on their side at the bottom, next to the reply field. A press sends the question as the visitor's own message, and the bot answers it as any other: from your sources, with a link, or it hands the conversation to people. A page shows 4 at most, up to 60 characters each; the project keeps up to 12. They go away after the visitor's first message. The block shows the questions as the chat does; drag one by the dots at its left to set the order (or focus the dots and press ↑ ↓). Press a question to edit it: a tab per language, where it shows, «Remove».

Under «On every page» you can keep a question to some pages: «Only on pages» takes the start of a page's address after the domain, as /exchange/, and * stands for any characters (/exchange/btc-*). A page shows its own questions first, then the ones for every page.

Each question saves when you leave its field, and is then tried through the bot. Its row says what the bot does with it: «Answers with a quote», «Goes to people» (a person asked for, one of your topics, the order status), or «The bot has no answer». The last one is worth fixing: the chat would offer a question and then refuse it. Add the answer to Knowledge and press «Check again». A check is one paid answer per text, and it starts no conversation.

With other languages set, each question has a row per language. A page in a language without its own text gets no button for that question: a button in the primary language would start the conversation in it. A page may set its own questions instead (Suggested questions).

Under the list, «Asked in conversations» offers the approved knowledge drafts the most asked first: their answers are sources already, so the bot answers them. A press adds the question.

Each press is kept with its conversation. «Reports» lists every question with its presses and how those conversations ended; a question nobody presses is worth replacing.

Position#

«Position» (at the foot of the page, under «Advanced: position») puts the chat in the bottom right or bottom left corner. It also sets the gaps from the side and the bottom of the page: 0 to 400 px, 20 by default. Lift the chat if a tab bar or a cookie banner covers the button. The preview shows the open window, so you only see the corner on your site. A page can set its own position, including for phones only (Placement).

Sounds#

The chat plays a short signal when a reply comes and the visitor isn't looking at the chat: it is minimized, or the tab is in the background. A visitor can turn sounds off for themselves right in the chat, and their choice wins over yours.

«Play sounds» turns sounds on and off for everyone. If you turn them off, the settings below are kept until you turn them on again. Every change saves at once.

Under «Advanced: which replies, signal and volume»:

At most one signal every 3 seconds, across all of a visitor's tabs.