Mandrill
On this page
Mandrill is a transactional email API for MailChimp users. It’s reliable, powerful, and ideal for sending data-driven emails, including targeted e-commerce and personalised one-to-one messages.
Gentrack Cloud Integration Services offers a native integration with Mandrill. This means that you will be able to leverage Mandrill’s Template system and email infrastructure to send to your customers.
Connector Instance Setup
Login to your Mandrill account. Under Settings > API Keys, click New API Key to Create API Key.
Login to Gentrack Cloud Developer Portal. Click Connector Store from the sidebar. Find the Mandrill card, then click Setup new instance.
On the setup page, the following values are required:
- Mandrill API Key to be used for email delivery;
- Tenant that will be connected to this connector instance.
If the setup is successful, the connector instance will be added to My Connectors list.
Managing Connector Instances
To manage your connector instances, click My Connectors from the sidebar.
Click on the Mandrill connector instance that you want to configure.
This will get you to the Basic Information page where you can see and update the Mandrill API Key being used, as well as enable or disable email attachments. This setting applies for all the emails sent through the connector instance and is enabled by default.
Configure Email Template
To add an email template, click Add on the Mandrill Email Settings page. Select Email and Mandrill Template associated with the email chosen.
Click Preview to preview the email.
If no change is required, click Save to save the setting.
There will be an error icon beside the template name if the template is missing some key information, for example: From Address
, From Name
, or Subject
. Click the preview button for that template to see which fields are missing.
The error in the template MUST be fixed, otherwise, the template will not be ready for sending emails.
In case of this error, go to Mandrill to configure From Address
, From Name
and Subject
for the template.
Template Merge Variables
When designing your email templates in Mandrill, you MUST use Template Merge Variables of each email defined by Gentrack Cloud Integration Services, so that they can be replaced with recipient-specific contents while sending emails.
Regular Bill
Regular bill has been accepted and is ready to be sent to the customer.
- Junifer 6.45+
- Velocity - Not Supported
Fields in GCIS Event | Template Merge Variable |
---|---|
billNumber | BILL_NUMBER |
accountNumber | ACCOUNT_NUMBER |
accountName | ACCOUNT_NAME |
contacts[*].preferredName | PREFERRED_NAME |
lastDate | LAST_DATE |
lastBalance | LAST_BALANCE |
payments | PAYMENTS |
credits | CREDITS |
charges | CHARGES |
balance | BALANCE |
balanceDate | BALANCE_DATE |
overdueAmount | OVERDUE_AMOUNT |
dueAmount | DUE_AMOUNT |
dueDate | DUE_DATE |
currency | CURRENCY |
Final Bill
Final bill has been accepted and is ready to be sent to the customer.
- Junifer 6.45+
- Velocity - Not Supported
Fields in GCIS Event | Template Merge Variable |
---|---|
billNumber | BILL_NUMBER |
accountNumber | ACCOUNT_NUMBER |
accountName | ACCOUNT_NAME |
contacts[*].preferredName | PREFERRED_NAME |
lastDate | LAST_DATE |
lastBalance | LAST_BALANCE |
payments | PAYMENTS |
credits | CREDITS |
charges | CHARGES |
balance | BALANCE |
balanceDate | BALANCE_DATE |
overdueAmount | OVERDUE_AMOUNT |
dueAmount | DUE_AMOUNT |
dueDate | DUE_DATE |
currency | CURRENCY |