Get it live
The widget isn't showing on your site
You'll find what is stopping the chat bubble and get it answering visitors again.
Before you start
- You can sign in to your Adoomi dashboard
- You can open your own website in a browser
- You have already pasted the snippet, or you can ask whoever built the site How to check
About 10 minutes. You’ll do five things:
- check your allowed domains
- check the bot is active
- reload after a saved change
- check the snippet is in the published page
- check your builder kept it
Two things can go wrong here, and they look different on your site. No bubble at all means the script never reached the page. A bubble that replies with an error means the script loaded fine, but Adoomi blocked the message. Work out which one you have first — that alone rules out most of the causes.
Start here
Open your live website in a new private window.
A private window rules out anything your browser cached earlier.
Look at the bottom corner, then send the bubble one short message.
| What you saw | Check this first |
|---|---|
| The bubble is there, but the reply is an error | Your allowed domains, then your bot's status |
| There is no bubble on any page | The snippet in your published page, then your builder |
| The bubble is there, but shows old wording or the old colour | A saved change that has not refreshed yet |
| Builder | Where the snippet goes |
|---|---|
| WordPress | Appearance → Theme File Editor → footer.php, or a header/footer scripts plugin. |
| Wix | Settings › Custom Code. Add the script to Body-end, then choose all pages. |
| Squarespace | Settings › Advanced › Code Injection. Paste the script into Footer. |
| Webflow | Project Settings › Custom Code. Paste the script into Footer Code. |
| Shopify | Online Store › Themes → Edit code, then theme.liquid, just before the closing </body> tag. |
If it didn’t work
Your site's domain isn't in the allowed list
- Check
- In the left sidebar click Bots, then click your bot's row. Compare Allowed domains (comma-separated) with the address in your browser bar.
- Fix
- Add your bare domain — example.com, not www.example.com — and click Save. The bare domain covers www.example.com and shop.example.com too; listing only the www version does not cover the bare one.
- Resolved when
- Reload your site and send another message. A real answer comes back instead of an error.
The bot isn't set to active
- Check
- On the same General settings page, read Status. Draft and paused both stop answers.
- Fix
- Choose active and click Save.
- Resolved when
- Reload your site and send another message. The reply arrives instead of "Something went wrong. Please try again."
You changed something and can't see the change
- Check
- Your saved colour, name or opening line still looks like the old one on your site.
- Fix
- Wait about a minute, then reload the page. Adoomi holds the widget's settings for up to 60 seconds, and an already-open visitor tab picks up the change when it reloads.
- Resolved when
- The new colour, name or opening line shows on your site.
The snippet isn't in the page your visitors get
- Check
- Open your live site in a private window, view the page source, and search it for widget.js.
- Fix
- If widget.js is not there, paste the snippet again just before the closing </body> tag, then publish or save the site. Editing a page is not the same as publishing it.
- Resolved when
- widget.js appears in the page source and the bubble shows in the corner.
Your site builder stripped the script out
- Check
- Reopen your builder's custom-code box and see whether your snippet is still in it.
- Fix
- Paste it back into that box rather than into a page's own content, save, and publish. If your plan has no such box, the website builder has to switch custom code on before anything can go there.
- Resolved when
- The snippet is still in the box after a reload, and widget.js appears in your page source.
None of these fixed it
- Check
- You have checked all five and the bubble still does not answer.
- Fix
- Email hello@adoomi.ai with three things: your website address, your bot's name, and whether you see no bubble or an error reply.
- Resolved when
- A person at Adoomi replies with the cause and what to change.
What this can’t do
- An empty Allowed domains (comma-separated) field blocks every site at once. Adoomi fails closed on purpose, so there is no allow-everything setting.
- A local test does not count as an install. Adoomi ignores localhost and 127.0.0.1.
- Adoomi cannot tell you which of your pages carry the snippet, so check a second page yourself.
- Adoomi cannot see inside your website builder. If your plan has no custom-code box, the snippet has nowhere to go until that box exists.
Next steps
Install Adoomi on any website
The snippet, where it goes, and the iframe route if a bubble is not what you want.
Allowed domains explained
Which addresses one entry covers, and why an empty list blocks everything.
Go live in about 10 minutes
Start again from the top if you are not sure a step was finished.