Skip to main content
Connect Web

Connect Web — Embed, Style and Test Your AI Agent on your website

Written By Maruf Ansari

Last updated 2 days ago

Add your AI Agent to your website as a chat or voice widget, then match its colours and placement to your site. This guide covers copying the Embed Code, configuring Customise Styling, saving the Agent and testing the published widget.

Connect Web Overview

Connect Web allows Business users to add an AI Agent to their website through an embedded chat and voice widget. You can copy the selected Agent's Embed Code, add it to your website's <head> section, and customise the widget's button color, icon color, screen position, and spacing.
The widget uses the Agent's configured identity, conversation flow, and connected Knowledge Bases. After saving the configuration, you can verify that both Chat and Voice work correctly on your published website.

Website installation may require assistance from a site administrator or web developer.

Copy and install the Embed Code

1

Open Configure → Connect Web on the agent you want to embed. Under Connect Agent to website you'll see a ready-to-use script. Click Copy Code.

The YOUR_AGENT_ID value in the script is unique to this agent — do not change it.

Agent → Configure → Connect Web
2

Paste the script inside the <head> tag of every page where you want the widget to appear. Most website builders (WordPress, Webflow, Shopify, Wix, custom sites) have a "Custom code in head" or "Header scripts" setting for exactly this.

Once saved and published, the widget appears in the corner of your site:

3

Visitors can:

  • Chat — start a text conversation with the agent.

  • Voice — talk to the agent in real time, just like a phone call.

Customise the widget styling

1

Expand Customise Styling below Connect Web.

2

Set Button Color and Icon Color. Check that the icon remains easy to see against the button.

3

Under Embed screen position, choose Bottom Left, Bottom Center or Bottom Right.

4

Enter Bottom Spacing and Side Spacing in pixels to separate the widget from the page edges or nearby controls.

5

Select Save on the Configure page, then reload your published website and review the result.

Field or Option

Purpose

Example or Limitation

Embed Code

Loads the widget and connects it to the selected Agent.

Copy the complete script without changing its values.

Button Color

Sets the launcher button colour.

Choose a colour with sufficient contrast against both the icon and page.

Icon Color

Sets the launcher icon colour.

Keep it clearly visible against Button Color.

Embed screen position

Sets where the widget renders.

Bottom Left, Bottom Center or Bottom Right.

Bottom Spacing

Adds space above the bottom edge.

Measured in pixels. Product validation required: Confirm allowed values and defaults.

Side Spacing

Adds horizontal space from the relevant side or position.

Measured in pixels. Product validation required: Confirm allowed values, defaults and Bottom Center behavior.

Expected result

The widget appears at the selected bottom position with the configured colours and spacing. Visitors can open the available Chat or Voice experience for the selected Agent.

Verify the result

  1. Open the published website in a new browser window and confirm the widget's position, colours and spacing.

  2. Send a test question through Chat and check the answer against the connected Knowledge Base.

  3. Start a Voice test and confirm the Agent uses the intended voice and greeting.

  4. Review the resulting Chat Logs and Call Logs for the test conversations.

Troubleshooting

Problem or Symptom

Likely Cause

Solution

The widget does not appear.

The script is missing from the page head, or the website has not been published.

Check the complete script placement, publish the site and reload.

The widget appears on only one page.

The script was added to page-specific settings.

Move it to the site-wide <head> settings and publish again.

The wrong Agent answers.

The Embed Code came from another Agent.

Copy the code from the intended Agent and replace the existing script, then publish and retest.

The Agent gives an incorrect answer.

A required Knowledge Base is not connected, or its content is incomplete or conflicting.

Review the Knowledge node and the source Knowledge Base, then publish and retest.

Styling changes do not show.

The Configure page was not saved, the page is cached, or propagation is delayed.

Select Save, reload in a fresh browser window and republish the website if needed. Product validation required: Confirm update timing and cache behavior.

The widget covers another control.

The selected position or spacing conflicts with the website layout.

Choose another bottom position or adjust Bottom Spacing and Side Spacing, save and verify on desktop and mobile.

Recovery or rollback

To remove the widget, delete its script from the website's <head> and publish the site. To switch Agents, replace the script with the intended Agent's Embed Code. To correct styling, restore the previous colours, position and spacing manually and select Save.


Frequently Asked Questions

Usually no. Almost every website builder has a setting for adding custom code to the <head>. If you're on a fully custom site, any developer can paste it in a couple of minutes.

Yes, as long as the script is in the site-wide <head>. If you paste it on a single page only, it will appear only on that page.

The script is bound to one agent via its ID. If you want to swap to a different agent, copy the new agent's script from its Connect Web tab and replace the one in your <head>.

No. Styling and position changes take effect automatically — the script always loads the latest configuration.

Yes. Conversations from the web widget use the same identity, voice and Knowledge Base you've configured for this agent — so test it from the Knowledge module before going live.

Yes. Visitors choose Chat for text or Voice to talk to the agent live, right inside the widget.


Related articles

Was this helpful?

Still need help? Ask the team