The console provides visualization features for device alerting. You can specify the alert name, content, trigger rule, alert level, and push scope. When a device meets the specified conditions, it triggers an alert and sends a notification to your app or management backend. Device alerting is an optional feature that you can configure as needed.
Log on to the IoT Platform console.
Go to the Human-Machine Interface page of the product.
Choose .
Select an interaction terminal and click New Alert or Edit.
Select Tmall Genie. Click the status switch for an alert item or click the Edit button.
NoteBefore you can edit device alert information for Tmall Genie, you must first configure the device alert information for this product category.
In the Edit dialog box that appears, modify the alert parameters and click Confirm.
The alert parameters that you can modify vary based on the alert rule. Follow the instructions on the interface. If all alert parameters on the interface are grayed out, the parameters for this alert cannot be modified. In this case, click Confirm to enable the alert.
Select Cloud Intelligence & Proprietary App and click New Alert.
(Optional) If you select Cloud Intelligence & Proprietary App, configure the detailed alert parameters in Chinese and click OK.
Parameter Name
Description
Alert name
The name of the alert.
Alert content
The alert content is pushed as a combination of text and parameter variables. Do not enter special characters such as "#", "$", "(", or ")" in the text. In parameter variables, n is an integer, and identifier must be an attribute identifier defined in the product features. Only the
${var}and${value.var}formats are supported. The naming convention for var allows only numbers, letters, and underscores.NoteThe identifier is supported only for alert rules of the Property type. It is not supported for alert rules of the Device Status or Event types.
After you configure the identifier parameter, the device must also report the corresponding property. Otherwise, the property value is not displayed in the alert content even if the identifier is configured.
Alerts also support the following macros.
#STRING_HEAD($identifier, n)Outputs the first n characters of $identifier.
#STRING_TAIL($identifier, n)Outputs the last n characters of $identifier.
#TSL_REPLACE($identifier1, $identifier2)Searches for the relevant property and event definitions in the device's Thing Specification Language (TSL) model based on the value of identifier1. If the property is of the ENUM or BOOL type, the content of the definition is output. To specify an event, set identifier2 to the event method name.
For example, in
#TSL_REPLACE($value.LockType, $value.DoorOpenNotification), LockType is the property name in the TSL model or the property value in a TSL event. The corresponding value is obtained based on the configured parameter. DoorOpenNotification is the method name of the specified event.#LOCK_USERNAME($identifier, $identifier, text)A macro for smart locks that replaces the lock user's nickname.
For example, in
#LOCK_USERNAME($value.KeyID, $value.LockType, 'User'), value is a static field. KeyID and LockType are the values of the TSL device properties that are called. If no value is returned from the call, the default value 'User' is returned.#DEVICE_NICKNAME()The device's nickName. If nickName is empty, the value of ProductName is used.
#TIME_UTIL($alarmStartTime,'yyyy-MM-dd HH:mm:ss')The time when the alert message is triggered. yyyy-MM-dd HH:mm:ss is a customizable date format. The platform backend validates the format.
Alert rule
Supports simple rules for properties and events, and event triggers for when a device goes online or offline.
Event
Property
Device Status
Alert level
Reminder notification
Minor issue
Critical alert
Redirect URL
The URL to which users are redirected from the alert notification in the app. You can develop and set a custom redirect URL. This lets users click the alert notification and be taken to the alert details page.
NoteCurrently, only proprietary apps support custom redirect URLs for alert notifications. Cloud Intelligence apps do not support this feature.
Receiving extended fields for Android offline pushes requires an app SDK upgrade.
For more information about proprietary app development and SDK upgrades, see Configure custom redirects for message alerts.
Permission scope
Notify users:
Message Hub (Pushed to the Message Hub. Can be received in the app through queries.)
App push (Pushed only to the phone's notification bar. Cannot be queried in the app.)
Strong reminder (After the phone receives the notification, it gives a strong vibration and sound reminder. This is used for more critical alerts. Users can enable or disable this feature.)
This option appears when Alert level is set to Critical alert. If you check Strong reminder and the end user (consumer) enables the strong reminder switch, the app receives a strong reminder with a pop-up, alert tone, and phone vibration when a critical message is pushed.
NoteCurrently, only the Cloud Intelligence app for Android supports the strong reminder feature. Proprietary apps do not support this feature.
NoteIf you are using a Link Visual product, you must also configure video alert rules in addition to the device alert rules described above. For more information, see Develop Link Visual products.
(Optional) Select another language tab and configure the settings for that language. The configuration method is the same as that for Chinese.
The IoT Platform currently supports 24 languages, including Chinese (zh-CN), English (en-US), French (fr-FR), German (de-DE), Japanese (ja-JP), Korean (ko-KR), Spanish (es-ES), Russian (ru-RU), Italian (it-IT), Hindi (hi-IN), Portuguese (pt-PT), Polish (pl-PL), Dutch (nl-NL), Danish (da-dk), Czech (cs-CZ), Slovak (sk-SK), Swedish (sv-SE), Traditional Chinese (zh-Hant), Turkish (tr-TR), Hungarian (hu-HU), Vietnamese (vi-VN), Indonesian (in-ID), Arabic (ar-SA), and Thai (th-TH).
NoteIf your device will be sold internationally, you must configure settings for multiple languages, such as English. Otherwise, Chinese text or incorrect information may be displayed when the app language is switched.
The IoT Platform provides default multilingual configurations for some product categories, such as lights, sockets, and switches, for private brand projects. You can use these configurations directly.
To configure multiple languages for a proprietary app, see the developer document Customize multiple languages for a proprietary app.