Skip to main content
The WOWagent chat widget is a small script that shows your AI assistant on your website. This page explains how to add the script on WordPress, through Google Tag Manager (GTM), or on a custom-built website, and how to verify it so live chat works.
Live chat does not appear on your website until the widget shows Verified in the Integration Center.

​
Before You Start

  • Add your website to WOWagent first. See Add Your Website.
  • Select the correct website in the website switcher. Each website has its own script with its own data-key.
  • In Chatbot Management, make sure Public widget status is ON. If it is OFF, the widget stays hidden even when the script is installed.
  • Make sure you have access to edit your website, or ask the person who manages it to help.

​
Step 1: Copy Your Widget Script

1

Open Integration Center

Open https://portal.wowagent.ai/website/integrations.
2

Find the Website Widget card

Find the Website Widget card for your selected website.
3

Copy the script

Click Copy Script. The script includes a data-key that links the widget to your website.
Do not edit the script. If the data-key is changed or belongs to another website, verification fails.

​
Step 2: Add the Script to Your Website

Add the script site-wide so it loads on every page, just before the closing </head> tag. Choose the option that matches how your website is built.
1

Open a header code plugin

Use a Header and Footer plugin, or a Custom HTML option, that adds code to every page.
2

Paste the script in the header

Paste the script into the site-wide header section.
3

Save and clear cache

Click Save, then clear your website cache and any CDN cache.
If your website is a single-page app (built with tools like React, Vue, or Next.js), also set up Page Re-initialization so the widget keeps working when visitors move between pages. See AI Navigation.

​
Step 3: Verify the Widget

1

Click Verify

Go back to the Integration Center and click Verify on the Website Widget card. WOWagent opens your live website and checks for the script with your data-key.
2

Wait for the status to turn green

Wait 10 to 30 seconds. The card must show that the installation is detected and the status is Verified. Do not leave the page before it turns green.
3

Check your live website

Open your website in an incognito window. The chat bubble must appear in the bottom corner. Test that it opens and closes, and check it on mobile too.

​
If the Widget Does Not Appear

Check that the script is on the correct website and that the data-key matches the selected website. Make sure the script is in the site-wide header, not on a single page.
Clear your website cache and CDN cache, then check again in an incognito window. Make sure Public widget status is ON in Chatbot Management.
Turn off your ad blocker while testing. Ad blockers can hide the widget.
Check that the tag uses the All Pages trigger, that the container is published, and that the same container is connected in the Integration Center.
Theme changes and redesigns often remove the script. Paste it again, then click Verify again.
If your website’s security settings block outside scripts, allow the WOWagent script in those settings and verify again.
If the issue continues, create a support ticket at https://portal.wowagent.ai/support-tickets. Include your website domain, how you installed the script, and a screenshot of the Website Widget card status.

​
Next Steps

Chatbot Management

Set your assistant’s name, greeting, tone, and style.

Knowledge Base

Train your assistant with your business details.