Message Templates

Message templates allow you to customize email and SMS notifications sent by Fentrica. Templates use the Handlebars templating engine with additional custom helpers for advanced logic.

Accessing Message Templates

Message templates have their own page, available to organization admins:

1. Open the account menu (your organization name, top-right)
2. Choose Message Templates
3. Click on a template to edit, or use New to create one

When creating a template you choose only a Name, Type, and Scope; the body is pre-filled with the platform default for that type and can then be edited.

Template Scope

Each template is scoped to either the whole organization or a single property:

• Organization-wide (default, propertyId is empty) — applies to every site in the organization.
• Property-specific — applies only to the selected property and overrides the organization-wide template of the same type for that site.

At send time the template is resolved with the following precedence:

1. Property-specific template for the message's property
2. Organization-wide template of that type
3. Built-in platform default

Editing in the template editor

The Body and HTML Body fields use a code editor with syntax highlighting for {{ }} expressions. Typing inside {{ }} offers autocomplete for the available variables (e.g. user.firstname, ticket.title) and helpers (if, each, compare, …). The HTML Body editor additionally highlights HTML markup.

Template Types

Fentrica supports the following message template types:

Access & Authentication

Task Notifications (to Service Providers)

Maintenance Request Notifications (to Reporters)

Automation

Template Fields

Each template has the following configurable fields:

Template Syntax

Templates use Handlebars syntax. Variables are inserted using double curly braces.

Basic Variable Insertion

Hello {{user.firstname}} {{user.lastname}}!

Your access PIN is: {{user.pin}}

Conditional Blocks

{{#if user.title}}
Dear {{user.title}} {{user.lastname}},
{{else}}
Dear {{user.firstname}},
{{/if}}

Iterating Over Arrays

{{#each tasks}}
- {{this.name}}: {{this.description}}
{{/each}}

Available Variables

Variables can be injected into templates using {{variable}} syntax. Available variables depend on the context of the message.

User Variables

Organization Variables

Access Group Variables

Property & Unit Variables

Alarm Variables

Maintenance Request, Task & Comment Variables

Custom Helpers

Fentrica extends Handlebars with additional helper functions for advanced template logic.

Comparison Helper

The compare helper allows comparing two values with various operators.

Syntax: {{#if (compare value1 "operator" value2)}}...{{/if}}

Supported operators: ==, ===, !=, !==, <, <=, >, >=

{{#if (compare alarm.priority ">" 3)}}
URGENT: This is a high priority alarm!
{{/if}}

{{#if (compare alarm.state "==" "active")}}
Alarm is currently active.
{{/if}}

Logical Operators

Or Helper

Returns true if ANY of the arguments are truthy.

{{#if (or user.email user.phone)}}
We can contact you via {{user.email}}{{user.phone}}
{{/if}}

And Helper

Returns true if ALL of the arguments are truthy.

{{#if (and user.firstname user.lastname)}}
Full name: {{user.firstname}} {{user.lastname}}
{{/if}}

Array Helpers

Index Helper

Get an element at a specific index from an array.

Syntax: {{index array position}}

First item: {{index items 0}}
Second item: {{index items 1}}

Last Helper

Get the last element from an array.

Syntax: {{last array}}

Most recent: {{last readings}}

String Helpers

Split Helper

Split a string by a delimiter, returning an array.

Syntax: {{split string "delimiter"}}

{{#each (split address ",")}}
{{this}}
{{/each}}

Trim Helper

Remove leading and trailing whitespace from a string.

Syntax: {{trim string}}

Name: {{trim user.firstname}}

Number Helpers

ToNumber Helper

Convert a value to a number.

Syntax: {{toNumber value}}

{{#if (compare (toNumber stringValue) ">" 100)}}
Value exceeds 100
{{/if}}

Between Helper

Check if a value falls between a minimum and maximum (inclusive).

Syntax: {{#if (between value min max)}}...{{/if}}

{{#if (between temperature 18 24)}}
Temperature is in comfortable range.
{{else}}
Temperature is outside comfortable range!
{{/if}}

Examples

Access PIN Email

Dear {{user.firstname}},

Welcome to {{org.name}}!

Your access credentials for {{accessGroup.name}}:
PIN Code: {{user.pin}}

Best regards,
{{org.name}}

Alarm Notification

{{#if deviceAlarmDefinition.name}}
Alarm: {{deviceAlarmDefinition.name}}
{{/if}}
{{#if analyticAlarmDefinition.name}}
Alarm: {{analyticAlarmDefinition.name}}
{{/if}}

Priority: {{alarm.priority}}
{{#if (compare alarm.priority ">=" 4)}}
⚠️ This is a HIGH PRIORITY alarm requiring immediate attention!
{{/if}}

Status: {{alarm.state}}
Triggered: {{alarm.activatedAt}}
{{#if alarm.resolvedAt}}
Resolved: {{alarm.resolvedAt}}
{{/if}}

Property: {{property.name}}

Task Assignment with Conditional Logic

Hello {{user.firstname}},

A new task has been assigned to you.

Task: {{task.name}}
{{#if task.description}}
Description: {{task.description}}
{{/if}}

{{#if (and task.dueDate (compare task.priority ">" 3))}}
⚠️ This is a high-priority task due on {{task.dueDate}}.
{{/if}}

Property: {{property.name}}
{{#if unit.name}}
Unit: {{unit.name}}
{{/if}}

Using String Manipulation

{{#with (split sensor.location "/")}}
Building: {{index this 0}}
Floor: {{index this 1}}
Room: {{last this}}
{{/with}}