Skip to main content
Kinetic Community

Message Templates

Overview

Create Email Templates for Messaging

Message Templates

The Message Templates console allows you to create and manage the format of your email messages.  In addition to conventional text and HTML markup, these message templates allow you to insert field placeholders that populate when a request uses that template.

 For Kinetic Request, email messages are typically two types:

  • Request Invitations:  Email messages with a link to a request to be completed by the recipient (typically a request for approval/denial).
  • Request Notifications:  Email messages that are sent at some point after the submission of a request.  These would include escalations to managers when a request needs attention and thank you’s to request participants.

When the Messaging Template Manager opens, the Search Category field is automatically populated using the Service Catalog that was last viewed. 

Example Message Template Dialog:

message template basic.JPG

Searching and Creating

Search Category lets you define all the message templates related to service catalog.

Search Type defines by the Type field on the message type.

Search/Clear operate on search selections.

Delete removes the selected message template.

NOTE: Message templates are meant to be used by multiple service items. Make sure it is not used at all before deleting.

Clone makes a copy of the message template with the word - clone after the name.

New Template opens the new message template dialog.

Example of New Message Template dialog:

message template new dialog.JPG

Enter a Message Template Name, create a name with some meaning that is easily recognizable (required).

Message Template Format is a drop-down list box select either HTML or Plain Text (required).

Category field automatically populates with the current service catalog.  Use this category, select another category, or leave the field blank.  Message templates with a category will only be visible to requests of the same category.  If you want the message template to be available from multiple service catalogs, then leave this blank.

Type field is a drop-down list of current type or add a new type.  Types are optional and only needed if you want to further categorize your message templates for easier searching later.

Originating Form field pre-populates or select one from the drop-down list. This menu helps you determine which form to use. 

  • Post-Survey Notification: KS_SRV_CustomerSurveyResults_join

     

  • Pre-Survey Invite: KS_SRV_CustomerSurvey

 

 

Mailbox Name is a list of all the outgoing mailboxes setup in your Remedy email engine.  If no value is selected, the default outgoing mailbox is used.

Subject field is the subject line of the email.

Use the Add Fields button to add answers or attributes from requests.  However, there is limit of 255 characters on the field, so be cautious what fields you add.  The add fields action is the same as the Body section.

Priority, enter a number in the Priority field Lower numbers are a higher priority. Three is normal.

Body Text field, type the text you want to appear in the body of the email.  If your message format is HTML, you can use any standard HTML markup within the body of the email.

Add Fields button works almost the same as a Text Element. However, message templates are meant to work across multiple service items.

Add Tag menu lets you can use special tags to include special html text within your request.  Use the Add Tag menu to include one or more of the following tags.

  • Anonymous Link:  For a request invite, this will include an anonymous URL.
  • Targeted Link:  For a request invite, this will include a targeted URL (specific to a single recipient).
  • Embed Link:  This will embed the first page of your request into the email.  Any subsequent pages (content or confirmation) will be displayed in a web browser.   A person filling out an embedded request must have a network connection that can reach your Kinetic request web server.  Embedded requests are limited in their functionality due to security limitations in email clients.
  • Opt Out Link:  This will embed a link to a special request that a user can click on to opt out of future request invites.
  • Submitted Link:  For post- request notifications, this will embed a link into the email to open the completed request in a web browser.  This link uses the AR System Midtier application to display a Kinetic Request form to display the results.  For security reasons, users wil be asked to login prior to seeing the results and must have Kinetic request Inspector priveledges.

Preview Tab lets you see an aproximation of the message template with any HTML formatting.

Attachments tab lets you add attachments to the email message. This is a static attachmnet that cannot be changed.

Modifying Message Templates

To modify a message template, select it from the table, and make the changes you want to any of the fields. Be cautious with your changes.