How to Add the Quizell AI Sales Agent to Your Website

Introduction

Once you've created, trained, designed, and tested your AI Sales Agent, the final step is putting it live. Quizell gives you a small snippet of code to paste into your website — once it's in place, the agent's trigger button appears on your site and starts talking to visitors.

The snippet works on any platform that lets you add custom code, including Shopify, WordPress, Wix, Webflow, and more.

Step-by-step guide

1. Make sure your agent is ready

Before connecting, confirm your agent is good to go:

It's set to Active (Basic settings)
It's trained with a quiz, instructions, and/or FAQ
You've tested it in preview and you're happy with how it behaves

2. Open the connect window

In the AI Agent Editor, click Connect AI agent to your website (top-right corner)

A window opens titled "Connect the widget to your website"

3. Copy your embed code

The window shows a code snippet that already contains your agent's unique key. It looks like this:

<script>
  window.__agentWidget = {
    agentKey: "YOUR_AGENT_KEY"
  };
</script>
<script src="https://agent.quizell.com/agent-widget.js"></script>

Click Copy code to copy it to your clipboard

The agentKey is unique to this agent, so always copy directly from this window rather than reusing code from elsewhere.

4. Paste the code into your website

Paste the snippet just before the closing </body> tag of your site. Where you do this depends on your platform:

Shopify — In your admin, go to Online Store → Themes → Edit code, open theme.liquid, and paste the snippet right before </body>.
WordPress — Add it before </body> in your theme's footer template, or use a "header & footer scripts" plugin and paste it into the footer/body section.
Wix / Squarespace / Webflow — Use the platform's custom code / embed feature and add the snippet to the site footer (body) so it loads on every page.
Any other platform — Add it to a global footer area or anywhere before the closing </body> tag.

5. Save and publish

Save your changes
Publish your site or theme if your platform requires it

6. Check that it's live

Visit your website and look for the agent trigger button
Allow up to 5 minutes for it to appear — the live widget runs on a 5-minute cache

That's it!

Your AI Sales Agent is now live and ready to engage visitors. 🎉

What happens next

The agent greets visitors and runs your quiz, instructions, and FAQ
Real conversations start appearing in your Analytics
You can keep editing the agent — changes go live within 5 minutes, no need to re-paste the code

Best practices

Add the snippet site-wide (in a global footer) so the agent is available on every page.
Test on desktop and mobile to make sure the trigger button doesn't overlap your cart, menu, or other key elements — adjust its position in the Design tab if needed.
Add the code only once. Pasting it in two places can cause the widget to load twice.
Re-test after going live. Run a quick conversation on your real site to confirm everything behaves as it did in preview (remembering the 5-minute cache).

Important notes

The agentKey in the snippet is unique to your agent — copy it from the connect window each time.
Your agent must be set to Active to appear on your site.
Edits made in the dashboard appear instantly in preview but take up to 5 minutes to show on the live widget. You don't need to re-paste the code after editing.
Preview testing is free; live conversations consume credits. You can check your balance, buy credits, and manage auto-recharge under AI Agent → Billing.

Troubleshooting

The widget isn't appearing on my site

Confirm the agent is set to Active.
Make sure the snippet is placed before the closing </body> tag and that you saved/published your site.
Allow up to 5 minutes for the live cache, then hard-refresh.

The widget appears twice

The snippet is likely pasted in more than one place. Remove the duplicate so the code loads only once.

It works in preview but not on my live site

Confirm the code is on your published theme/site (not just a draft).
Wait for the 5-minute cache and hard-refresh.

The trigger button overlaps something on my page

Change its Position in the Design tab (e.g., from Bottom Left to Bottom Right).

What's next?

Your agent is live — now keep refining it using your analytics and visitor conversations.

Updated on: 03/06/2026

Was this article helpful?

Thank you!