Let Riff scan for key threads, draft follow-ups, and share summaries - all while you keep control of what’s synced and when.
Step-by-step setup (How To)
Step 1 Connect your Gmail workspace
- On the Riff platform click +More → Integrations → Gmail
- Click Connect account
- Select your Gmail workspace and authorize Riff
Step 2 Authorize database access
- Choose which services Riff can read/write
- Click Save permissions
Step 3 Verify connection
- Run a quick test: ask the agent a question about your data.
Frequently Asked Questions
Why can’t I find my Gmail account or inbox?
Make sure you’re signed into the right Google Account and that you’ve granted access for the connection you set up.
Can I restrict access to certain labels or mailboxes?
Yes. Connect only the account you choose and keep access limited to the labels and features you actually use.
Does Riff overwrite existing emails?
No. Riff can create drafts, notes, or labels you’ve set up—your existing messages aren’t changed or removed.
How often does Riff sync email data?
You decide the cadence via Riff automations (from frequent checks to manual runs).
Troubleshooting Gmail Integration on Riff
- Reconnect the Google sign-in if the connection expires
- Review which Google Account is linked and what you’ve shared
- Ensure your automations/schedules are enabled
- Try a fresh browser session if authorization stalls
- Contact support@riff.ai if the issue persists
Top use cases for Riff + Gmail
Dashboards
Response Time & Backlog Dashboard
An app that reads Gmail message metadata across selected mailboxes → compute first response time, average reply time, resolution time, backlog, SLA attainment → output charts.
Customer Sentiment and Topic Trends Dashboard
An app that reads events → detects “focus windows” (≥2h with no meetings) by user/team → output week heatmap + Slack recap
Automations
Missed Reply Watcher → Slack
An automation that hourly on weekdays, finds threads with last customer message >24h and no internal reply; post links to owners with “snooze” and “mark handled” in the app.
Attachment Collector
An automation that reads new messages with PDF/CSV attachments; download and save copies to a Drive folder with clean filenames; notify in #ops.
AI Agents
Reply Drafter
An agent that reads threads from a chosen label → reasons over sender, history, attachments → produces a ready-to-copy reply + checklist;
Account Health
An agent that reads conversations by customer domain → reasoning on touchpoints%2C response times%2C topics → output: a “customer health” note for your CRM.
Official Gmail Resources
- Gmail Help Center Google Help
- Manage connections between your Google Account and third parties
- Gmail API overview (for capabilities reference)
