Overview

Mandrill, a paid Mailchimp add-on, allows you to send data-driven emails, including targeted e-commerce and personalized one-to-one messages. With this integration, you can send email campaigns from the CleverTap dashboard through Mandrill.

Prerequisites for Integration

The following are the prerequisites:

• A Mandrill account with all the required setup and permissions to send email campaigns.
• A CleverTap account.

Integrate Mandrill into CleverTap

This process involves the following two steps:

1. Find Mandrill Project Details.
2. Configure Settings on CleverTap Dashboard.

Find Mandrill Project Details

To find Mandrill project details:

1. Log in to your Mandrill account.
2. Navigate to the Settings page from the Mandrill dashboard.
3. Click SMTP & API Info to view the Mandrill project details.

📘

Note

Keep the following details handy, as you will need them to configure the CleverTap dashboard:

• Host
• Port
• API Key

Configure Settings on CleverTap Dashboard

To configure the CleverTap dashboard:

1. Navigate to Settings > Channels > Email from the CleverTap dashboard.

2. Click + Provider. The Setup page opens.
3. Enter the following Provider credentials:

4. Click Save to save the provider settings.

🚧

API Key Encryption

CleverTap stores your credentials in an encrypted format. So, we recommend that you save the API Key somewhere. If you do not have this information, contact Mandrill support.

You can click Send Test Email and fill in your details to test the configuration details you have entered. Has it arrived in your inbox? If not, refer to Troubleshooting.

Handle Bounce, Rejection, Spam, and Unsubscriptions

When an email is classified as bounced or rejected or when a user unsubscribes or marks a particular email ID as spam, CleverTap must be notified so that it does not attempt any further deliveries to that mailbox. This is considered a good practice and helps improve your sender's reputation. A good sender reputation virtually guarantees better delivery rates.

To obtain such information, you need to create a webhook. To do so:

1. Navigate to Settings > Webhooks from the Mandrill dashboard.
2. Click Add a Webhook.
3. Ensure to select the following from the available options:
   • Message Is Soft-Bounced
   • Message Recipient Unsubscribes
   • Message Is Bounced
   • Message Is Marked As Spam, and
   • Message is Rejected.
4. Enter the CleverTap callback URL (from your CleverTap Email Settings section) in the Post To URL field.
5. Click Create Webhook.

Enable Unsubscribe Footer

Mandrill provides a default email unsubscribe template, which gives the email recipient an option to unsubscribe from the email list. When you select this option, the unsubscribe template is added at the bottom of all the outgoing emails.

Here is an example of the default unsubscribe footer of Mandrill:

To enable adding the default Unsubscribe Footer:

1. Navigate to Settings > Sending Defaults from the Mandrill dashboard.
2. Select Add Unsubscribe Footer.
3. Click Save.

Troubleshooting

If you encounter an error when sending a test email, ensure the following:

• Check your SPAM folder to see if the message has been classified as SPAM by your email provider.
• IP address does not restrict your Mandrill API key.
• Your Mandrill API key is active.