¶ Visuals
¶ Widget Appearance
To customize the appearance of the widget, navigate to the Chat Icon section under the Appearance tab.
¶ Customizable Options:
-
Widget Size: Adjust the size using the
Size (px)option. The default size is set to 56px. -
Icon and Background:
You can retain the default icon (?) and modify the background usingBase ColororButton Gradient.
Alternatively, upload a custom icon (in SVG or PNG format) by selecting theUse a custom icon option.
If your uploaded icon has a plain background, the Base Color and Button Gradient settings will be ignored.
¶ Conversation appearance
You can adjust how the chat window looks by navigating to the Appearance tab.
¶ Customization options
- Define custom
colorsfor:
-- Bot messages
-- User messages
-- Send button
-- I still need help button
Typographysection
Customize the text style by choosing:
-- Font size
-- Font family (the font must already be installed on your instance)
¶ Pre-chat notification
You can make the widget more attractive to user with the pre-chat notification that will appear before the user even click on the chat icon. Enable it with the pre-chat sections on the general tab.
¶ Customization options
- you can choose:
-- the notification text
-- the font-size
-- the font-color
-- the pop-up color.
¶ Buttons
All buttons can be personalized. To do so, visit the Colors and Secondary Action Buttons sections under the appearance tab.
Secondary action button are used to reset a chat when the mail is sent or to send the email with no attachments.
¶ Bot messages
All messages sent from the bot are 100& customizable.
¶ Edit pre-chat text
Edit the pre-chat notification text in the Pre-chat Message section.
¶ Edit bot interactions
You can edit the greeting and the mail form messages in the Conversation Messagessections.
Conversion messages include how the bot ask the user name, email, messages and if he wish to add a attachment.
Various others messages can be edited as well :
- Search messages (when the bot is processing a request / when no result are found)
=>search experienceunder the behavior tab. - Systems messages (Invalid Email, Sent (Success), Sent (Error), Reset Button Label, No-Attachment Button Label)
=>sytems messagesunder the behavior tab.
¶ Fine-tune bot behaviour
¶ Choose search scope
You can select which articles or pages should appear in the search result.
¶ Articles
By default, the plugin search for result across all categories.
You can define which category should appear in result.
¶ Pages
By default, the plugin search is not referencing any pages in the search result.
You can make all pages available or choose all some of them.
¶ Set on which pages/articles the bot will appear
By default, the chat widget is visible across your entire site.
¶ Pages and Articles
You can control its visibility by selecting specific pages or articles where the widget should:
- Always appear (enabled only on those pages), or
- Be hidden (visible everywhere else except those pages).
¶ Taxonomy (Category, Tags, Post-type)
You can control its visibility by selecting specific taxonomy terms where the widget should:
- Always appear (enabled only on pages with a matching taxonomy terms), or
- Be hidden (visible everywhere else except those pages).
¶ Stop-list
A Stop List is a collection of common words that the search engine will ignore when processing queries. These words (e.g., he, she, it, the, a, an, and) are often too generic to improve search accuracy.
By excluding them, the search focuses only on the meaningful terms entered by the user.
This helps deliver more relevant results and avoids clutter from unhelpful matches.
Example
User searches for: “the best guide for her”
After applying the Stop List, the search query becomes: “best guide”
¶ Security
¶ Google ReCaptcha v3
Emails sent through the chat widget can be secured with Google reCAPTCHA v3 to prevent spam and automated abuse.
¶ How it works
reCAPTCHA v3 runs in the background without interrupting the user.
Each request gets a score (0.0 = likely bot, 1.0 = likely human).
The widget checks this score before allowing an email to be sent.
Suspicious requests are blocked to protect your inbox.
¶ Configuration
To enable reCAPTCHA v3, you need to set up your credentials in Google’s reCAPTCHA Admin Console:
- Create a new reCAPTCHA v3 key for your domain.
- Copy the Site Key and Secret Key.
- Add these keys in the
securitytab .
¶ Mail Attachments
The chat widget allows users to send attachments when submitting an email.
¶ Authorized File Extensions
You can configure which file types are allowed.
By default, only safe formats such as .jpg, .jpeg, .png, .gif,. webp are enabled.
Executable or potentially harmful formats (e.g., .exe, .bat, .js) should be avoided for security reasons.
¶ File Size Limits
You can also set a maximum file size per attachment.
