HSBuddy lets you send notifications to your mobile devices as part of your HS3 automation events. You can send notifications to a specific mobile device or to all mobile devices registered with your HS3 server.
This feature requires installing the HSBuddy plugin on your HomeSeer server, as detailed in the Installing HSBuddy section.
The HSBuddy application running in your phone or tablet registers with your HS3 server after a connection is established. As part of this registration, the device name and its push notification identifier are saved in the HSBuddy Plugin configuration. On your HS3 server website, go to the PLUG-INS menu and select Clients under HSBuddy. That page will show you a list of registered mobile devices, indicating which ones are able to receive push notifications.
When configuring Events in your HS3 server, you can add a step to any event to send a notification by following these steps:
You can use replacement variables to insert special values as part of the text of the notification. The table below describes the replacement variables that are supported. The variable names are case sensitive.
|$time||Current time||$time||3:02:15 AM|
|$$DVA:addr:||Value of device at address addr||$DVA:R4:||15|
|$$DVC:code:||Value of device with code code||$DVC:ABC123:||15|
|$$DVR:ref:||Value of device with reference number ref||$DVR:58:||15|
|$$DSA:addr:||Status of device at address addr||$DVA:R4:||Dim 15%|
|$$DSC:code:||Status of device with code code||$DVC:ABC123:||Dim 15%|
|$$DSR:ref:||Status of device with reference number ref||$DVR:58:||Dim 15%|
|$$DTA:addr:||String of device at address addr||$DVA:R4:||Some text|
|$$DTC:code:||String of device with code code||$DVC:ABC123:||Some text|
|$$DTR:ref:||String of device with reference number ref||$DVR:58:||Some text|
|$$COUNTER:name:||Value of counter called name||$$COUNTER:MyCounter:||123|
|$$TIMER:name:||Value of timer called name||$$TIME:MyTimer:||01:30:00|
|$$VAR:name:||Value of global variable called name||$$VAR:MyVariable:||Any value|
You can send notifications to your HSBuddy clients via a script or using the JSON API. You can use the plug-in function called
SendNotification which takes the following parameters:
||ID of the destination client or null/empty to send it to all clients|
||Text of the notification. You can use replacement variables (see previous section)|
You can obtain the ID of your HSBuddy clients by going to the Clients page in HS3 (under PLUG-INS -> HSBuddy) and click on the following icon:
The following is an example JSON API call to send a notification.
1. Traffic blockers may need additional configuration
If you use a traffic blocker on your HS3 server, it may block requests initiated by the Plug-in to deliver push notifications to your mobile devices. If you are using a traffic blocker and the notifications aren’t working, make sure the following domain is added to the whitelist of allowed websites: https://onesignal.com