> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.quizell.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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)

![](https://storage.crisp.chat/users/helpdesk/website/-/9/c/4/e/9c4e823823ced00/image_26nj8x.png =1000x657)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/9/c/4/e/9c4e823823ced00/image_ldgg52.png =1000x657)

### 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&#32;`</body>`&#32;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?

* [How the Quizell AI Sales Agent Works](https://help.quizell.com/en/article/how-the-quizell-ai-sales-agent-works-ceoavy/)
* [How to Customize Your AI Sales Agent Design](https://help.quizell.com/en/article/how-to-customize-your-ai-sales-agent-design-1wczgur/)
* [How to Test Your AI Sales Agent (Preview Mode)](https://help.quizell.com/en/article/how-to-test-your-ai-sales-agent-preview-mode-1rvaspb/)
* [How to Train Your AI Sales Agent](https://help.quizell.com/en/article/how-to-train-your-ai-sales-agent-1m69624/)
* [How to Create Your First AI Sales Agent](https://help.quizell.com/en/article/how-to-create-your-first-ai-sales-agent-zgltjg/)
* [Understanding AI Sales Agent Credits & Billing](https://help.quizell.com/en/article/understanding-ai-sales-agent-credits-billing-aawwbv/)

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