Troubleshooting Common Integration Issues
If your ChatEaver widget fails to appear on your website or throws browser console warnings, consult this troubleshooting guide for quick resolutions.
Common Symptoms & Solutions
Symptom / Error | Root Cause | Actionable Fix |
|---|---|---|
Widget Bubble Missing | Script tag missing or script URL blocked by adblocker | Verify script tag placement in HTML source; test in Incognito mode. |
Content Security Policy (CSP) Error | Website CSP header blocking external script execution | Add website domain and script host to script-src and connect-src directives. |
Widget Behind Footer Elements | CSS z-index conflict with fixed position headers/footers | Set custom CSS override: #chateaver-widget-container { z-index: 999999 !important; }. |
401 / 404 API Error in Console | Invalid data-workspace-key attribute value | Copy exact key from Dashboard > Widget and re-save HTML. |
Troubleshooting Resolution Checklist
Step 1: Open your browser's Developer Tools (F12) and inspect the Console tab.
Step 2: Check the Network tab to confirm chat-widget.js returns HTTP 200 OK.
Step 3: Test loading the website in a private / incognito browser window.
Step 4: Verify your workspace key matches the key shown in Dashboard > Widget.