Widget Not Showing

If the Conviro chat widget does not appear on your website, work through this checklist step by step.

1. Verify the Embed Code

• Go to Dashboard -> Assistants -> Your Bot -> Embed Code.
• Copy the latest snippet and make sure it is placed correctly in your HTML.
• The script tag must be placed before the closing \</body\> tag (not in the \<head\>).
• Ensure there are no typos or missing characters.

2. Check the Public Key

• In the embed code, verify the publicKey value matches the key shown in the Dashboard.
• Public keys start with pk_.
• If you regenerated the key, update the embed code on your website.

3. Verify the Domain Allow List

• Go to Dashboard -> Assistants -> Your Bot -> Channels.
• Make sure your website domain is in the Allowed Domains list.
• Include all variations: example.com, www.example.com, and localhost for development.
• Do not include the protocol (https://) -- just the domain name.

4. Confirm the Bot Is Active

• Go to Dashboard -> Assistants.
• Your bot's status must be Active (green indicator).
• If it is paused or inactive, click to activate it.

5. Check for JavaScript Errors

• Open your website in a browser.
• Press F12 (or right-click -> Inspect) to open Developer Tools.
• Go to the Console tab.
• Look for errors related to Conviro or the widget:
• Widget init failed -- public key or domain issue
• 403 Forbidden -- domain not in the allow list
• 404 Not Found -- widget script URL is incorrect
• net::ERR_BLOCKED_BY_CLIENT -- ad blocker is blocking the script

6. Disable Ad Blockers

Ad blockers (uBlock Origin, AdBlock Plus, Brave Shields) may block the widget script.

• Temporarily disable the ad blocker and reload the page.
• If the widget appears, whitelist your domain in the ad blocker settings.

7. Check for Caching

• If you use a caching plugin (WP Super Cache, Cloudflare, etc.), clear the cache after adding the embed code.
• Try loading the page in an incognito/private browser window to bypass cache.

8. Check for Conflicting Scripts

• Other chat widgets or JavaScript libraries may conflict with Conviro.
• Check the Console for errors from other scripts.
• Try removing other chat widgets temporarily to isolate the issue.

9. Content Security Policy (CSP)

If your site has a strict Content Security Policy, you may need to allow:

• script-src: cdn.conviro.io
• connect-src: api.conviro.io
• frame-src: cdn.conviro.io

10. Still Not Working?

If none of the above resolves the issue:

• Take a screenshot of the Console errors.
• Note your website URL, browser, and OS.
• Contact support at [email protected] with the details.