Gentrack Integration Resources

Mandrill

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

  1. Login to your Mandrill account. Under Settings > API Keys, click New API Key to Create API Key.

  2. Login to Gentrack Cloud Developer Portal. Click Connector Store from the sidebar. Find the Mandrill card, then click Setup new instance.

  3. 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.
  4. If the setup is successful, the connector instance will be added to My Connectors list.

Managing Connector Instances

  1. To manage your connector instances, click My Connectors from the sidebar.

  2. Click on the Mandrill connector instance that you want to configure.

  3. 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

  1. To add an email template, click Add on the Mandrill Email Settings page. Select Email and Mandrill Template associated with the email chosen.

  2. Click Preview to preview the email.

  3. 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 EventTemplate Merge Variable
billNumberBILL_NUMBER
accountNumberACCOUNT_NUMBER
accountNameACCOUNT_NAME
contacts[*].preferredNamePREFERRED_NAME
lastDateLAST_DATE
lastBalanceLAST_BALANCE
paymentsPAYMENTS
creditsCREDITS
chargesCHARGES
balanceBALANCE
balanceDateBALANCE_DATE
overdueAmountOVERDUE_AMOUNT
dueAmountDUE_AMOUNT
dueDateDUE_DATE
currencyCURRENCY

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 EventTemplate Merge Variable
billNumberBILL_NUMBER
accountNumberACCOUNT_NUMBER
accountNameACCOUNT_NAME
contacts[*].preferredNamePREFERRED_NAME
lastDateLAST_DATE
lastBalanceLAST_BALANCE
paymentsPAYMENTS
creditsCREDITS
chargesCHARGES
balanceBALANCE
balanceDateBALANCE_DATE
overdueAmountOVERDUE_AMOUNT
dueAmountDUE_AMOUNT
dueDateDUE_DATE
currencyCURRENCY
Last updated on 1 Sep 2020