Troubleshooting
Common issues and solutions for widget deployment, agent configuration, and integration problems.
Chat Widget Not Appearing
Common Solutions
- • Verify script tag is placed before closing </body> tag
- • Confirm agent ID is correct in the embed code
- • Check that agent is enabled in console
- • Check browser console for JavaScript errors
- • Test in incognito/private browser window
Correct placement:
<script src="https://oxaide.com/api/e?uid=YOUR_AGENT_ID" async></script>
</body>Agent Not Responding
Common Solutions
- • Check message credit limit in usage dashboard
- • Verify agent instructions are configured and saved
- • Confirm knowledge base embedding is complete
- • Test using "Chat" button in console
- • Ensure agent is enabled (not disabled or archived)
Knowledge Base Issues
File Upload Requirements
- • Primary format: PDF (professional multi-page text extraction)
- • Text formats: TXT, MD, CSV, JSON, HTML, RTF (extracted as plain text)
- • Maximum file size: 10MB per document
- • Wait for embedding process to complete (check status indicator)
Website Scraping
- • Verify URLs are publicly accessible
- • Check scraping status in console
- • Use "Refresh" button to update existing sources
- • Automated scraping runs every 15 minutes if scheduled
Google Workspace Import
Common Solutions
- • Re-authenticate your Google account in console
- • Verify document sharing permissions (must not be private)
- • Ensure documents contain readable text content
- • Check that authentication token has not expired