Automated Emails

Automated emails send an email to your customers when a specific event occurs in Cryptlex. The following events are supported:

  • license.created
  • license.renewed
  • license.extended
  • license.expiring-soon
  • license.expired
  • license.deleted
  • license.subscription.updated
  • license.expiresAt.updated
  • license.key.rotated
  • license.maintenance-expired
  • license.maintenance-expiring-soon
  • user.created
  • user.reset-password-request
  • organization.user.created
  • reseller.user.created

Creating an automated email

To create an automated email, go to the Developer -> Automated Emails section in the admin portal and click the Add button. An automated email form with the following fields will pop up:

Name

Name of the automated email.

From Name

The from name that should appear for the email.

From Email

The email address to be used for sending the email.

Subject

The subject of the email. This can contain data placeholders too.

ReplyTo

The reply-to address for the email. We recommend setting this to your support email.

Body

The body of the email. You can use HTML for formatting.

Event

The event to trigger the email.

Enabled

If unchecked, the automated email will be disabled and no email will be sent on the defined event.

Custom

By default, your email body will be automatically wrapped in a responsive HTML email. In case you want to prevent that and use your own branded email, this property can be set to true.

Data placeholders

All the properties of user, license and product resources can be accessed in the body and the subject of the automated email. The general syntax is resource.propertyName. The following is a sample automated email body:

<p>Dear {user.firstName},</p>

<p>Thank you for ordering {product.displayName}.</p>

<p>Your license key for the {product.displayName} is:</p>

<p><b>{license.key}</b></p>

<p>
You can use this license key to activate {product.displayName} on
<b>{license.allowedActivations}</b> device(s).
</p>

<p>
For any queries or issues you can contact us at
<a href="mailto:support@mycompany.com">support@mycompany.com</a> and we will assist you promptly.
</p>

<p>
Best Regards,<br />
The MyCompany HelpDesk
</p>

Data filters

Data filters can be used to format the date and number fields in automated emails.

format_date

Formats date and times.

Input

{{ license.expiresAt | format_date: "G" }}

Output

6/15/2021 1:45:30 PM

For more date format specifiers refer to the following: https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings#table-of-format-specifiers

format_number

Formats numbers.

Input

{{ license.allowedActivations | format_number: "N" }}

Output

10.00

For other supported filters please refer to the following: https://shopify.github.io/liquid/filters/abs/

Sending test emails

After you have created the automated email, click the Send Test Email option in the actions menu in the table. You can use this to test your automated email.

Verifying email domain

For Cryptlex to send emails on your behalf using your From Email address, you must verify that you own the domain. This is done by adding a Sending Domain in Cryptlex and verifying the DNS records shown in the Sending Domain.

If you don't add the domain verification records, Cryptlex sends emails using the noreply@cryptlex-mail.com email address. If you want to give your customers a white-label experience, hiding all Cryptlex branding, you must add and verify the sending domain.

To verify that a domain belongs to you

  1. On the Settings -> Customizations page in the admin portal, click the Add button in the Email Sending Domain section to add your domain.
  2. Verify the domain by adding the required TXT and CNAME DNS entries.
  3. After you have added the CNAME and TXT records, click the Verify button to confirm that all of your records are now valid.

After your domain is verified, leave the CNAME and TXT records in place.

Automated email event logs

Automated email event logs show information about the emails that were sent by an automated email. You can use automated email event logs to see the status of all the emails that were sent, the email body and even manually resend the email if needed.

WebhooksStripe
Last updated: