Configuration

The Evercom widget is configured through a window.EvercomWidget object that you define before the install script tag.

<script src="https://widget.evercom.app/a3f2b1c9.js" async></script>

To configure the widget, declare window.EvercomWidget first, then load the script:

<script>
  window.EvercomWidget = {
    locale: 'en',
    position: 'bottom-right',
    button_selector: '#open-chat'
  }
</script>
<script src="https://widget.evercom.app/a3f2b1c9.js" async></script>

Options

Option	Value	Description
locale	en, ru, zh	Widget interface language.
position	bottom-right, bottom-left	Default button position.
button_selector	CSS selector	Your own element that opens the chat. The default button will be hidden.
user	object	Current site user data.
user_token	string	User token, if user verification is enabled for your account.

The user and user_token options are covered on the User identification & verification page.

Language

Set locale to control the widget interface language. Supported values are en, ru, and zh.

Button position

Set position to place the default button in the bottom-right or bottom-left corner of the page.

Custom open button

Use button_selector to open the chat from your own element. When set, the default button is hidden.

<button id="my-chat-button">Message us</button>

<script>
  window.EvercomWidget = {
    button_selector: '#my-chat-button'
  }
</script>
<script src="https://widget.evercom.app/a3f2b1c9.js" async></script>

Workspace widget settings

Some options are configured in your Evercom workspace under Settings → Widget rather than in the page script. There you can manage:

• The install code.
• The default language.
• The accent color.
• The lead form fields and timing.
• Message rating visibility.
• Tickets.
• Knowledge base visibility.
• Optional user verification.