CRMAIBOT Troubleshooting Guide
Find quick fixes for common chatbot setup, installation, training, lead capture, domain locking, and notification issues.
Use this CRMAIBOT troubleshooting guide for chatbot troubleshooting, website chatbot not showing, AI chatbot not answering correctly, chatbot lead capture issue, chatbot widget installation problem, and chatbot domain locking issue.
Quick Troubleshooting Checklist
Start here before changing settings. These checks solve many website chatbot setup issues.
Confirm chatbot is active
Confirm widget script is installed correctly
Check approved domain settings
Clear website/browser cache
Test on desktop and mobile
Verify chatbot training data
Check lead capture fields
Confirm email or WhatsApp alert setup
Review package/usage limits
Check browser console for script errors
Common CRMAIBOT Issues and Fixes
Open the issue that matches your situation and follow the possible causes and fixes.
Chatbot Not Showing on Website
Possible causes
- widget script missing
- wrong chatbot ID
- domain not approved
- website cache issue
- script placed in wrong location
- JavaScript blocked by theme/plugin
- chatbot disabled in dashboard
Fix
- reinstall widget script
- confirm chatbot ID
- add correct domain
- clear cache
- test in incognito mode
- disable conflicting plugins temporarily
- check browser console
Chatbot Shows on Desktop but Not Mobile
Possible causes
- mobile CSS hiding widget
- responsive positioning issue
- z-index conflict
- theme layout issue
Fix
- check mobile preview
- inspect CSS
- increase widget z-index
- test on multiple devices
Chatbot Not Answering Correctly
Possible causes
- incomplete knowledge base
- missing FAQs
- outdated website content
- unclear instructions
- uploaded document not trained
- vague user questions
Fix
- add better FAQs
- update knowledge base
- add business-specific instructions
- test common questions
- review chat history
Chatbot Gives Generic Answers
Possible causes
- no business data added
- weak prompt/instructions
- missing product/service details
- no website training
Fix
- add business profile
- add service details
- upload documents
- add custom instructions
- add example Q&A
Lead Capture Not Working
Possible causes
- lead fields not configured
- lead capture trigger missing
- form validation issue
- user exits before submitting
- dashboard permission issue
Fix
- enable lead capture
- add required fields
- test with sample conversation
- check dashboard leads section
- reduce number of fields
Email Alerts Not Received
Possible causes
- wrong email address
- spam folder
- SMTP issue
- alert disabled
- package limitation
Fix
- verify email
- check spam
- send test alert
- check notification settings
- confirm package supports alerts
WhatsApp Alerts Not Working
Possible causes
- WhatsApp number not configured
- integration not active
- template approval pending
- package limitation
- API issue
Fix
- verify WhatsApp number
- check integration status
- confirm package support
- test alert
- review WhatsApp template settings
Domain Locking Issue
Possible causes
- domain not added
- www version missing
- subdomain missing
- wrong domain format
- staging/live mismatch
Fix
- add root domain
- add www domain
- add required subdomains
- remove old staging domains
- test after saving settings
WordPress Chatbot Not Showing
Possible causes
- script not added properly
- caching plugin conflict
- theme footer disabled
- security plugin blocking script
- plugin not activated
Fix
- add script in header/footer plugin
- clear WordPress cache
- clear CDN cache
- test with default theme
- check plugin settings
Shopify Chatbot Not Showing
Possible causes
- script not added to theme correctly
- theme update removed script
- app/embed disabled
- checkout restrictions
Fix
- add widget script to theme custom liquid or approved section
- check theme files
- enable app embed if applicable
- test storefront pages
Chatbot Slow to Load
Possible causes
- website speed issue
- heavy theme/scripts
- slow network
- browser extensions
- third-party script conflict
Fix
- test in incognito
- check website performance
- remove duplicate scripts
- load widget once only
- check console/network tab
Chat Usage Limit Reached
Possible causes
- monthly chat limit exceeded
- free plan limit reached
- high traffic website
- unauthorized domain usage
Fix
- check usage dashboard
- upgrade package if needed
- enable domain locking
- review traffic sources
How to Debug a Chatbot Issue
Use this flow to narrow down whether the issue is status, script, domain, training, lead capture, or alert related.
Check chatbot status
Verify widget script
Check domain locking
Test in incognito browser
Test on mobile and desktop
Review knowledge base
Test lead capture
Check alerts
Contact support with screenshots if unresolved
Before Contacting Support
Prepare these details so support can reproduce the issue and understand what you expected to happen.
Best Practices to Avoid Issues
A few simple habits can prevent most chatbot setup, training, domain, and alert problems.
Keep chatbot training data updated
Add both www and non-www domains
Test after every website update
Review chat history weekly
Keep lead fields short
Use clear FAQs
Avoid duplicate widget scripts
Check alerts regularly
Remove old staging domains
Monitor usage limits
Continue Troubleshooting
Use these connected help pages to fix training, lead capture, domain locking, and integration issues.
Knowledge Base Setup
Improve chatbot answers with better training data.
Open pageLead Capture Setup
Fix lead form and qualification workflows.
Open pageDomain Locking Guide
Resolve approved-domain and widget protection issues.
Open pageAPI Docs
Review integration and webhook guidance.
Open pageLearning Guide
Learn the complete chatbot setup process.
Open pageAI Bot
Explore CRMAIBOT AI Bot capabilities.
Open pageResources
Return to the resource hub.
Open pageTroubleshooting FAQs
Answers about widget display, training quality, lead capture, domain locking, WordPress conflicts, and support requests.
Why is my chatbot not showing on my website?
The most common reasons are missing widget script, wrong chatbot ID, domain locking mismatch, cache issue, or chatbot disabled in the dashboard.
Why is my chatbot not answering correctly?
The chatbot may need better training data. Add FAQs, website content, documents, service details, and clear business instructions.
Why are leads not being captured?
Check whether lead capture is enabled, required fields are configured, and lead capture triggers are set correctly.
Why am I not receiving email alerts?
Check the email address, spam folder, notification settings, package support, and SMTP configuration.
Why is domain locking blocking my chatbot?
Make sure the correct root domain, www domain, and required subdomains are added in approved domains.
Why does the chatbot work on desktop but not mobile?
This may be caused by mobile CSS, theme conflicts, z-index issues, or responsive layout problems.
Can WordPress plugins block the chatbot?
Yes. Caching, security, optimization, and script management plugins may block or delay chatbot scripts.
What should I send to support?
Send your website URL, screenshot, chatbot name, browser/device details, sample question, expected answer, and actual result.
Still Need Help?
Use the troubleshooting checklist first. If the issue continues, share your website URL, screenshot, chatbot details, and sample question with support.