Option A: SendGrid (Recommended)
- SMTP connection URI: smtps://apikey:[email protected]:465
- Leave SMTP password empty (included in URI)
- Default FROM address: Help Desk [email protected]
Option B: Mailgun
- SMTP connection URI: smtps://YOUR_MAILGUN_USERNAME:[email protected]:465
- Leave SMTP password empty (included in URI)
- Default FROM address: Help Desk [email protected]
Option C: Gmail/Google Workspace
- SMTP connection URI: smtps://your-[email protected]:[email protected]:465
- Leave SMTP password empty (included in URI)
- Default FROM address: [email protected]
- โ ๏ธ Note: You must enable 2FA and create an App Password in your Google account
Option D: Office 365/Outlook
- SMTP connection URI: smtps://your-[email protected]:[email protected]:587
- Leave SMTP password empty (included in URI)
- Default FROM address: [email protected]
Collection Settings:
- Email documents collection
- Set to: mail (this is what the Help Desk app uses)
- Default FROM address
- Enter your help desk email: Help Desk [email protected]
- Replace yourdomain.com with your actual domain
- Default REPLY-TO address (Optional)
- Enter: [email protected] (where users should reply)
Optional Settings (Leave as Default):
- Users collection: Leave empty9. Templates collection: Leave empty10. Firestore TTL type: Never11. Firestore TTL value: Leave empty12. TLS Options: Leave empty
Getting Your SMTP Credentials:
For SendGrid:
- Sign up at https://sendgrid.com
- Go to Settings โ API Keys
- Create API key with โMail Sendโ permissions
- Use this API key in the SMTP URI
For Mailgun:
- Sign up at https://mailgun.com
- Go to Sending โ Domain settings
- Find your SMTP credentials under โSMTPโ
- Use these credentials in the SMTP URI
For Gmail:
- Enable 2-Factor Authentication
- Go to Google Account โ Security โ App passwords
- Generate app password for โMailโ
- Use this app password (not your regular password)
Testing Your Configuration:
After installation:
- Go to your Help Desk application
- Create a test ticket
- Check if you receive email notifications
- If emails donโt work, check Firebase Console โ Extensions โ Trigger Email for error logs
Common Issues:
- โAuthentication failedโ โ Check your SMTP credentials
- โConnection refusedโ โ Verify SMTP host and port
- โSender not authorizedโ โ Verify your email domain with your provider