Email Integration
Forward support emails to GudDesk and reply from your shared inbox.
The email integration lets you manage support emails alongside chat conversations in your GudDesk shared inbox.
How It Works
- Forward incoming emails to your GudDesk support address
- Emails appear as conversations in your shared inbox
- Reply from GudDesk. Your response is sent as a regular email
- Later emails in the same thread are added to the same conversation
Setting Up Email Forwarding
1. Find Your Support Address
Each workspace has its own support address in this form:
support+<your-app-id>@mail.guddesk.com
Find yours in Workspace Settings > Email Channel, under Support Address.
2. Configure Forwarding
Set up email forwarding from your support email to your GudDesk support address:
Gmail:
- Go to Settings > Forwarding and POP/IMAP
- Add your GudDesk support address as a forwarding address
- Confirm the forwarding request
Custom domain:
Set up a mail forwarding rule with your email provider to forward support@yourdomain.com to your GudDesk support address.
3. Outbound Settings
Under Outbound Settings you can set the from name, the from address and an email signature. GudDesk sends replies through Resend. A custom from address only works if its domain is verified in the Resend account that sends your mail, which on a self-hosted install is your own account.
Email Threading
Replies include In-Reply-To and References headers, so customers see a normal email thread in their mail app.
Attachments
Attachments are not imported yet. The text of each email arrives in the conversation, but attached files don't.
Auto-Reopen
With Auto-reopen on reply turned on (the default), a closed conversation reopens when the customer sends a new email reply. GudDesk does not send automatic acknowledgment emails.
Self-Hosted Email
For self-hosted instances, configure these environment variables:
RESEND_API_KEY="your-resend-api-key"GudDesk uses Resend for email delivery. You can use the free tier (100 emails/day) for small teams or upgrade for higher volume.
Next Steps
- Set up webhooks to send conversation events to your other tools
- Connect your own agent to reply as BOT