Common Issues & Fixes
AI Assistify is designed to provide a seamless AI-powered experience, but occasionally, users may encounter issues with setup, access, integrations, or performance. Below is a troubleshooting guide with common issues and their fixes.
🔑 API Keys & Authentication Issues
❌ Issue: AI Assistant Not Responding / API Key Error
Possible Causes: 🔹 API key is missing or incorrect. 🔹 The AI provider (OpenAI, Gemini, Claude, etc.) is experiencing downtime. 🔹 The API key has expired or reached its usage limit.
🔧 Fixes: ✅ Go to Settings > API Keys and ensure the correct API key is added. ✅ Check with the AI provider for quota limits or service status. ✅ Replace the API key with a new one and click "Save".
👥 Access & Sharing Issues
❌ Issue: Users Cannot Access Shared Assistants, Files, or Tools
Possible Causes: 🔹 The assistant or file is set to private instead of shared. 🔹 The invited user has not accepted the invitation to join the workspace. 🔹 The user does not have the correct permissions.
🔧 Fixes: ✅ Go to Visibility Settings > Sharing and verify that resources are shared. ✅ Ask the invited user to check their email and accept the workspace invitation. ✅ In Members Settings, ensure the user has the correct role and access level.
🤖 Assistant & Chat Issues
❌ Issue: AI Assistant Provides Incorrect or Incomplete Responses
Possible Causes: 🔹 The prompt or instructions given to the AI assistant are too vague. 🔹 The assistant lacks access to the necessary files or tools. 🔹 The AI model used may not be the best fit for the task.
🔧 Fixes: ✅ Improve the prompt settings by providing clearer instructions in the assistant setup. ✅ Ensure relevant files or documents are attached to the assistant. ✅ Try switching to a different AI model (e.g., GPT-4, Claude, Gemini) for better results.
📂 File & Document Issues
❌ Issue: AI Assistant Cannot Read or Analyze Uploaded Files
Possible Causes: 🔹 The file format is not supported (AI Assistify supports PDFs, DOCX, JSON, etc.). 🔹 The file size exceeds system limits. 🔹 The assistant is not configured to access files.
🔧 Fixes: ✅ Re-upload the file in a supported format (PDF, DOCX, etc.). ✅ Check file size limits and reduce file size if necessary. ✅ Go to Assistant Settings > Files and make sure the file is linked to the assistant.
🌐 Integration & Deployment Issues
❌ Issue: Chat Widget Not Working on Website
Possible Causes: 🔹 The chat widget script is missing or incorrectly embedded. 🔹 The AI Assistant assigned to the widget is disabled. 🔹 The browser or firewall blocks the chatbot connection.
🔧 Fixes: ✅ Verify the chat widget embed code is added correctly to the website. ✅ Check if the assigned AI Assistant is active and properly set up. ✅ Test the widget in incognito mode or a different browser to rule out firewall issues.
❌ Issue: Telegram/WhatsApp Bot Not Responding
Possible Causes: 🔹 The bot API key is incorrect or expired. 🔹 The bot integration is not properly configured. 🔹 The bot has not been added to the correct Telegram/WhatsApp group.
🔧 Fixes: ✅ Go to Integrations > Bots and verify the correct API key and settings. ✅ Restart the bot and ensure it is active in the chat group. ✅ Test the bot with a simple command (e.g., “/start”) to check connectivity.
📊 Performance & Speed Issues
❌ Issue: AI Assistant is Slow or Unresponsive
Possible Causes: 🔹 High server load or API rate limits. 🔹 AI provider (OpenAI, Google, Anthropic) is experiencing latency issues. 🔹 Too many simultaneous requests are overwhelming the assistant.
🔧 Fixes: ✅ Reduce unnecessary background requests or simplify queries. ✅ Check the AI provider’s status page for any reported delays. ✅ Upgrade your API plan if rate limits are affecting performance.
🔄 Best Practices for Avoiding Issues
✅ Regularly Update API Keys – Expired or invalid API keys cause AI failures. ✅ Monitor AI Performance – Track response times and optimize AI assistant prompts. ✅ Use Clear Prompts – Well-structured prompts improve AI accuracy. ✅ Test Integrations Periodically – Ensure bots, chat widgets, and workspace endpoints function correctly. ✅ Limit Excessive Queries – Avoid overwhelming the assistant with multiple large requests.
By following these troubleshooting steps, users can resolve most issues quickly and maintain a smooth AI-powered experience. 🚀
Last updated