Connect Gmail to let Duckie handle email-based support conversations.
Capabilities
| Capability | Supported |
|---|
| Knowledge Source | ✗ |
| Deployment Trigger | ✓ Respond to emails |
| Tool Actions | ✓ Send emails |
Setup
Connect via OAuth
- Go to Settings → Connections in Duckie
- Find Gmail and click Connect
- Sign in with your Google account
- Grant Duckie permission to read and send emails
- You’ll be redirected back to Duckie
Duckie requests permission to read incoming emails and send replies on your behalf.
Using as a Deployment Trigger
Deploy an agent to handle emails:
- Go to Deploy
- Click Create Deployment
- Select your agent
- Choose Gmail as the trigger
- Configure which emails trigger responses:
- All emails — Respond to every incoming email
- Specific senders — Only emails from certain addresses
- Labels — Only emails with specific Gmail labels
Filter Examples
- Support emails: Filter by label
support or sender domain
- Customer inquiries: Filter by subject containing “question” or “help”
| Tool | Description |
|---|
gmail_send | Send an email reply |
gmail_get_thread | Get full email conversation |
gmail_search | Search emails |
Best Practices
Use a Dedicated Support Email
Set up a dedicated email like [email protected]:
- Clear separation from personal emails
- Easy to manage and monitor
- Can be shared across team
Set Up Gmail Filters
Use Gmail filters to organize incoming emails:
- Auto-label support requests
- Skip spam before it reaches Duckie
Include Thread Context
Duckie automatically reads the email thread for context, so it understands the full conversation history.
Example Use Cases
Email Support Inbox
Deploy Duckie to handle your support@ inbox:
- Answer common questions
- Acknowledge receipt of complex issues
- Route to human agents when needed
Sales Inquiries
Handle initial sales emails:
- Provide product information
- Answer pricing questions
- Schedule demos
Troubleshooting
”Cannot send emails”
- Re-authenticate the Gmail connection
- Verify your Google account is in good standing
- Check that you approved send permissions
”Not receiving emails”
- Verify the deployment is in Live mode
- Check Gmail filters aren’t blocking emails
- Ensure the email address is correctly configured
