Skip to content

EMAIL

Option A: SendGrid (Recommended)

  1. SMTP connection URI: smtps://apikey:[email protected]:465
  2. Leave SMTP password empty (included in URI)
  3. Default FROM address: Help Desk [email protected]

Option B: Mailgun

  1. SMTP connection URI: smtps://YOUR_MAILGUN_USERNAME:[email protected]:465
  2. Leave SMTP password empty (included in URI)
  3. Default FROM address: Help Desk [email protected]

Option C: Gmail/Google Workspace

  1. SMTP connection URI: smtps://your-[email protected]:[email protected]:465
  2. Leave SMTP password empty (included in URI)
  3. Default FROM address: [email protected]
  4. ⚠️ Note: You must enable 2FA and create an App Password in your Google account

Option D: Office 365/Outlook

  1. SMTP connection URI: smtps://your-[email protected]:[email protected]:587
  2. Leave SMTP password empty (included in URI)
  3. Default FROM address: [email protected]

Collection Settings:

  1. Email documents collection
  • Set to: mail (this is what the Help Desk app uses)
  1. Default FROM address
  • Enter your help desk email: Help Desk [email protected]
  • Replace yourdomain.com with your actual domain
  1. Default REPLY-TO address (Optional)

Optional Settings (Leave as Default):

  1. 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:

  1. Sign up at https://sendgrid.com
  2. Go to Settings → API Keys
  3. Create API key with “Mail Send” permissions
  4. Use this API key in the SMTP URI

For Mailgun:

  1. Sign up at https://mailgun.com
  2. Go to Sending → Domain settings
  3. Find your SMTP credentials under “SMTP”
  4. Use these credentials in the SMTP URI

For Gmail:

  1. Enable 2-Factor Authentication
  2. Go to Google Account → Security → App passwords
  3. Generate app password for “Mail”
  4. Use this app password (not your regular password)

Testing Your Configuration:

After installation:

  1. Go to your Help Desk application
  2. Create a test ticket
  3. Check if you receive email notifications
  4. 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