For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting

The following guide helps you diagnose and resolve common Chatboz AI chatbot issues.

Issue 1: Chatbot Not Displaying

Possible causes: - API Key not configured or invalid. - Shortcode missing or incorrect. - Theme or plugin conflict. Solutions: - Check API Key in AI Chatboz → API Key Settings. - Ensure shortcode [physcode-chat-bot] is added correctly. - Check browser console (F12) for JavaScript errors. - Temporarily disable other plugins to detect conflicts.

Issue 2: Widget Not Appearing

Check the following: - “Enable Chat Widget” is turned on. - API Key is configured. - Note: The widget does not appear in Admin Dashboard.

Issue 3: API Connection Error

- Verify your server has an active internet connection. - Ensure no firewall blocks requests to api.chatboz.com. - Enable debug log and check /wp-content/chatbot-debug.log.

Issue 4: UI or Styling Issues

- Clear browser cache (Ctrl + F5). - Clear plugin cache (if using cache plugins). - Check Custom CSS syntax for errors. - Disable custom CSS temporarily to isolate the issue.

Last updated