Troubleshooting & Support
Find solutions to common issues, learn about token management, and get help with bluekona.ai connections and audits.
Having issues with bluekona.ai? This troubleshooting hub helps you quickly find solutions to common problems and understand how to maintain smooth operations.
Quick Help
Most Common Issues
Looking for quick answers? These are the most frequently encountered issues:
Connection Problems
- Cannot connect social media account
- Connection suddenly stopped working
- Token expired messages
Audit Issues
- Audit won't start
- Audit takes too long
- Incomplete results
Data Discrepancies
- Numbers don't match platform analytics
- Missing content in audits
- Incomplete metrics
Troubleshooting Guides
Common Issues & Solutions
Comprehensive guide to frequently encountered problems and their solutions.
Topics covered:
- Connection failures
- Audit errors
- Performance issues
- Login problems
- Data synchronization
- Browser compatibility
Understanding Token Expiration
Learn about OAuth tokens, why they expire, and how to maintain active connections.
Key topics:
- What are OAuth tokens?
- Why tokens expire
- Token lifecycle phases
- How to reconnect
- Managing multiple accounts
- Prevention tips
Issue Categories
Connection Issues
Can't Connect Platform
Symptoms:
- Authorization fails
- "Unable to retrieve" errors
- Redirect loops
Quick fixes:
- Verify account type (Business, Page, etc.)
- Clear browser cache
- Try incognito mode
- Check admin permissions
Detailed Connection Troubleshooting →
Token Expired
Symptoms:
- "Token Expired" status
- Red error indicator
- Cannot run audits
Solution:
- Click "Reconnect" button
- Re-authorize through OAuth
- Connection restored immediately
Audit Issues
Audit Won't Start
Common causes:
- Expired connection
- No recent content
- Browser issues
Quick fixes:
- Check connection status
- Refresh browser
- Verify recent posts exist
Results Incomplete
Possible reasons:
- New account/connection
- Limited activity
- Platform API limitations
Solutions:
- Wait for more data
- Check account type
- Review what's available
Data & Performance
Slow Performance
Common causes:
- Browser cache
- Many connections
- Large data sets
Quick fixes:
- Clear cache
- Update browser
- Check internet connection
Platform-Specific Issues
Facebook / Instagram
- Must have Page (not personal profile)
- Instagram requires Business/Creator account
- Admin or editor access needed
- Grant all permissions during OAuth
YouTube
- Works with any channel type
- Verify channel ownership
- Check Google account
- Brand accounts may need extra steps
X (Twitter)
- Any account type works
- Tokens rarely expire
- Check for rate limiting
- Ensure account not restricted
TikTok
- Must be Business Account
- Regional API availability varies
- Complete Business setup fully
- May take 24 hours to activate
- Must have Company Page
- Need admin or analyst role
- Page must be published
- Personal profiles don't work
Threads
- Linked to Instagram
- Meta OAuth system
- 60-day token expiration
- Similar to Instagram setup
Prevention Tips
Avoid Common Issues
Connection Management:
- ✅ Run audits regularly (prevents data gaps)
- ✅ Reconnect before expiration
- ✅ Monitor connection status weekly
- ✅ Keep admin access on accounts
Browser & System:
- ✅ Use supported browsers (Chrome, Firefox, Safari, Edge)
- ✅ Keep browser updated
- ✅ Enable JavaScript
- ✅ Disable conflicting extensions
Content & Activity:
- ✅ Maintain consistent posting
- ✅ Ensure recent content exists
- ✅ Keep accounts active
- ✅ Don't delete analyzed posts
Getting Help
Before Contacting Support
Gather this information:
- What you were trying to do
- What happened instead
- Error messages (screenshot if possible)
- Which platform/account affected
- Browser and operating system
- Steps already tried
Check System Status
Platform status pages:
- Facebook: developers.facebook.com/status
- YouTube: status.cloud.google.com
- X: api.status.x.com
- LinkedIn: status.linkedin.com
Self-Help Resources
Documentation:
Learn More:
Contact Support
When to contact:
- Issues persist after troubleshooting
- Error messages you don't understand
- Platform-specific technical issues
- Account or billing questions
How to reach us:
- Email: support@bluekona.ai
- Response time: 24-48 hours
- Include information listed above
Quick Reference
Issue → Solution
| Issue | Quick Fix |
|---|---|
| Can't connect | Check account type, try incognito |
| Token expired | Click Reconnect |
| Audit won't start | Verify connections active |
| Slow performance | Clear cache, update browser |
| Numbers don't match | Check timezone, expect 1-5% variance |
| Missing data | Wait for sync, verify recent posts |
Emergency Checklist
If something's not working:
- ⬜ Check connection status
- ⬜ Refresh browser page
- ⬜ Clear browser cache
- ⬜ Try incognito mode
- ⬜ Check platform status
- ⬜ Review error messages
- ⬜ Consult documentation
- ⬜ Contact support if needed
Additional Resources
Video Tutorials (Coming Soon)
- Connecting platforms
- Running first audit
- Fixing common issues
- Token management
FAQ
Common questions answered:
- How often to run audits?
- Why do tokens expire?
- Can I connect multiple accounts?
- What if I change passwords?
Knowledge Base
Growing library of:
- How-to guides
- Best practices
- Tips & tricks
- Advanced features
Stay Updated
Platform Changes
Social media platforms frequently update:
- Algorithm changes
- API modifications
- Feature additions
- Policy updates
We monitor and adapt to keep bluekona.ai working smoothly.
Feature Updates
bluekona.ai continuously improves:
- New platform integrations
- Enhanced AI capabilities
- Additional metrics
- User experience improvements
Need More Help?
Can't find what you're looking for?
Browse Full Documentation
Detailed Troubleshooting
Learn Best Practices
Remember: Most issues resolve with simple solutions like reconnecting or refreshing. Don't hesitate to try the basics first!
Still stuck? View detailed troubleshooting →