Automated Emails
Automated emails send an email to your customers when a specific event occurs in Cryptlex. The following events are supported:
license.createdlicense.renewedlicense.extendedlicense.expiring-soonlicense.expiredlicense.deletedlicense.subscription.updatedlicense.expiresAt.updatedlicense.key.rotatedlicense.maintenance-expiredlicense.maintenance-expiring-soonuser.createduser.reset-password-requestorganization.user.createdreseller.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 PMFor 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.00For 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
- On the
Settings -> Customizationspage in the admin portal, click theAddbutton in theEmail Sending Domainsection to add your domain. - Verify the domain by adding the required TXT and CNAME DNS entries.
- After you have added the CNAME and TXT records, click the
Verifybutton 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.