AI Not Responding
AI Not Responding
Quick Checklist
If the AI is not replying to visitor messages, check these in order:
- AI enabled? — Go to Messenger > Settings > AI and ensure the toggle is ON
- Billing active? — Check Settings > Billing for any overdue payments
- Conversation limit? — Free/Starter plans have monthly limits
- Knowledge base populated? — The AI needs content to answer from
Common Causes
AI is Disabled
The AI may be turned off globally or for specific conversations:
- Global toggle — Check **Settings > AI > Enable AI**
- Per-conversation — An agent may have disabled AI in a specific conversation during handover
- Re-enable by clicking the AI toggle in the conversation header
Billing Limit Reached
When your plan's conversation limit is reached:
- The AI stops responding to new conversations
- Existing conversations continue but without AI
- Check your usage in Settings > Billing > Usage
- Upgrade your plan or wait for the next billing cycle
AI Provider Error
Liqaa connects to AI providers (OpenAI, Anthropic) for responses:
- Check the Settings > AI > Status page for provider health
- Temporary outages are usually resolved within minutes
- If persistent, try switching to a different AI model in settings
Knowledge Base Empty
The AI needs content to answer questions:
- Check Knowledge Base > Articles — are there published articles?
- Check Knowledge Base > Sources — has your website been crawled?
- If recently added, wait a few minutes for indexing to complete
- Test with the Playground to see what the AI knows
Testing in Playground
The Playground lets you test AI responses without using the widget:
- Go to Messenger > Playground
- Type a question a visitor might ask
- If the AI responds here but not on the widget:
- The issue is widget-related, not AI-related
- Check widget configuration and domain verification
- If the AI doesn't respond here either:
- Check AI provider status and billing
Error Messages
| Error | Meaning | Solution |
|---|---|---|
| "AI unavailable" | Provider is down | Wait or switch model |
| "No relevant content found" | KB has no matching articles | Add more content |
| "Rate limit exceeded" | Too many requests | Wait a few minutes |
| "Model not available" | Plan doesn't include this model | Upgrade plan |
Contact Support
If none of the above resolves your issue:
- Go to Settings > AI > Diagnostics
- Click Run Diagnostic
- Share the diagnostic report with our support team