Transactional emails with Mandrill
Mandrill is a transactional email platform built by Mailchimp that can be used for one to one messages that are triggered by certain events. Typical transactional emails are reset password emails, receipt emails and welcome to the service emails. You can read more about Mandrill here.
Mandrill setup
- Add a Mandrill plan to your already existing Mailchimp plan
- Create a Mandrill API Key and then add it to the config section of the Magine Pro Console. Remember to activate the key and to give it full permissions.
- You can now create templates for sending transactional emails. The easiest way is to create the template in MailChimp and then export it to Mandrill. Read more here.
- We have several placeholders that you can add to your emails. Our system will automatically add the relevant content when the email is triggered. Read more here.
- When you create a template you will add a Template slug. This slug is used to identify which template should be used by our trigger. The name of your template in MailChimp will be the slug in Mandrill. Choose the naming wisely as you can't change the slug after the template was created in Mandrill. We have some naming suggestions in the table below.
- If you have several translations for a template you use the same slug, but add "-{language}" as a suffix. The template without a suffix will be default.
Mandrill templates are identified by their names, to differentiate templates by language, you should create separate templates for each language:
- Duplicate your existing template for each language.
- Add a language suffix to the template name, e.g. welcome-en for English, welcome-es for Spanish, welcome-fr for French. - Remember to add a from and to email address and a subject line, then publish the template
- Then add the default slug in the config section of the Magine Pro Console.
Supported Mandril templates
These are the different types of transactional emails that we support at the moment. For user interactions between the email and the website, you may need to add a default path to the URL in the email (i.e. /reset-password to the reset password email)
Template | Description/Trigger | Slug | Default Path |
Welcome | Sends a welcome email to all registered users when the user is created in the service | Suggestion: welcome | |
Reset Password | Sends an email to users with a reset password link when the user clicks on forgot my password. The link is valid for 2 hours. | Suggestion: reset-password | |
Set Pincode | If parental control is enabled, customers can request a new pin code when they click on "Forgot my pin code". | Suggestion: set-pincode | |
Subscription confirmation | Every time a user purchases a subscription offer this email is sent to confirm the purchase. Is sent once in 24h per user and offer. | Suggestion: subscription-confirmation | |
Rental confirmation | Every time a user purchases a rental offer this email is sent to confirm the purchase. | Suggestion: rental-confirmation | |
EST confirmation | Every time a user purchases an EST offer this email is sent to confirm the purchase | Suggestion: est-confirmation | |
Forced downgrade warning | When a recurring transaction fails the 1st Or 2nd time this email is sent to users to let them know that payment has failed and that they need to check their payment method. | Suggestion: dunning-reminder | |
Forced downgrade confirmation | When a recurring transaction fails the 3rd time this email is sent to inform users that they have lost their access to the offer | Suggestion: dunning-downgrade | |
Subscription Cancelation | When a subscription is cancelled the email is sent to confirm cancellation. Is sent once in 24h per user and offer. | Suggestion: | |
Subscription Uncancellation | When a subscription is uncancelled the email is sent to inform that the subscription will continue. Is sent once in 24h per user and offer. | Suggestion: | |
Subscription price change | When the price of a subscription offer is officially changed for new purchases as defined in the offer (Date X) | Suggestion: |
If the emails aren't triggered start troubleshooting here.