Troubleshooting: the Webchat widget doesn't appear on your site
Installed the Webchat snippet but the chat bubble won't show up? Work through the most common causes: wrong snippet placement, HTTPS, CSP and browser console errors.
Watch this step in the video · Troubleshooting
The Webchat widget is the chat bubble you embed on your website. When you paste the snippet and the bubble doesn't show, it's almost always one of five things. This guide walks them in order, from the most common to the most obscure.
Before you start
- You need a Webchat channel already created in Channels -> Connect channel -> Webchat.
- Open the page where the bubble should appear in an incognito window (to rule out cache and extensions).
- Keep the browser console handy: in Chrome/Edge press
F12and open the Console tab.
Diagnostic steps
-
Make sure the snippet is complete and in the right place. On the Webchat channel open the Install (embed) tab and copy the code again. It should look like this and be pasted right before the closing
</body>tag:<script src="https://omnifox.io/widget/loader.js" data-widget-key="..." async></script>A classic mistake is pasting it inside a comment, inside another
<script>, or after</body>. -
Confirm your site uses HTTPS.
loader.jsis served over HTTPS and browsers block mixed content: if your page loads overhttp://, the script won't run. Move your site to HTTPS. -
Check the browser console. Reload with the console open and look for red lines. Useful signals:
Failed to load resource ... loader.js-> the page can't reach Omnifox (firewall, blocker, or the snippet points to the wrong URL).- CSP errors (
Content-Security-Policy ... refused to load) -> your CSP header is blockingomnifox.io. Addhttps://omnifox.iotoscript-srcandconnect-src. - Ad/privacy blockers can stop the widget; test with them disabled.
-
Check the
data-widget-key. If you hand-edited it and it ended up truncated, the loader can't find the channel. Re-copy the whole snippet from the Install tab and don't alter that string. -
Rule out cache. If you use Cloudflare, a caching plugin, or a CDN, purge the site cache and retest in incognito.
How to verify it works
The channel's Install tab has an "Installed on" log listing the domains where the loader has fetched. The first time someone opens a page with your snippet, the host domain shows up there. If you see your domain with a recent timestamp, the install is good. If it says "No installations detected yet", the snippet hasn't run in any browser yet.
If it still doesn't work
- Try another browser and your phone: if it shows in one but not another, it's an extension or local cache.
- If you use a site builder (Wix, Squarespace) or an
<iframe>, confirm it allows inserting custom scripts into thebody. - Make sure the Webchat channel is active and not paused under Channels.
Tips
- Keep the snippet in your global template (theme footer) so it loads on every page, not just one.
- After changing the widget's color, name or greeting you don't need to reinstall: the loader reads the config live.
Related articles
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.