Web Chat Widget

Install and customize the Ares chat widget on your website with domain whitelisting.

The Ares Chat Widget is an embeddable JavaScript widget that adds AI-powered chat to your website.

Installation

Step 1: Whitelist Your Domain

Go to Settings → Domains and add your website domain:

  1. Enter your domain (e.g., example.com — no https:// prefix)
  2. Click Add
  3. Copy the generated Site Key

Step 2: Add the Embed Code

Add the following snippet to your website, just before the closing </body> tag:

<script
  src="https://widget.ares.onl/ares-widget.js"
  data-site-key="YOUR_SITE_KEY"
  async
></script>

Replace YOUR_SITE_KEY with the site key from Step 1.

Step 3: Verify

Open your website — the chat widget should appear in the bottom-right corner. Click it to start a test conversation.

Domain Whitelisting

The widget only works on whitelisted domains. If you see a connection error, verify:

  • The domain matches exactly (including subdomains)
  • The site key is correct
  • The domain is active in Settings → Domains

Customization

The widget automatically inherits your AI agent's configuration:

  • Primary Color — set in Build → Identity
  • Assistant Name and Title — set in Build → Identity
  • Welcome Message — set in Build → Identity
  • Language — set in Build → Behavior

Multiple Domains

You can add multiple domains, each with its own site key. All domains share the same AI agent configuration. This is useful for staging and production environments.

Was this page helpful?