Common Issues

"No API key configured"

Cause: You haven't added your AI provider key yet.

Fix: Go to Settings → AI Settings → Use Your Own API Key → paste your OpenAI, Gemini, or other key → Save.

Documents not being found in answers

Cause: Embedding key not configured, or document still processing.

Fix: 1. Check Settings → confirm Gemini embedding key is saved 2. Go to Documents — confirm the document shows status "Ready" (not "Processing") 3. Wait 60 seconds after upload before testing

Manager AI not responding

Cause: API key missing, rate limit hit, or Celery worker down.

Fix: 1. Check Settings → confirm API key is valid 2. Check your API provider dashboard for rate limit errors 3. On VPS: run supervisorctl status — all services should show RUNNING

WhatsApp bot not replying

Cause: Webhook not configured or Twilio credentials invalid.

Fix: 1. Go to Channels → WhatsApp → verify Twilio credentials 2. Confirm webhook URL is set in Twilio console to: https://ragleap.com/api/whatsapp/webhook/ 3. Send a test message from Twilio sandbox first

Database sync not working

Cause: query_template is empty, or Celery beat not running.

Fix: 1. Go to Connectors → your database → confirm SQL query is set in query_template field 2. On VPS: supervisorctl status — confirm celery-beat is RUNNING 3. Trigger manual sync via Manager: "Sync my database"

"You've exceeded your credit limit"

Cause: Monthly credit limit reached on cloud plan.

Fix: Go to Billing → Upgrade plan or wait for monthly reset. To avoid this, add your own API key in Settings — unlimited usage on your own key.