Troubleshooting & Support
If you encounter issues, this guide covers the most common pitfalls and their solutions.
đĄ Synchronization Issues
Emails are not appearing in the Dashboard
- Check âSync Fromâ Date: The AI only processes emails received after this date.
- Reset Checkpoint: If youâve changed your start date and want to re-scan old emails, click the Reset Checkpoint button in the Sync Scope panel.
- Batch Limits: The Max Emails setting limits how many emails are processed per run. If you have a large backlog, it may take several sync cycles to catch up.
- Manual Trigger: Click Run Sync Now on the Dashboard to force an immediate check.
âSync Failedâ or âBackend Not Connectedâ
- Local Server: Ensure the Email Automator application is open and running.
- Live Activity Feed: Open the Live Activity terminal. It often contains specific technical error messages (e.g., âNetwork Errorâ or â401 Unauthorizedâ).
đ Authentication & Permissions
Google/Gmail: redirect_uri_mismatch
- The Fix: Your Redirect URI in the Google Cloud Console must exactly match the one shown in Email Automator.
- Example:
https://your-ref.supabase.co/functions/v1/auth-gmail/callback (ensure no trailing slashes or spaces).
Microsoft/Outlook: Login fails or times out
- App Registration: Ensure your Azure App Registration has âAllow public client flowsâ set to Yes.
- Account Type: Ensure you selected âAccounts in any organizational directory and personal Microsoft accountsâ during registration.
Supabase: âInvalid API Keyâ
- The Fix: Always use the anon (public) key. The service_role key will be rejected by the app for security reasons.
đ¤ AI & RealTimeX Integration
AI is slow or unresponsive
- Local Models: If using Ollama or LM Studio, ensure your machine has sufficient RAM and your GPU is not under heavy load.
- Discovery: If no models appear in the dropdown, ensure RealTimeX Desktop is running and you have configured at least one AI provider within it.
âSmart Draftsâ are not being created
- System Toggle: Ensure Smart Drafts is toggled ON in the Auto-Pilot tab.
- Rule Conflict: Verify that the rule matching the email actually includes the Draft action.
- Safety Filter: The AI automatically skips drafting for
no-reply addresses and certain automated notifications to prevent âbot loops.â
đď¸ Database & Migrations
âDatabase Migration Requiredâ Banner
- Why it happens: Your local app has been updated, and your Supabase database schema needs to catch up to support new features.
- The Fix: Click Update Now in the banner. You will need your Supabase Access Token to run the update automatically.
Live Terminal is empty or shows â404â
- Realtime Permissions: Ensure you have run the latest migrations. The
processing_events table must exist and have the correct RLS (Row Level Security) policies enabled.
đ Still Need Help?
If your issue isnât listed here:
- Check the System Logs in the Account Settings for technical stack traces.
- Review the Developer Documentation for advanced setup details.
- Open a ticket or discussion in the project repository.