Home Assistant
This custom component sends events from Home Assistant straight to Notifery. Hook it up to sensors, automations, or scripts and get notified when things happen around your house.
What you need
Section titled “What you need”- A Notifery account with a zone and API key (see Getting Started)
- Access to your Home Assistant filesystem
Installation
Section titled “Installation”There’s no HACS support yet, so you install it manually:
- Download or clone the home-assistant-integration repo
- Copy the
home-assistant-integrationfolder into your Home Assistantcustom_componentsdirectory - Rename that folder to
notifery - Restart Home Assistant
It should look like this when you’re done:
custom_components/└── notifery/ ├── __init__.py ├── config_flow.py ├── const.py ├── manifest.json └── services.yamlConfiguration
Section titled “Configuration”Once Home Assistant is back up:
- Go to Settings > Devices & Services
- Click + ADD INTEGRATION
- Search for Notifery and select it
- Paste in your zone API key
- Click Submit
Service reference
Section titled “Service reference”The integration adds one service: notifery.send_event.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | The notification title |
message | string | No | The notification message body |
group | string | No | Group alias (created in zone settings) to organize notifications |
code | number | No | Status code (0 for success, positive number for errors) |
Automation examples
Section titled “Automation examples”Here are a few automations that actually make sense in a real home.
Door or window opened
Section titled “Door or window opened”automation: - alias: "Notify when front door opens" trigger: - platform: state entity_id: binary_sensor.front_door to: "on" action: - service: notifery.send_event data: group: security title: "Door Alert" message: "Front door was opened at {{ now().strftime('%H:%M:%S') }}" code: 0Motion detected
Section titled “Motion detected”automation: - alias: "Motion in backyard" trigger: - platform: state entity_id: binary_sensor.backyard_motion to: "on" action: - service: notifery.send_event data: group: security title: "Motion Detected" message: "Backyard motion sensor triggered at {{ now().strftime('%H:%M') }}" code: 0Low battery warning
Section titled “Low battery warning”automation: - alias: "Low battery notification" trigger: - platform: numeric_state entity_id: - sensor.living_room_motion_battery - sensor.front_door_battery - sensor.garage_sensor_battery below: 20 action: - service: notifery.send_event data: group: maintenance title: "Low Battery" message: "{{ trigger.to_state.name }} is at {{ trigger.to_state.state }}%" code: 1Washing machine finished
Section titled “Washing machine finished”automation: - alias: "Washing machine finished" trigger: - platform: state entity_id: sensor.washing_machine_status from: "Running" to: "Idle" for: minutes: 2 action: - service: notifery.send_event data: group: household title: "Laundry Done" message: "The washing machine has finished its cycle" code: 0Freezer temperature warning
Section titled “Freezer temperature warning”automation: - alias: "Freezer temperature warning" trigger: - platform: numeric_state entity_id: sensor.freezer_temperature above: -10 action: - service: notifery.send_event data: group: climate title: "Freezer Warning" message: "Freezer temperature is {{ trigger.to_state.state }}°C, check the door" code: 1Automation reload
Section titled “Automation reload”automation: - alias: "Notify on automation reload" trigger: - platform: event event_type: automation_reloaded condition: - condition: template value_template: "{{ trigger.event.data.service == 'automation.turn_on' }}" action: - service: notifery.send_event data: group: system title: "Automation Reloaded" message: "An automation was reloaded at {{ now().strftime('%H:%M:%S') }}" code: 0Troubleshooting
Section titled “Troubleshooting”Not getting notifications? Check these in order:
- Is your API key correct? Copy it fresh from your zone settings.
- Do your group aliases match exactly what’s in Notifery? They are case-sensitive.
- Can your Home Assistant instance reach
https://api.notifery.com? - Check the Home Assistant logs for errors from the
notiferycustom component. - Make sure the integration actually loaded by looking for it under Settings > Devices & Services.
Source
Section titled “Source”The integration is open source: github.com/notifery/home-assistant-integration. Pull requests and bug reports are welcome.