Configuring the delivery of an email treatment with the Send Email shape
The Send Email shape enables the user to configure an email message for delivery.
The following General Configuration options are available for this shape:
|Treatment Name||The property which holds the name of the Email Treatment to send. In the case of Online Delivery, the Treatment Name specified must be backed by an existing Email Treatment rule since this is used as the content of the email to be sent.|
|Key Code||Marketing code used to identify the treatment. This value can be output in the sent email and/or the output file/db, and can be used to track the performance of different treatments. If a key code value is specified on the Email Treatment being referenced, it will be populated into this field upon selecting the treatment.|
Emails can be delivered in various ways - they can be sent by the system (Online mode) or they can be written to a data warehouse for processing by other systems (File and DB modes). Users can enable one or more of these modes at the same time.
The following Delivery Configuration options are available for this shape:
|Deliver Online||Determines whether an actual email should be sent using the content in the specified Treatment Name.|
|Use Subject From Treatment (Online mode)||Denotes that this shape should directly use the Email subject specified in the referenced Email Treatment. This subject is shown as read-only in the “Email Subject” field.|
|Specify Subject(Online mode)||Denotes that this shape should use the specified “Email Subject”.|
|Email Subject (Online mode)||Subject of the email to be sent.|
|Write To File||Determines whether a record should be written to an output file.|
|Write To DB||Determines whether a record should be written to an output database table.|
|Select Template (File/DB modes)||File/DB Template rule which contains the specifics of what should be output to the file/table. This includes the file/table name, location, header information, and the specific data fields that need to be output. Refer to the Templates chapter for more information.|
Configuring Email Subject
The Email Subject field supports the following three formats:
- Plain text – If the subject contains plain text (with no quoted words); simply enter the text in the input field. The system will wrap the entire text around quotes.
- Quoted text – If the subject needs to include text in double quotes (e.g. The brand new “ProductName” is here!), then the entire subject must be in quotes with the desired quotes being escaped with a backslash. The example above should be entered as: “The brand new \”Product Name\” is here!”
- Property references – If the subject needs to contain property references (such as the
customer name), then the property reference needs to be concatenated to the remaining
subject by the plus (+) symbol. Each block of text that is not a
property reference should be wrapped in double quotes. This is exemplified below:
- Desired Subject: Hi <Customer’s Name>, a new “Product” awaits you!
- Entered Subject: "Hi " + .Customer.pyFullName + ", a new \"Product\" awaits you!"
If an email subject doesn’t meet the supported formats, the following error is displayed to the user: Invalid value specified for Email Subject. Value doesn’t adhere to the Validate: BalancedQuotationMarks.
Wait After Sending
Users can determine whether they would like to wait after sending an email. It is typical to enable this wait when customer response is expected for an email (such as accepting or rejecting an action). In other cases, the user might simply want to send an email and move on to the next step in the Flow. In such cases, waiting should be disabled on the Send Email shape. The wait options available are the same for all wait-based shapes and are described in the section on the Wait shape.
Users also have the option to specify the Outbound Email account to use for sending the email message. These accounts are typically configured by the administrator. Refer to the Email and SMS Account Configuration chapter for more details.
The following options are available in the Email Account sub-section under the Advanced section of the Send Email Properties modal:
|Use Default Email Account||Determines whether the Default Email account should be used for sending this email.|
|Specify Email Account||Determines whether a user-specified Email account should be used for sending the email.|
|Account||Name of the Outbound Email account to use for sending the email.|
|From/Reply To:Use Email Account Settings||Denotes that the sender’s name (from) and reply-to address in the email being sent should be taken from the values specified on the Email account.|
|From/Reply To:Use Operator Settings||Denotes that the name and email address of the operator that initiates this email should be used for the sender’s name and reply-to address.|
|From/Reply To:Override Settings||Denotes that user-specified values should be used for the sender’s name (from) and reply-to address in the email being sent.|
|From||Name that will be used as the sender’s name in the email being sent.|
|Reply To||Email address that will be set as the reply-to address in the email being sent.|
Testing the Send Email shape
The Send Email shape provides an easy mechanism to test its outcome. Users can employ this test mechanism to test the online delivery of the Email Treatment. This can be beneficial in verifying both the content of the email being delivered and any email configurations that were applied (such as the subject, sender’s name, and reply-to address). Finally, this also enables the user to verify any data references (both Action Data and Customer) in the Email Treatment that were used to personalize the email message.
The Test Message section lists the options available for configuring the test email message. This includes the following:
- To – Recipients of the test email. Select either Test
Recipients or Seed List.
- Test Recipients - Enter list of recipients. Each entry can either be the Operator ID of an existing user in the system or a valid email address. If the operator ID is entered, operator information such as the name and email is populated as the customer data and the test email is sent to the operator’s email address.
- Seed List - Select a predefined Seed List as the intended recipients of the test email. The data for each seed is populated as the customer data and is visible (if referenced) in the test email. In this case, the Email1 column in the Seed List (.pyEmail1 property) specifies the email address to which the test email is sent. Refer to the Seed Lists chapter for information on configuring a Seed List.
- Subject – Subject of the test email. This value is pre-populated with the subject specified in the Treatment tab. The user can choose to specify a different subject by selecting the Override subject option. Refer to the Configuring Email Subject section above for options available for this field.
After the test message has been configured, it can be sent via the Send Test Message button.