Troubleshooting
Quick fixes for common issues. If you are stuck, contact support@aidesk.us.
Chat Widget Not Appearing
Check These First
- Script placed before closing
</body>tag - Agent ID is correct in embed code
- Agent is enabled in console
- No JavaScript errors in browser console (F12)
Correct Placement
<script src="https://aidesk.us/api/e?uid=YOUR_AGENT_ID" async></script>
</body>Agent Not Responding
Common Causes
- AI credits exhausted
- Agent is disabled
- No knowledge base content
Solutions
- Check usage in dashboard
- Enable agent in settings
- Add knowledge sources
Knowledge Base Issues
File Upload Problems
- Use PDF for best extraction (primary format)
- Max file size: 10MB
- Wait for embedding to complete (check status)
- Supported: PDF, TXT, MD, CSV, JSON, HTML, RTF
Website Scraping Issues
- URL must be publicly accessible
- Check scraping status in console
- Use "Refresh" to update existing sources
- Scheduled scraping runs every 15 minutes
Integration Issues
Google Workspace
- Re-authenticate if token expired
- Document must not be private
- Ensure readable text content exists
Instagram / WhatsApp
- Verify Meta Business Account connected
- Check webhook status in console
- Contact support for API issues
Still Stuck?
Email Support
support@aidesk.us
Response within 24 hours
Include in Your Email
- • Agent ID
- • Error message or screenshot
- • Steps to reproduce
GDPR/PDPA Compliant
•AES-256 encryption
•High availability
•Business-grade security