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

  1. Add a Mandrill plan to your already existing Mailchimp plan, i.e. you need a paid subscription to add Mandrill.

  2. Create a Mandrill API Key. Send the Key securely to Magine Pro.

  3. You can now create templates for sending transactional emails. You do this by clicking on “Outbound” then “Templates” and “Create a template”. 

  4. When creating a template, you will add a “Template slug”. This slug is used to identify which template should be used. If you have several translations for a template you should use the same slug, but add “_{language}” as a suffix. E.g. “welcome_en” will be the english translation and “welcome_es” will be the spanish translation while “welcome” will be the default.

  5. The “Template slug” should either be the exact one provided by Magine Pro, or the slug should be sent to Magine Pro. This depends on which kind of template should be used.


Supported Mandril templates

These are the different types of emails that we support at the moment.


Template
DescriptionTemplate slugHardcoded slugTriggerSetup
welcomeTemplateSends a welcome email to all registered users on signupwelcomeNoWhen the user is created in the magine serviceCreate the template in Mandrill. Use any slug of your liking. For default, end the slug with "_default". For any translations end with e.g. "_en". Then send the slug to Magine Pro to be added into our system
resetPasswordTemplateSends a email for users to be able to reset their passwordreset-passwordNowhen user clicks on reset password forgot my passwordCreate the template in Mandrill. Use any slug of your liking. For default, end the slug with "_default". For any translations end with e.g. "_en". Then send the slug to Magine Pro to be added into our system
resetPinCodeTemplateIf parental control / pincode protection is enabled, this email will be sent to users to get a new pincodereset-pincodeNowhen user clicks "Forgot my pincode"Create the template in Mandrill. Use any slug of your liking. For default, end the slug with "_default". For any translations end with e.g. "_en". Then send the slug to Magine Pro to be added into our system
forcedPinCodeTemplateThis email will be sent to a user when they register to give them a pincode. This applies if parental control / pincode protection is enabledforced-pincodeNoWhen a users signs up if parental control is active for the partner or the user enables pincode (does not seem to work, need to do API call towards the parental control endpoint and towards the user service)Create the template in Mandrill. Use any slug of your liking. For default, end the slug with "_default". For any translations end with e.g. "_en". Then send the slug to Magine Pro to be added into our system
subscriptionConfirmation
Template
Email that is being sent to confirm the purchase of a subscriptionsubscription-confirmationNoEvery time a user follow through a subscription purchase (adding a new subscription)Create the template in Mandrill. Use any slug of your liking. For default, end the slug with "_default". For any translations end with e.g. "_en". Then send the slug to Magine Pro to be added into our system
dunning-reminderEmail being sent to users to let them know that payment have failed and that they will soon lose their subscriptiondunning-reminder-{partner}-{locale}YesEach time money is failed to withdrawn in the subscription renewal process, maximum 3 attempts and every third day.Create a template in mandrill. When creating the template and your partner name (if you don't know it exactly, ask Magine Pro) is e.g. "partner". Then the slug should be "dunning-reminder-partner". If you also want one with e.g. german translation, then you use the slug "dunning-reminder-partner-de"
dunning-downgradeEmail being sent to users when they have lost their subscriptiondunning-downgrade-{partner}-{locale}YesWhen billing fails the 3rd time the account is downgraded and this email triggered.Create a template in mandrill. When creating the template and your partner name (if you don't know it exactly, ask Magine Pro) is e.g. "partner". Then the slug should be "dunning-downgrade-partner". If you also want one with e.g. german translation, then you use the slug "dunning-downgrade-partner-de"