Guides

Email Notifications

Enabling Email Notifications

Users can opt-in to email notifications from the notification tray settings tab as shown below.

📘

You can also enable email notifications programmatically using our Update User API and setting email_notice_frequency = "immediately" to get email notifications OR "never" to turn off email notifications.

Updating the "from:" email name

To change the name the email notifications are sent from, simply reach out to Viafoura's support with the request, specifying:

  1. that you want to change the from email name field for email notifications
  2. what the new name should be (ie "Your Site Name")

Updating the "from:" email address

To change the address the email notifications are sent from, there are additional changes that need to be done on your end to allow Viafoura to send emails on behalf of an email account under your site's domain.

We use Amazon SES for sending email, and we will either need to validate the particular email address by sending a message from SES or validate an entire domain by configuring DNS records. Either option is acceptable. There are however some differences.

Validating a domain or subdomain

Domain validation involves adding DomainKeys Identified Mail (DKIM) keys at the domain of the email address. This allows us to send email as any email address at the domain and receiving mail servers will validate SES as the sender of the email. To indicate that SES is permitted as a sender, Sender Policy Framework (SPF) records must be added. Major mail providers also require DMARC records to deliver emails. All three record types must be in place for mail deliverability.

If you aren't comfortable with DKIM keys for your entire domain, we suggest choosing a new subdomain for the email address.

❗️

If you choose to validate a subdomain, the custom from email address must be underneath that subdomain. For example, if you choose to validate subdomain.example.com then the email address must end in subdomain.example.com.

SES Sending Subdomain

SES requires a separate subdomain to receive bounces and complaints. It cannot be a subdomain at which you already send and receive email. For SPF alignment, this must be a subdomain of the domain of the email address. This will appear in emails as the MAIL FROM domain.

DNS Record Generator

After you've created records as above and the tool above validates them, please reach out to Viafoura's Support team indicating:

  • The custom from email address you'd like to use
  • Your chosen SES sending subdomain if not "viafoura".

Next Steps

  1. Once we have received the above, we will configure SES on our side and we will generate DKIM signing keys, which will then need to be added to the email address domain as CNAME records. The DKIM records also serve to validate domain ownership.
  2. At this point we will confirm that all the necessary DNS records have been picked up by SES, then switch your site settings to use the new from email address for sending email.