Email notification tokens are MassTransit key words that are used in the Email notification action tasks for including contact names, files to transfer, contact email addresses, date, time, etc. in the email notifications messages. The tokens are replaced with live text when the email is generated.The tokens are case-sensitive and must be entered exactly as listed below:
$${{TokenName}}
Multiple tokens are also supported:
$${{TokenName}}$${{TokenName2}}
Below is the detailed list of all tokens available in MassTransit 7.
Available Tokens in MassTransit 7
The email notification tokens can be grouped in two groups: tokens that can be used in the email message body and subject, and token that can be used in the email message body only.
Subject and Message Body Token Names
These are the token names that can be used in the message body and in the message subject of the sent by Email notification actions emails:
Token Name |
Function |
Supported versions |
ContactName |
displays the name of the contact for which the action was triggered |
5.0 and later |
FirstName |
displays the contact's first name |
7.3 and later |
LastName |
displays the contact's last name |
7.3 and later |
Date |
displays the short format of the date of sending the email |
5.0 and later |
LongDate |
displays the long format of the date of sending the email |
7.3 and later |
ISODate |
displays the ISO standartized format of the date of sending the email |
7.3 and later |
Time |
displays the time of sending the email |
5.0 and later |
EventType |
displays the type of the event that triggered sending of the email |
5.0 and later |
XferNumFiles |
displays the number of files in the transfer |
5.0 and later |
XferSize |
displays the total file(s) size in the transfer |
5.0 and later |
XferXmitTime |
the total amount of time for the file transfer |
5.0 and later |
WebLoginName |
displays the Web Login Name of the new user that was just added; use this token with the When = Contact Added event condition |
6.0 and later |
OriginatingContactName |
displays the contact name of the originating user who sent the files |
6.1.1 and later |
OriginatingEmailAddress |
displays the email address of the originating user |
6.1.1 and later |
LicenseExpirationDate |
displays the date when the MassTransit Server license expires |
7.0 and later |
PasskeyTTLHours |
displays the number of hours the passkey link is valid for as set in the MassTransitEngine.cfg file; for more information, see Ad Hoc Delivery |
6.1.1 and later |
Subject |
this token is for use with the When = Files Requested and When = After Files Are Added event conditions as part of the Request Files feature in MTWeb and in MassTransit 7.1 and later, as part of the Send Files feature in MTWeb; it displays the subject of the message entered by the Web client contact who sends the files request or files |
7.0 and later |
Message Body Only Names
The token names which can be used in the email message body only are the following:
Token Name |
Function |
Supported versions |
EmailAddress |
displays the email address of the email recipient |
5.0 and later |
XferFileList |
lists each file by name and size; this token and XferFileListWithPath are mutually exclusive and should not be used together – if both are included in an action text, only one will be populated |
5.0 and later |
FTPLink |
displays an FTP link to the MassTransit web site login page; it should be used in emails to contacts that have a user name and a password to the MassTransit web site; for more information, see Ad Hoc Delivery page and the Security Considerations section below |
6.0 and later |
FTPLink_passkey |
displays a passkey FTP link to the contact's account in the MassTransit web site; this token should be used in emails to users that do not have login credentials for the MassTransit web site; for more information, see Ad Hoc Delivery page and the Security Considerations section below |
6.0 and later |
HTTPLink |
displays an HTTP link to the MassTransit web site login page; for more information, see Ad Hoc Delivery page and the Security Considerations section below |
6.0 and later |
HTTPLink_passkey |
displays a passkey HTTP link to the contact's account in the MassTransit web site; this token should be used in emails to contacts that do not have login credentials for the MassTransit web site; for more information, see Ad Hoc Delivery page and the Security Considerations section below |
6.0 and later |
Note |
this token is for use with the When = Files Requested event condition as part of the Request Files feature in MTWeb; it displays the message entered by the Web client contact that sends the files request; in MassTransit 7.1 and later, use the Message token |
7.0 |
Message |
this token replaces the Note token; it is for use with the When = Files Requested and When = After Files Are Added event conditions as part of the Request Files feature and as part of the Send Files page in MTWeb; it displays the message entered by the Web client contact that sends the files request or files |
7.1 and later |
XferFileListWithPath |
populates a list of the transferred files that includes file paths; this token and XferFileList are mutually exclusive and should not be used together – if both are included in an action text, only one will be populated |
7.1 and later |
Security Considerations
There are four types of e-mail links:
The FTPLink and HTTPLink have different security considerations than FTPLink_passkey and HTTPLink_passkey.
When the FTPLink or HTTPLink types are used, the users of the web client (for FTPLink and HTTPLink – Web client contacts; for HTTPLink – Ad hoc contacts) receive e-mails that contain a web browser link. This link directs the user to the MTWeb login page with their login name field filled in. If the e-mail is intercepted, a third party will know the web client user’s login name but NOT their password.
When the FTPLink_passkey or HTTPLink_passkey types are used, e-mails sent to web client users contain a link with a temporary passkey code. When this link is clicked, the user is automatically logged into MTWeb under his account and is able to transfer files. If the e-mail is intercepted, a third party can log into MTWeb under the user’s account until the passkey expires. The only way to fully prevent a third party from gaining access is by ensuring that e-mails with passkey codes are not intercepted. Another preventative measure to take is to reduce the amount of time a passkey lives by modifying the passkey lifetime parameters in the MassTransitEngine.cfg file.