Document Templates
Upload .docx templates for agents to use in tickets. Insert placeholders for ticket data and custom field values.
Upload document templates for agents to use in ‘Ticket Details’.
The default view shows the list of already uploaded Document templates.
Creating a document template
To add a new Document template simply click the button.
Now, in the ‘Create document template’ put some name (‘Name’) for your template then select the Queues. Depending on your choice your template will be available to use only for tickets created in or moved to those Queues. If you want, you can also add some description (‘Description’).
Now you need to add an external file which contains the prepared Document template. MINT Service Desk only supports one file format: .docx.
To create such a Document template, you need to use external software e.g., Microsoft Word or any other which can save the file in .docx format.
System data placeholders
Use placeholders to insert system data. Enter {{Company}} in the template, for example. When an agent uses the template, {{Company}} is replaced with the client’s company name.
For the purpose of creating a Document template, you can add the fields below.
| Placeholder | Location/used in | Description |
|---|---|---|
| {{PrintDate}} | Ticket Details | Date of creating a ticket .pdf preview. |
| {{TicketName}} | Ticket Details > Details | Ticket name/title. |
| {{TicketNumber}} | Ticket Details > Details | Ticket number. |
| {{Customer}} | Ticket Details > Details | Ticket owner’s name – a person who created the ticket. |
| {{Company}} | Ticket Details > Details | Company name of the ticket owner. |
| {{Status}} | Ticket Details > Details | Ticket current status. |
| {{Assignee}} | Ticket Details > Details | A person (Agent) assigned to the ticket. |
| {{Queue}} | Ticket Details > Details | Ticket Queue name. |
| {{TicketType}} | Ticket Details > Details | Ticket type name. |
| {{Priority}} | Ticket Details > Details | Ticket priority. |
| {{Service}} | Ticket Details > Details | Name of the chosen Service for the ticket. |
| {{Age}} | Ticket Details > Details | Ticket age (in hours or days). |
| {{TicketCreationDate}} | Agent/Client Dashboard | The exact date when the ticket was created. |
Custom field placeholders
To insert a custom field from Tickets or Users, use this syntax:
{{GroupName:AttributeName}}
Example:
For the “Desktop” and “Laptop” attributes, use {{Hardware:Desktop}} and {{Hardware:Laptop}}.
If Users and Tickets have the same group and attribute names, MINT uses the value from the ticket’s custom field.
Below you can see how a prepared template document should look like.
Placeholders are written in blue.
Uploading and saving
Now, when you have such a Document template ready you can upload it to the MINT Service Desk. In the ‘Files’ part click on the ‘Click to attach file’ field.
In your system’s file explorer find, select and add your custom-made Document template. Once you do that you will see a file miniature in the ‘Files’ part.
If you want to delete the file and add a new one you can do that by clicking the X button located at the top right corner of the file’s miniature the moment you move your mouse cursor over it.
Once you decide that everything is in order click button. After that, you will notice a new position on the list of available Document templates.
Now Agent can use it while communicating with a Client, inside the ‘Ticket details’ view. It was already described in the Agent > Ticket Details part of this guide.