Configuring Correspondence

In Pega, you configure emails, letters, faxes, and text messages with correspondence rules. Correspondence rules allow you to add case data to your communication to provide richer, more relevant communication to stakeholders and case workers.

How to Configure Correspondence Rules

Create correspondence rules in HTML to define templates for the content of outgoing correspondence.

Each correspondence rule contains text for one type of correspondence such as email, letter, SMS phone text, or fax.

JavaServer Pages (JSP) tags or directives allow correspondence to incorporate property values and calculations.

For simple notifications, add text directly in the rule.

For richer content, enter dynamic fields that reference  properties, or rules such as sections, paragraphs, or correspondence fragments.

During flow processing, the system uses the source content in the  correspondence rule to generate a customized message for the recipient. 

Identify the Correspondence Type

When creating a correspondence rule, specify the correspondence type as a key identifier.

A correspondence type rule indicates whether a piece of correspondence is a printed letter, fax, email, or SMS phone text.

Each type is associated with a different data subclass.

Add the Content

Add the message on the Corr tab of the rule form.

The tab presents a rich-text editor in which you create the source content for the correspondence.

Options in the editor allow you to add case content to correspondence.

Click Source to view or update the source as HTML codes. In source mode, you can add HTML elements and JSP tags directly.

When the correspondence is an email, the outgoing email includes HTML formatting, even if no HTML elements appear within the source.

When the correspondence is phone text, the message does not contain HTML formatting.

Click the Insert Rule icon to include content in other rules, including other correspondence rules.

Paragraphs present formatted text that can include colors, fonts, styles, and images. You can reuse paragraphs in UI forms.

Sections allow you to reproduce part or all of a form in the correspondence. Use a section to achieve greater control over the positioning of content in the correspondence.

Correspondence fragments are useful for boilerplate content, such as a mandatory disclosure or links to social media channels.

The editor uses angle (<< and >>) brackets to mark rules and properties.

When the correspondence is sent, the system replaces the properties with their values.

How to Configure Correspondence in a Business Process

You can configure your application to automatically send:

Emails, faxes, letters, or text messages when a case advances in the process using the Send Email Smart Shape or a correspondence Utility.

Email notifications when a case reaches an assignment.

Email service level (SLA) notifications when an assignment has passed its deadline.

Use flow actions so users can select and send correspondence as needed.

Using the Send Email Smart Shape

Add the Send Email Smart Shape to your flow diagram to automatically send emails as a case advances during the business process.

This Smart Shape is useful if you want to notify or send information to users after an action has been performed on a case.

Use the Smart Shape to create simple text messages that you configured using the rich text editor.

You can also send emails that you configured in a correspondence rule.

To add a Send Email Smart Shape from the case life cycle, select Utilities > Send Email, and then click Select.

The system displays the Send Email properties panel on the right side of the case life cycle.

To use a correspondence template that was previously created, select Correspondence and select the rule name.

When you add the Send Email step, the system adds to the flow diagram a Send Email Smart Shape in the position you specified in the stage.

You can also add the Send Email Smart Shape directly to the flow diagram.

Send Correspondence Using a Utility Shape

A Utility shape configured with the CorrNew activity offers greater flexibility than the Send Email Smart Shape.

Use the activity to send all types of correspondence including mail, faxes, and text messages.

To send correspondence using CorrNew:

To add a Utility shape to your process, open the properties panel and select CorrNew in the Rule field.

Provide values for the parameters.

When a case reaches the utility, the system sends the correspondence.

Send Notifications from Assignments

Use a Notify activity to automatically send email notifications when a case reaches an assignment.

On the Assignment properties panel in the Notifications section, enter the party to notify.

Then, enter the subject line text and select the correspondence rule in the CorrName field.

Send Reminders from SLAs

Set reminders in SLAs so that when the goal or deadline of a service level agreement has been reached, a notification email is sent out.

Add an escalation action to the SLA.

In the Perform Action drop-down, select a standard Notify action.

Specify a party role and reference a correspondence rule.

Manually Send Emails Using Flow Actions

Users often encounter questions or issues that are not part of the usual business process.

Add the standard SendCorrespondence local action to your application so that users can select the correspondence they need when they need it.

Configuring Correspondence Rules

In the Application Explorer, locate the class in which you want to create the correspondence rule.

Right-click on the class and select +Create > Process > Correspondenceto open the Create Correspondence form.

Enter a name for the correspondence in the Label field and select the correspondence type.

Click Create and Open. The Correspondence form is displayed.

Enter the text you want to include in your email correspondence.

Select the field you want to replace with a dynamic reference to a property and click the Insert Property icon on the toolbar to open the Property Parameters dialog.

Select the name of the property in the Name field and click Save.

Insert the necessary properties in the form.

Click Save.

To preview the email, on the rule form header, select Actions > Preview.