# Message Templates

**Message templates** are used mainly in connection with sending e-mails to your clients, prospects or partners.

Message template may be used when sending individual e-mail correspondence. Message template is required when sending Mass Mail. Message template is heavily used when automating processes using Atollon Troll (Workflow) module.

## Message Templates Overview

The overview of message templates provides list of **Message Template Containers**. Click on one of the containers to add / view / edit / delete one of the message templates on right.

You can filter only for Message Templates in specific language by selecting one of the languages in the list of languages.

[![message-template-create-edit.png](https://help.atollon.com/uploads/images/gallery/2020-03/scaled-1680-/message-template-create-edit.png)](https://help.atollon.com/uploads/images/gallery/2020-03/message-template-create-edit.png)

## Edit Message Template

To edit the Message Template, double click on one of the items in grid.

[![message-template-create-edit2.png](https://help.atollon.com/uploads/images/gallery/2020-03/scaled-1680-/message-template-create-edit2.png)](https://help.atollon.com/uploads/images/gallery/2020-03/message-template-create-edit2.png)

Once you make any changes, do not forget to press on "Save", please.

You can attach one or more files or documents to each Message Template.

## Message Template Languages

Each message template may have indicated language, in which the template is prepared. This is particularly useful when automating workflow actions on multi-lingual web sites, etc.

[![message-template-create-edit-translate.png](https://help.atollon.com/uploads/images/gallery/2020-03/scaled-1680-/message-template-create-edit-translate.png)](https://help.atollon.com/uploads/images/gallery/2020-03/message-template-create-edit-translate.png)

## Mail Merge Fields

Basic rule for using merge fields:

- ${CAPITAL-LETTERS} - may be used on both client & server side
- ${small-letters} - may be used on client side only

### General

```wiki
${SALUTATION} | Enters the string that is found in recipient contact's Salutation field.
${SIGNATURE} | Enters user's mailbox identity signature.
```

### Calendar / Tasks Notifications

```wiki
Main tags
${NAME} | Task / Event name
${DESCRIPTION} | Task / Event description
${STATUS} | Task / Event status
${START} | Task / Event start date/time
${END} | Task / Event deadline / end date/time
${CONTEXT} | Task / Event context
${TYPEOFWORK} | Task / Event context

Other tags
${LOCATION} | Event location
${PRIORITY} | Task priority
${DURATION} | Event duration
${REMAINING} | Event duration

${USERS} | Event participants / Task solver
${GARANTS} | Resource garants
${RESOURCES} | Resources




```

### Service Level Notifications

```wiki
${REQUESTSUBJECT} | request subject
${REQUESTDESC} | request description 
${REQUESTIDENT} | request id
${REQUESTSENDER} | request sender
${REQUESTPROJECTNAME} | project & subject (if is known) 
${REQUESTDATETIME} | request date/time
```

### Message Context Dependent <span class="searchword1">Field</span>s

```
${ACTIVITYNAME}
${ACTIVITYREFID}
${PROJECTNAME}
${PROJECTREFID}
${MASTERPROJECTNAME}
${MASTERPROJECTREFID}
${FOLDERNAME}
${FOLDERREFID}
${CONTEXTREFID}

```

### Recipient Dependent <span class="searchword1">Field</span>s

```
${RECIPIENT-ID}
${RECIPIENT-EMAIL}
${RECIPIENT-FIRSTNAME}
${RECIPIENT-MIDDLENAME}
${RECIPIENT-LASTNAME}

```

### Invoice Fields

```
${doc_number}
${doc_descr}
${doc_total_amount} 
${doc_due_date}

Same naming conventions are for all following items (${word before :} 
                
doc_number:"invoiceNumber",
doc_descr:"transactionsName",
doc_total_amount:"totalWithVAT",
doc_due_date:"dueDate",
doc_ccy:"currency",
doc_ccy_rate:"currencyRate",
doc_bank_code:"bankCode",
doc_bank_account:"bankAccount",
doc_iban:"bankIBAN",
doc_description:"description",
doc_header_text:"headerText",
doc_footer_text:"footerText",
doc_summary_text:"summaryText",
doc_period_from:"periodFrom",
doc_period_to:"periodTo",
doc_trans_name:"transactionsName"      
```

### Custom Form

```
${generatedLink}
```

### Campaign Planner / Event

```
${eventFrom}
${eventTo}
${eventLocation}
${eventUserName}
${eventDescription}
```

### Folder / Project / Activity (Context items)

```
${contextName} -> name
${contextReferenceId} -> referenceId
${contextComment} -> comment
${contextCreated} -> created
${contextCreatedBy} -> createdByName
${contextModified} -> modified
${contextModifiedBy} -> modifiedByName
```

## System IDs for message templates in system

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-systemid-description"><tbody><tr><td>SystemId</td><td>Description</td></tr><tr><td>com.atollon.messaging.issudedinvoicemail</td><td>template with message for mail with issuded invoice</td></tr><tr><td>com.atollon.messaging.invoicereceivedmail</td><td>template with message for mail with recieved invoice</td></tr><tr><td>com.atollon.messaging.orderissuedmail</td><td>template with message for mail with issuded order</td></tr><tr><td>com.atollon.messaging.orderreceivedmail</td><td>template with message for mail with recieved order</td></tr><tr><td>com.atollon.messaging.estimatemail</td><td>template with message for mail with estimate</td></tr></tbody></table>