Add documentation on using Simplisafe secret alerts in triggers (#35640)

* Add documentation on using Simplisafe secret alerts in automation triggers

* CodeRabbit suggested changes

* Add suggested tweaks

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* More suggested tweaks

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Even more suggested tweaks

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Yet more suggested tweaks

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
rlippmann 2024-11-09 06:47:27 -05:00 committed by GitHub
parent 71e1e66221
commit 2da5620dd5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -153,6 +153,30 @@ triggers:
last_event_type: doorbell_detected
```
### Using secret alerts for sensor changes
For cases where the default {% term polling %} interval of 30 seconds is too long for automations, you can use secret alerts to get push notifications of a sensor being triggered.
To enable secret alerts for sensor changes, follow these steps:
1. Enable the secret alert for the device in the Simplisafe App.
2. Make a note of the serial number of the device.
- You can see it in the top-left corner of the page where you set the alert.
3. Use the following event trigger:
```yaml
triggers:
- trigger: event
event_type: SIMPLISAFE_EVENT
event_data:
last_event_type: secret_alert_triggered
last_event_sensor_serial: "abc123xyz" # Replace with your device's serial number (use lowercase letters)
```
{% note %}
Due to the way Simplisafe implements secret alerts, you can only determine when a sensor is triggered, not when it is cleared.
{% endnote %}
### `SIMPLISAFE_NOTIFICATION`
`SIMPLISAFE_NOTIFICATION` events represent system notifications that would appear in the