Message
Message task allows us to send alerts, notifications, push notifications, emails and text messages to our clients informing them about the events in the building.
Table of content
Message Types
ComfortClick supports several message types for notifying users about events, alerts, and important system information in the building.
Alert
An Alert message is sent to all selected devices assigned to a specific user.
Alerts appear at the top of the client application and are used to notify users about potential issues or important building information.
If an alert is missed, it can be reviewed later by selecting the Log button in the top-right corner of the client application.
Push notifcation and email are sent automatically with alert as well.
Critical Alert
A Critical Alert is similar to a standard alert, but it requires user confirmation before it can be fully closed.
If the critical alert is closed without confirmation, it will appear again the next time the user logs in. This ensures that important messages are acknowledged by the user.
When closing a critical alert, the client can also add a comment, such as a reason, action taken, or additional information related to the event.
Critical push notifcation and email are sent automatically with alert as well.
Event
An Event message is displayed in the client application, similar to an alert.
Events are usually used for less critical information and are commonly reserved for building-related notifications such as:
Mode changes
Seasonal changes
Weather conditions
Sun position or shading events
Other general system events
An Email message sends the notification directly to the user’s email address instead of displaying it only in the client application.
To use email notifications, the email address must be configured in the user settings.
Emails can also be customized using HTML. With HTML, it is possible to create more visual and informative messages, including formatted text, images, graphs, and building-related information.
Check the HTML code and full example:
Email Consumption Report HTML Example
SMS
An SMS message sends the notification as a text message to the user’s phone number.
To use SMS notifications, make sure that:
A GSM modem is connected and working
The correct phone number is configured in the user settings
Push
A Push message sends a push notification to the user’s smart device.
Android and iOS devices can receive push notifications about building events, even when the client application is not open.
To receive push notifications, the smart device must be added under the user. This is done automatically when the user logs in with the ComfortClick client application from that device.
Critical Push
A Critical Push message sends a high-priority push notification to the user’s smart device.
Android and iOS devices can receive critical push notifications about important building events, even when the client application is not open.
To receive critical push notifications, the smart device must be added under the user. This is done automatically when the user logs in with the ComfortClick client application from that device. Critical push notification will be received by the client even if the device is under Do not Disturb mode.
Recipients
The Recipients settings define which users will receive the notification.
You can select individual users to send the notification only to specific people, or select Everyone to send the notification to all users and devices in the building.
This allows notifications to be targeted only to the relevant users, while still providing the option to broadcast important messages to all connected devices. Write to log function will save these alerts in the system log, if disabled, the logs will note be stored. By default, this settings is enabled.
Subject
The Subject defines the title of the alert.
The subject is displayed at the top of the alert message and can be customized with any text.
You can also use the bOS value placeholder %value to display a dynamic value inside the subject. This is useful when the alert should show a value that changes, instead of displaying only static text.
For example, the subject can include a temperature value, alarm state, sensor value, or any other value used in the notification.
Blocking
The Block Sending setting helps prevent users from receiving too many repeated messages in a short period of time. When Block Sending is enabled, the message is sent once and then blocked for the configured interval. During this time, the same message will not be sent again.
After the block interval expires, the message can be sent again if the triggering condition is still active or occurs again.
This is useful for preventing message spam caused by frequently repeated events, alarms, or automation triggers.
Media
Media Settings allow us to customize the visual and audio behavior of an alert.
You can use any image from the configuration as the alert image and assign a custom sound that will play when the alert is triggered.
Media settings also include Text-to-Speech (TTS) options. TTS can be used to read a custom notification message aloud when the alert is activated.
A delay can also be configured between the alert sound and the Text-to-Speech message. This helps prevent the sound and spoken message from overlapping.