Email Channel Issues

1. Authorization Failure / Token Expired

• The Email channel uses Gmail OAuth; Google tokens expire after 6 months of inactivity by default.
• Panel → Channels → Email → Re-authorize.

2. Incoming Mail Not Processed

• Confirm the channel is enabled.
• Mail must match the channel's filter rules (sender, subject keyword, Label).
• Check whether Gmail auto-categorized it to "Promotions" or "Spam" — those aren't read.

3. AI Replies Not Sent

• Confirm authorization includes "send" (gmail.send). Re-authorize and check send if only read was granted originally.
• The recipient address must be valid; invalid addresses are bounced by Gmail.
• OAuth sending has daily limits (500/day for personal Gmail, 2000/day for Google Workspace).

4. Reply Threading Wrong / Missing

• By default the AI replies via "Reply" and needs an In-Reply-To header to thread.
• To start a new thread, explicitly tell the AI "reply as a new email".

5. Send From a Company Domain

• Personal Gmail can only send from @gmail.com. To send from @yourcompany.com you must be a member of that Google Workspace domain.
• The Workspace admin must allow third-party OAuth apps in the Admin Console first.

6. Attachment Handling

• When an inbound email has attachments, the AI parses them into readable content (PDF/image/document).
• Attachments above the per-file limit are skipped; the AI mentions it in its reply.