MSP Custom Email

Exclusive to MSP accounts is the option to have custom branding on transactional emails that are sent out by DNSFilter (block page disputes, password resets, etc.). This is an optional setting that allows MSPs to create a sub-account with our email provider. This sub-account can be used to send notifications to your customers from a custom email address. It is useful if you want to brand emails with your company logo or if you want to utilize our email platform to send campaigns to your customers.

The first step in setting up a custom email is to contact support and let us know that you wish to turn on this feature for your account. Once that is completed, we will direct you to this page to complete the setup process.

Adding Contact Information

1. Login to https://mspmail.dnsfilter.io/login with the credentials provided in the email.
2. Navigate to your profile. You will click Edit Info and enter your account's contact information (including full physical address). This is necessary to use the service and comply with anti-spam laws.
3. You will then go to Security on the left-hand side of the panel and click "Edit password." 

Adding DNS Records

Since you are using our email platform to send emails on your behalf, you will need to login to your Domain Registrar or Authoritative Name Server (ANS) and add domain records that will prove to internet mailservers that we are authorized to send mail on your behalf. At a minimum, the SPF record below must be configured, but we highly recommend adding all the records listed below.

Please log in to your Registrar/ANS admin panel and add the following records. How to do this in Namecheap is illustrated below for reference:

SPF record
Type: TXT
Host: @
Value: v=spf1 a mx include:_spf.elasticemail.com ~all

DKIM
Type: TXT
Host: api._domainkey
Value: (Use Ctrl-A to be sure you copy the entire long string below)

k=rsa;t=s;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCbmGbQMzYeMvxwtNQoXN0waGYaciuKx8mtMh5czguT4EZlJXuCt6V+l56mmt3t68FEX5JJ0q4ijG71BGoFRkl87uJi7LrQt1ZZmZCvrEII0YO4mp8sDLXC8g1aUAoi8TJgxq2MJqCaMyj5kAm3Fdy2tzftPCV/lbdiJqmBnWKjtwIDAQAB

DMARC
Type: TXT
Host: _dmarc
Value: v=DMARC1; p=none; rua=mailto:ADMIN@YOURDOMAIN.COM;
(change email address to your email domain) You can also use a different DMARC setting using this generator.

Tracking
Type: CNAME
Host: tracking
Value: api.elasticemail.com

Adding Your Domain

After you are done making the DNS record changes above, you will need to wait sometime for the changes to propagate across the internet. This should take place within an hour but, at times, can take up to 24 hours.

You can just navigate to the settings menu in your email sub-account. You will then want to click on Manage Domains. After that, you will click on Start verification. You will then be prompted to choose between verifying a domain you own or verifying a specific email address if you don't own a domain.

Once you've added your domain, it will prompt you to confirm you entered all the keys needed into your DNS records. If you haven't done this yet, you will be prompted to do so now. Remember, it can take time to propagate these settings, so it might be able to verify immediately.

After it has confirmed and verified your domain, it will prompt you to enter the default email you want to be the sender.

Afterward, you will need to go back to the settings menu and proceed to Sending > Tracking and pruning. You will want to enable Return bounces which will track clicks and opens.

Congratulations, you are done setting up your sub-account. You are now ready to send mailings from your sub-account.

Email Templates

To get you started, DNSFilter provides several templates you can work from to custom-brand your mailings sent out. You can access them from the Campaigns > Templates menu on the left sidebar.

You can make a copy of these templates, but please make sure that you don't change the template's name. The original name has to be preserved for our system to work. You may change any other template elements as long as the template name is intact. You can also create a brand new template with the same name as the original.

You can make a copy of a template and modify it as you please. They need to retain their ‘name’ in ElasticEmail, such as ‘Reset Password MSP,’ for our system to work. Feel free to change any other template elements to fit your needs - the copied version you’ve made is just a guide, but you may completely change it or create a new template and call it ‘Reset Password MSP’ to have the emails use that template.

There are nine available templates:

• RC Uninstall Notification/MSP - This will alert you when a roaming client is uninstalled.
• Scheduled Report  DNS Protection Summary MSP - This gives you a 30-day protection summary report.
• Block Notification MSP - this message will be sent to the designated administrator when someone fills out the contact form on the block page (https://docs.dnsfilter.com/docs/block-pages#section-page-appearance), informing the admin of their request to whitelist the site.
• Organization Usage Alert - This will provide information about when an organization has reached its usage amount if there is any.
• User Added to Organization MSP - an email that will be sent out when one of your organizations adds a new user to their account.
• Complete Signup MSP - an email sent out to new users of an organization so that they set their initial account password.
• CSV Export MSP - this email will be sent out when a client requests a CSV export from the Query Log tool (https://docs.dnsfilter.com/docs/query-log).
• Reset Password MSP - this email will be sent out when a user requests a password reset from your whitelabeled login panel.

Once you’ve completed all the steps in this guide, feel free to go back to the DNSFilter dashboard, add a new test user, and see if they get the email as expected. Check to ensure it did not go into the spam folder and that it looks as you desired. This is the initial email notification your customers will receive from you as you add them to our interface.

You also have the power to create mail campaigns that can be used for marketing or informational purposes. We encourage you to use your sub-account to make any communications with your clients that you would like.