Message template variables for Powered Now

In this article we are collecting and summarising the short codes we use to create the messages for each message type. Please note that some of the short codes can be customised. A customisation guide is present at the end of this document.

Each short code will need to be within these brackets in order for them to populate in the email/text sent to the customer - { }

 

1, General short codes

These short codes are available for every message type. They contain company related or user related information regardless of the type of the message.

 

companyname - Returns the name of the company.

 

companyState - Returns the state of the company sending the message.

 

senderName - Returns the user's full name who is sending the message. If there is no user (e.g. quote and invoice reminders) it will return an empty string.

 

senderFirstName - Returns the user's first name who is sending the message. If there is no user (e.g. quote and invoice reminders) it will return an empty string.

 

quoteTerminology - Returns the current quote terminology, usually estimate or quote.

 

location - Returns the location of the project the topic of the message belongs to.

 

siteAddress - Returns the site address if the record has it. Otherwise returns nothing. 

 

certificateName - Can only be used for certificates. Returns the name of the certificate. Please note, some of our certificate names are customisable. In that case it returns the customised name.



2, Conditional general short codes

These short codes are to customise the messages depending on how the app is set up and what kind of customer or contact the user is addressing.

 

canSiteContactAccessPreviousMessages - Returns true if the customer can access the full Portal (e.g he has a Premium subscription).

 

isMainContact - Returns true if the receiver is a main contact.



3, Action specific short codes:

These short codes are only available for Actions (appointments and reminders):

 

a, Short codes for every action type

 

appointmentTime - Returns the appointment time e.g. 14:00

 

appointmentDate - Returns the appointment date e.g. 29/11/2024

 

appointmentDateTime - Returns the appointment date and time e.g. 29/11/2024 14:00

 

ampm - Returns the appointment time’s AM or PM label.

 

jobDescription - Returns the job title of the person allocated to the action.

 

durationType - Returns the duration type of the appointment. For example if you set it to be morning, it returns “morning of….”. Will return nothing if the appointment is no full day or half day.

 

dateTimeFormat - This code gets the plan type (unplanned, unplanned for a day, exact date) and returns the associated time format for it. E.g. it returns “Do MMM Y [from] h:mm A“ for date.

 

projectName - Returns the name of the project the appointment is belonging to.

 

customerName - Returns the name of the customer the appointment is belonging to.

 

fullname - Returns the full name of the user assigned to the appointment.

 

b, Formattable values and properties

 

{dt_start:formatLocaleDateTime(values)} - Returns the formatted starting date and time.

 

{previousValues.dt_start:formatLocaleDateTime(values)} - Only available for updated or deleted appointments. Returns the formatted previous starting time.

 

{previousValues.dt_requested:formatLocaleDateTime(values)} - Only available for updated or deleted appointments. Returns the formatted request time. This value is only filled out if the appointment is requested from Portal.

 

{originalMessage.dt_sent:formatLocaleDateTime(values)} - Only available for document reminders. Returns the sent date of the document the reminder is belonging to. 

 

{dueDate:formatLocaleDateTime(values)} - Only available for document reminders. Returns the due date of the document the reminder is belonging to.

 

{total:formatMoney(values.currencyOptions)} - Only available for document reminders. Returns the formatted total of the document the reminder is belonging to. 

 

{eta:formatLocaleDateTime(values, "h:mm A")}  - Only available for Attending appointment notification. Returns the eta to an appointment in hour:minute AM/PM format. 06:00 is returned as 06:00 AM. 

 

4, Customer specific short codes:

These short codes are only available for Customers:

 

projectName - Returns the name of the project.

 

customerName - Returns the name of the customer.

 

customerFirstName - Returns the first name of the customer.



5, Payment specific short codes:

 

receiptLink - Returns the link to the payment receipt. Only works if the payment was a SumUp payment. Otherwise returns nothing.

 

{document.displaynumber} - Returns the display number of the paid document. 

 

{amount:formatMoney(values.currencyOptions)} - Returns the payment amount formatted by the currency options. Must be used as it is.

 

{dt_created:formatLocaleDateTime(values, "Do MMM Y")} - Returns the payment creation date formatted as 3 letter day 3 letter month year. 2024.12. 03 (Tuesday) is returned as Tue Dec 2024. 

 

6, Company specific short codes:

These are available in Options -> Company details and can also be provided on registration.

 

companyName - The name of the company

 

companyPhone - The phone number of the company.

 

companyEmail - The email address of the company.

 

companyPostcode - The postcode of the company.

 

companyCity - The city of the company.

 

companyAddress - Returns the address line 1 and the city of the company sending the message.

 

companyAddress1 - The line address 1 of the company.

 

companyAddress2 - The line address 2 of the company.

 

companyLogo - The logo of the company.

 

companyState - The state of the company.

 

7, Document related short codes:

 

displaynumber - Displays the document number. 

 

documenturl - Contains the portal URL of the created document.

 

location - Displays the formatted address of the current document with respect to the possible sites and plots. The order is: Plot - address line 1 - address line 2 - city - state - postcode



8, Forms and certificates related short codes:

 

certificateName - Returns the name of the certificate.



9, Formattable short codes:

There are some short codes which can be formatted. There are usually dates. Their structure is displayed as: {propertyName:function(values, "format")}.

 

a, formattable property names currently in use:

These are provided as default template elements.

 

{dt_start:formatLocaleDateTime(values)} - Only usable for appointments and reminders. Returns the formatted start date.

 

{previousValues.dt_start:formatLocaleDateTime(values)} - Only usable for deleted or updated appointments or reminders. Returns the start date the action had before formatting.

 

{previousValues.dt_requested:formatLocaleDateTime(values)} - Only usable for deleted or updated appointments if the appointment was created from a Portal request. Returns the request date the action had before formatting.

 

{originalMessage.dt_sent:formatLocaleDateTime(values)} - Only available for document reminders. Returns the sent date of the document the reminder is belonging to. 

 

{eta:formatLocaleDateTime(values, "h:mm A")} - Only usable for the Attending appointment notification. Displays the ETA in hour:minutes AM/PM format.

 

{dt_created:formatLocaleDateTime(values, "Do MMM Y")} - Usable for every type of notification. Displays the creation date of the action or document the notification is belonging to.

 

{dueDate:formatLocaleDateTime(values)} - Only available for document reminders. Returns the due date of the document the reminder is belonging to.

 

{total:formatMoney(values.currencyOptions)} - Only available for document reminders. Returns the formatted total of the document the reminder is belonging to. 

 

{amount:formatMoney(values.currencyOptions)} - Only available for documents (used by payments). Returns the total amount formatted by the currency options. Must be used as it is.

 

{eta:formatLocaleDateTime(values, "h:mm A")} - Only available for Attending appointment notification. Returns the eta to an appointment in hour:minute AM/PM format. 06:00 is returned as 06:00 AM.