What your visitors get

The window, the answers, typing, the conversation kept in the browser, and how the chat sits on your page.

A button at the bottom right of your pages opens the chat. This is what your visitors find in it.

01 · The window
  • Size. 380 by 600 pixels at the bottom right on a computer. On screens up to 480 pixels wide it fills the screen and stays above the on-screen keyboard.
  • The header. Your logo and title, ? for the commands, New chat and the close button.
  • Resizing. Drag the corner mark at the top left of the window, or focus it and use the arrow keys. The size is remembered in that browser.
02 · The answers
  • Written as they come. Before the first words, a line says what the assistant is doing, such as Searching for: … or Reading the document ….
  • Following the answer. The window scrolls with the answer. A visitor who scrolls up to read stays there until they scroll back to the bottom.
  • Formatted. Paragraphs, lists, tables and code. Links open in a new tab, so the conversation stays where it was.
  • With their sources. Every answer links the pages, products and PDF pages it uses. The sources at the end of an answer are shown as small pills, one per line, under a thin line. A long title is cut short and shown whole when the mouse is over it, and a click opens the page in a new tab. When an answer links none of the pages it used, Opensolr adds them at the end.
  • Good or bad. Under each answer of the assistant and each translation, two buttons rate it; clicking the pressed one again takes the rating back. Ratings show in the Stats and the History.
03 · Typing
  • Enter sends, Shift and Enter starts a new line.
  • Arrow Up and Arrow Down bring back the questions sent earlier.
  • A / at the start opens the list of commands.
  • Escape steps back: from the table of language codes to the list of commands, then closes the list, then the window.
  • One question at a time. While an answer is written, the message box, Send and New chat wait.
04 · The conversation
  • Kept in the visitor’s browser, its last 100 messages. It survives a reload and a move to another page of your site, and it is the same in every tab of your site. A window left open stays open on the next page.
  • Follow-up questions reach the assistant with the conversation before them. See Assistant settings.
  • New chat empties it and starts over.
  • The captcha, when it is on, comes before the first question. See Captcha.
05 · When something goes wrong

Each problem is said in the chat window: a message that is too long, a full conversation, a lost connection, an answer that stops coming for 45 seconds, or one that takes more than 3 minutes. The visitor only has to ask again. The messages and what to do about them are on Troubleshooting.

06 · How it sits on your page
  • The chat lives in an isolated part of the page (a Shadow DOM): your stylesheets do not restyle it, and it does not change the look of anything of yours.
  • It takes the font of your page, so it reads like the rest of your site.
  • It stays above your content, and it is left out when the page is printed.
  • The texts of its own buttons and messages, such as New chat or an error, and the answers of the commands are in English. Your own texts from the Chat window tab are shown as you write them.

Visitors of the hosted chat get exactly the same window: What your visitors see.

On your site

The Opensolr Chat Bot Client is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the client itself belong on GitHub.

Opensolr Chat Bot Documentation