Multi-Account Gmail Integration
Connect multiple Gmail accounts as separate services, each with its own branding and configuration.Connecting a Gmail Account
Authorize with Google
You’ll be redirected to Google’s OAuth consent screen. Sign in and grant the necessary permissions:
- Read emails from Gmail
- Send emails on your behalf
- Access Gmail metadata
Only users with Admin permission can connect new Gmail accounts.
Service Customization
Each connected Gmail account becomes a “Service” that you can customize:Service Name
Give your service a friendly name (e.g., “Support”, “Sales”, “Partnerships”)
Brand Color
Assign a unique color for easy visual identification in the inbox
Email Signature
Configure HTML signatures that are automatically added to all outgoing emails
Reference Documents
Upload FAQs, policies, and guidelines for AI to reference when drafting replies
Unified Inbox
All emails from connected accounts appear in a single, organized inbox view.Thread-Based Organization
Emails are automatically grouped into conversation threads, matching Gmail’s native threading behavior:- Thread Subject: The original email subject is preserved across all replies
- Customer Information: Each thread shows the customer’s name and email
- Message Count: Visual indicator shows how many messages are in each thread
- Last Message Time: Threads are sorted by most recent activity
Inbox Filtering
- By Status
- By Category
- By Search
Filter threads by their current state:
- Inbox: New and ongoing conversations
- All: View all threads regardless of status
Thread View
When you select a thread from the inbox, the full conversation history appears in the detail panel.Message Display
Each message in the thread shows:- Direction Indicators: Inbound messages use customer avatar colors; outbound messages use your service color
- Timestamps: Displayed in localized format (e.g., “2 hours ago”, “Jan 15, 2:30 PM”)
- HTML Rendering: Messages preserve original formatting including links, lists, and emphasis
Attachment Handling
Image Attachments
Image Attachments
Images are displayed inline with thumbnails:
- Hover to see filename and size
- Click to open full-size in a new tab
- Maximum preview size: 300px wide × 200px tall
File Attachments
File Attachments
Non-image files appear as download cards:
- Shows file icon, name, and size
- Click to download or open in browser
- Supported types: PDF, DOC, XLS, ZIP, and more
Gmail Sync
DelightBridge keeps your inbox synchronized with Gmail through push notifications and manual sync.Automatic Sync
- Push Notifications: Gmail sends real-time updates when new emails arrive (configured via
src/app/api/cron/sync-gmail/route.ts:95) - History Sync: Only changed threads are fetched, minimizing API usage
- Background Processing: Sync happens asynchronously without blocking the UI
Manual Sync
Trigger sync manually from Settings → Services:Incremental Sync
Fetches only new messages since the last sync. Fast and efficient for regular updates.
Full Sync
Re-syncs all threads from scratch. Use this if you suspect data inconsistencies.
- Timestamp
- Number of threads synced
- Number of messages upserted
- Success or error status
Bulk Actions
Manage multiple threads at once with bulk selection:- Select Threads: Hover over a thread and click the checkbox that appears
- Action Bar: When threads are selected, an action bar appears at the bottom of the mail list
- Available Actions:
- Send All: Send draft replies for all selected threads
- Archive: Move threads to archived status
- Deselect: Clear all selections
Unread Indicators
Stay on top of new messages with visual unread indicators:- Blue Dot: Appears on the left edge of unread threads in the list
- Bold Text: Unread thread names and subjects appear in bold
- Count Badge: Each service in the sidebar shows its unread count
- Auto-Mark Read: Threads are marked as read when you open them (implemented in
MainLayout.tsx:381)
Best Practices
Organize with Categories
Organize with Categories
Set up meaningful categories for your service type:
- Support Team: “Bug Report”, “Feature Request”, “How-To”
- Sales Team: “New Lead”, “Quote Request”, “Follow-Up”
- Operations: “Billing”, “Refund”, “Account Change”
Use Search Effectively
Use Search Effectively
Search tips for faster navigation:
- Search by customer name:
John Smith - Search by email:
[email protected] - Search by keyword:
refund,invoice, etc. - Combine with filters for precise results
Regular Syncing
Regular Syncing
For high-volume inboxes:
- Run incremental sync every few hours
- Use full sync weekly to ensure consistency
- Monitor sync logs for any errors
Related Features
AI Draft Generation
Automatically generate reply drafts for incoming emails
Service Management
Configure services, signatures, and reference documents