Skip to main content
The widget is the chat bubble that appears on your website. With it, your agent serves the people visiting you without them leaving your page.

What you will get

The widget working on your site: with your domain authorized, the code pasted on your pages, and the mode you want visitors to see.

Requirements

  • Access to edit your site’s code, or someone who does it for you
  • The exact domain where the widget will appear
The domain is mandatory, not optional protection. Eva only answers on the domains you authorize. If the list is empty, the widget works on none of your sites.

Install the widget

1

Open your agent's channels

In the sidebar go to AI Agents, open your agent and go to the Channels tab.
2

Open the widget

On the Chat Widget card, select Manage.
Chat Widget card showing the Domain setup required badge and the Manage button.

The widget card inside Channels.

3

Open the Install tab

The authorized domain and the code live there.
Style and Install tabs, with Install active and underlined.

The widget screen's two tabs, at the top left.

4

Authorize your domain

In Allowed domains, enter your site’s domain and select Add. Enter it without https:// and without paths. To cover every subdomain use the *.example.com form.
Allowed domains block with the domain field, the Add button and the empty list.

While the list says no domains are configured, the widget answers on no site at all.

5

Save

Select Save changes.
6

Copy the code

In Installation snippets, under Install with script, select Copy.
Installation snippets block with Install with script and its Copy button on the right.

The Copy button sits to the right of Install with script.

The snippet looks like this. Always copy the one from your own account — it carries your agent’s id.
7

Get it installed on your site

Send the snippet to whoever manages your website and ask them to install it on the pages where you want the widget to appear. That is the shortest path, and you touch nothing.If you manage the site yourself, paste the code right before the closing </body> tag on each of those pages. It looks like this:
8

Publish your site

Publish the changes and reload the page.

Install on your platform

In Eva’s Install tab, use the platform selector before copying the snippet. It takes you to the right flow; this article keeps a short reference for where to place it. First authorize and save your domain in Eva, and always paste the snippet copied from your own agent.
  • Shopify — if the store is connected to Eva, select Shopify and choose Activate in your theme. Eva opens the current theme editor with Eva’s app embed ready to preview; save the theme, open the storefront, and wait for Eva’s installation status to confirm it loaded. If the button is unavailable or the store uses a legacy custom app, keep the snippet path: go to Online Store > Themes > … > Edit code, duplicate your theme, open layout/theme.liquid, and paste the snippet immediately before </body>.
  • WordPress — use your theme’s or header-and-footer-code plugin’s footer setting. The location varies by theme; Eva’s selector points you to the flow for your site.
  • Wix — go to Settings > Custom Code, add the snippet to all pages, and choose Body - end.
  • Squarespace — open Code Injection, paste it in Footer, and save.
  • Webflow — go to Site settings > Custom code, paste it in Footer code, save, and publish your site.
  • Tienda Nube — connect its native Google Tag Manager integration, then add the snippet as a Custom HTML tag in Google Tag Manager and publish the container.
  • Another platform — look for custom code, scripts, or a footer area and paste the snippet before </body>. If you cannot find it, use Eva’s selector to share the instructions with your developer.

Choose what your visitors see

At the very top, the widget screen asks What will your visitors see? and offers three options. The choice shows in both tabs and changes what can be configured.
The Full chat, WhatsApp only and Off options, with Full chat selected.

The chosen option turns blue and explains underneath what it means.

  • Full chat — your visitors talk with your agent inside your site.
  • WhatsApp only — a button opens your WhatsApp. There is no web chat.
  • Off — nothing appears on your site. Existing conversations are kept.
With WhatsApp only or Off, the style settings are hidden because they no longer apply.

Adjust how it looks

The Style tab groups the settings into three blocks that open and close:
The Appearance, Messages and Behavior blocks closed, each with its summary on the right.

Each closed block summarizes its current setting on the right.

  • AppearanceBrand color, light or dark theme, and your own logos for the launcher and the header.
  • Messages — up to three bubbles that invite visitors to write before they open the chat.
  • Behavior — which corner the widget sits in and how much space it leaves from the edges. Also, which contact channels are shown above the bubble.
Brand color field holding #2563eb, and the Light and Dark theme options with Light selected.

Inside Appearance: the brand color and the theme the widget is drawn with.

Every change is reflected in the Live Preview on the right. The changes reach your site when you select Save changes.

How to know it worked

Publish the changes, open a page on your site, then return to Eva’s Install tab. The installation status confirms when the widget has loaded. With Full chat, the bubble appears in the corner you chose and your agent responds when you write. If you selected WhatsApp only, the status confirms that mode and the button opens WhatsApp instead of web chat.

If something goes wrong

Check that the domain is in Allowed domains and that you saved. A domain that is not on the list is blocked, even when the code is pasted correctly.
Changes reach your site when you select Save changes. After that, reload your site.
The Install tab has a Shareable link that opens the widget on an Eva page, with nothing to install.
In Behavior, change the corner or increase the spacing from the edges.

Next steps

Use the Inbox

Manage your contacts