Notify.Events
Description
The Notify.Events service
This platform allows you to quickly configure the distribution of messages between different recipients, no matter how they are used to receiving notifications:
- Telegram
- Viber
- Slack
- Rocket.Chat
- Discord
- Jabber / XMPP
- Webpush
- SMS
- VoiceCall
You can find a full supported messenger list here
Setting up
To start getting notifications, you need to follow those simple steps:
- Sign up to Notify.Events
and create a Channel - Add Home Assistant source to this channel and get your token
- Add the Notify.Events integration to your installation by adding the following to your
configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file:
notify_events:
token: YOUR_TOKEN
Now you can use notify_events integration as a platform for your notify service, add the following to your configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file.
After changing the configuration.yaml
The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.
:
# Example configuration.yaml entry
notify:
- name: NOTIFIER_NAME (e.g. "events")
platform: notify_events
That’s it!
Now you can use the notify.events
action inside your Home Assistant to:
- Send any notifications or alerts
- Distribute events by
level
andpriority
- Attach files and images (local or remote)
- .. and just keep using your favorite messenger to receive them!
Example action
- action: notify.events
data:
message: "Backyard motion detected!"
data:
level: "warning"
priority: "high"
images:
- name: "local_photo.jpg"
path: "/tmp/backyard_cam/motion.jpg"
- name: "remote_photo.jpg"
url: "https://i.ibb.co/Jt1845X/motion.jpg"
Message optional parameters
The following attributes can be placed inside data
for extended functionality.
Attribute | Description |
---|---|
title |
Message title. |
level |
For recipients who have differences in the display of messages at different levels, this level will be applied. Available values: verbose , info , notice , warning , error , success . |
priority |
For recipients which supports priority, the message will be highlighted accordingly. Available values: lowest , low , normal , high , highest . |
images |
Array of images to attach (see item properties below). |
files |
Array of files to attach (see item properties below). |
token |
Notify.Events channel token (in case you want to override the channel to get this message to). |
Every item of images and files has the following properties:
Property | Required | Description |
---|---|---|
path or url or content
|
True | File source. |
name |
False | Result file name |
mime_type |
False | File MIME-type |
To use notifications effectively, please see the getting started with automation page.