Defining the Mail Merge workflow step
CRM Workflows support a Mail Merge step. This step can be added and defined on the CRM Workflow Designer tab. The Mail Merge step tabs define the mail merge options. You can also send the merged file as an email attachment. When triggered, a mail merge is performed.
To define a CRM Workflow Mail Merge step:
- Click the Workflow Designer tab. See Workflow Designer Tab.
- Click the Add icon for the step that precedes the Mail Merge step. The Insert New Workflow Step window is displayed.
- Select the Mail Merge step. The Mail Merge step is added to the workflow. See Inserting a new CRM workflow step .
-
Double-click the Mail Merge step, or
right-click the Mail Merge step and
click Edit in the
Icon view to view the Mail Merge step editor.
Note: You can also click the Settings icon in the upper right corner of the card in the Card view.
-
Specify this information on the General tab:
- Caption
- The label for the Mail Merge step.
- Delay Duration
- A numeric value for a delay in days, hours, or minutes before this step is triggered, if required.
- Delay Increment
- Specifies the time increment used for the delay duration.
Select in Days, Hours, or Minutes to define the unit in which the
delay duration is measured before this step is triggered. Possible
values:
- Days
- Hours
- Minutes
- Edit Condition
- Click Edit Condition to define the condition that must be met before the Mail Merge step is triggered. See Defining CRM Workflow step conditions.
-
Click the Mail Merge Options tab to
define mail merge options. Perform these steps:
- Click Configure Mail Merge. The Mail Merge window is displayed.
- Click the Merge Options tab to
select the output type and set merge options. See Setting merge options for Mail Merge.Note: When defining a mail merge step for a campaign CRM workflow, the Template field is replaced with the Contact Template and Lead Template fields so that each contact or lead receives the correctly formatted document.
- Click the History Options tab to set history options. See Setting history options for Mail Merge.
- Click the Follow-Up Options tab to schedule a follow-up activity after the merge. See Setting Follow-Up activity options for Mail Merge.
- Click OK.
-
Select the Attach merged document to email and
send check box on the Mail Merge window, if
available. Select this check box to send an email with the merged file as an
attachment. If this option is selected the Template and Recipients tab are available to define the email message.
Note: The Attach merged document to email and send check box is enabled only if the on the Output Type is set to File in the Merge Options tab when you click Configure Mail Merge.
-
Specify this information on the Template tab:
Note: The Template tab is available only if the Attach merged document to email and send check box is selected on the Mail Merge Options tab.
- Subject
- The text that must be displayed in the email subject. Use the @-mention user
interface to include dynamic CRM content in the subject
content.Note: The @ mention token menu is not displayed if the @ character is preceded by an alpha or numeric character without a space. Examples:
- Typing name@ does not display the @ mention token menu.
- Typing name @ displays the @ mention token menu.
- Email Body
- The text that must be displayed in the email body. Use the @-mention user
interface to include dynamic CRM content in the email body.Note: The @ mention token menu is not displayed if the @ character is preceded by an alpha or numeric character without a space. Examples:
- Typing name@ does not display the @ mention token menu.
- Typing name @ displays the @ mention token menu.
Format the text content of the email template. Possible values:
- Bold, italic, or underlined content
- Numbered or bulleted lists
- Multiple font sizes supporting heading levels of 1 through 6, along with the normal paragraph font size
- Font color and background color selections
- Standard browser fonts of Sans Serif and Serif
- Left, right, and center text alignmentNote: Use the Tx icon to clear all formatting from the selected text.
-
Specify the email recipient related data on the Recipients tab:
- Specify (in the To, CC, or Bcc fields) one or more email
addresses or use the @-mention user interface to include CRM contacts,
leads, users, teams of users, or departments of users in the email
distribution list. Possible scenarios:
- Adding a Contact: Enter @Email and select the Email token for the contact or contact related property. For example, in for a sales order workflow, select BillingContact.Email.
- Adding a Lead: Enter @Email to send to a lead for a lead workflow.
- Adding a User: Enter @ followed by a user field. For example, AccountManager or Owner.
- Adding a Team: Enter @ followed by the name of the team to send the email to all users on the team. For example, @Global
- Adding a Department: Enter @ followed by the name of the department to send the email to all users on in the department. For example @Marketing
Note:- Multiple addresses must be separated by semicolons.
- Properties and the related entity email properties are available displayed only if the Expose to Workflow field or property attribute is set to True. For example, for the Return.Returned By field to be available, the Return.ReturnedBy relationship to the Expose to Workflow Contact entity attribute must be set to True.
- For custom email properties the data Type property or field must be set to Email. All standard email properties have a type of Email.
- Press Enter or click out of the field to add the entries to the distribution list.
- Use the check boxes in each grid row to determine whether the recipient for a user or
owner field token is the user, the user’s manager, or both. If you clear
all check boxes for a user or owner field token, that token has no
recipients.Note: These check boxes are editable only for user or owner field tokens. If the owner of a record is a team or department, the Send to user’s manager selection is not considered since departments and teams do not have a manager. Possible scenarios:
- Sending an email to the user: Select the Send to check box and clear the Send to user's manager check box.
- Sending to an email to the user’s manager: Clear the Send to check box and select the Send to user's manager check box.
- Sending the email to user and the user’s manager: Select the Send to check box and select the Send to user's manager check box.
- Click Remove, to remove an item from the grid.
- Click the Maximize or Minimize arrow to display or hide a grid
- Specify (in the To, CC, or Bcc fields) one or more email
addresses or use the @-mention user interface to include CRM contacts,
leads, users, teams of users, or departments of users in the email
distribution list. Possible scenarios:
-
Click OK to save the mail merge
step.
Note:
- Create and define the next step if the mail merge step is
completed:
- Click the Complete Add icon after the Mail Merge step.
- Select the required step action.
- Define the step.
- Create and define next step if the mail merge step results in an
error:
- Click the Error Add icon after the Mail Merge step.
- Select the required step action.
- Define the step.
- Create and define the next step if the mail merge step is
completed: