mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-12 20:06:52 +00:00
Updated notifier documentation.
1) Added missing notifiers to general notifier page and rearranged notifiers to be in alphabetical order. 2) Added documentation about new name property for notifiers and how it works into the service call.
This commit is contained in:
parent
c0d6ab9105
commit
0b4c6b188b
@ -25,7 +25,7 @@ automation:
|
|||||||
state_to: 'below_horizon'
|
state_to: 'below_horizon'
|
||||||
|
|
||||||
# Action to be done when trigger activated
|
# Action to be done when trigger activated
|
||||||
execute_service: notify.notify
|
execute_service: notify.NOTIFIER_NAME
|
||||||
service_data: {"message":"The sun has set"}
|
service_data: {"message":"The sun has set"}
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -105,7 +105,7 @@ Currently the only supported action is calling a service. Services are what devi
|
|||||||
service_data: {"rgb_color": [255, 0, 0]}
|
service_data: {"rgb_color": [255, 0, 0]}
|
||||||
|
|
||||||
# Notify the user
|
# Notify the user
|
||||||
execute_service: notify.notify
|
execute_service: notify.NOTIFIER_NAME
|
||||||
service_data: {"message":"YAY"}
|
service_data: {"message":"YAY"}
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -121,7 +121,7 @@ automation:
|
|||||||
state_from: 'above_horizon'
|
state_from: 'above_horizon'
|
||||||
state_to: 'below_horizon'
|
state_to: 'below_horizon'
|
||||||
|
|
||||||
execute_service: notify.notify
|
execute_service: notify.NOTIFIER_NAME
|
||||||
service_data: {"message":"The sun has set"}
|
service_data: {"message":"The sun has set"}
|
||||||
|
|
||||||
automation 2:
|
automation 2:
|
||||||
|
@ -17,11 +17,16 @@ To enable file notifications in your installation, add the following to your `co
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: file
|
platform: file
|
||||||
filename: FILENAME
|
filename: FILENAME
|
||||||
timestamp: 1 or 0
|
timestamp: 1 or 0
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
Setting `timestamp` to 1 adds a timestamp to every entry.
|
Setting `timestamp` to 1 adds a timestamp to every entry.
|
||||||
|
|
||||||
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
||||||
|
@ -17,6 +17,7 @@ The Instapush [Getting Started page](https://instapush.im/home/start/) will guid
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: instapush
|
platform: instapush
|
||||||
# Get those by creating a new application, event, and tracker on https://instapush.im
|
# Get those by creating a new application, event, and tracker on https://instapush.im
|
||||||
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
@ -25,6 +26,10 @@ notify:
|
|||||||
tracker: ABCDEFGHJKLMNOPQRSTUVXYZ
|
tracker: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
To retrieve those values for existing settings, log into your account at https://instapush.im and go to your **Dashboard**. Then click **APPS** tab, choose an app, and check the **Basic Info** section. The *Application ID* is the ``api_key`` and ``app_secret`` is the *Application Secret*.
|
To retrieve those values for existing settings, log into your account at https://instapush.im and go to your **Dashboard**. Then click **APPS** tab, choose an app, and check the **Basic Info** section. The *Application ID* is the ``api_key`` and ``app_secret`` is the *Application Secret*.
|
||||||
|
|
||||||
It's easy to test your Instapush setup outside of Home Assistant. Assuming you have an event *notification* and a tracker *home-assistant*, just fire a request and check the Instapush dashboard for a new entry.
|
It's easy to test your Instapush setup outside of Home Assistant. Assuming you have an event *notification* and a tracker *home-assistant*, just fire a request and check the Instapush dashboard for a new entry.
|
||||||
|
@ -13,13 +13,15 @@ One of the things most people want at some point in their home automation is to
|
|||||||
|
|
||||||
Home Assistant currently supports a wide range of services for notifications:
|
Home Assistant currently supports a wide range of services for notifications:
|
||||||
|
|
||||||
|
- [E-Mail](/components/notify.smtp.html)
|
||||||
|
- [File](/components/notify.file.html)
|
||||||
- [Instapush](/components/notify.instapush.html)
|
- [Instapush](/components/notify.instapush.html)
|
||||||
|
- [Jabber (XMPP)](/components/notify.xmpp.html)
|
||||||
- [Notify My Android (NMA)](/components/notify.nma.html)
|
- [Notify My Android (NMA)](/components/notify.nma.html)
|
||||||
- [PushBullet](/components/notify.pushbullet.html)
|
- [PushBullet](/components/notify.pushbullet.html)
|
||||||
- [PushOver](/components/notify.pushover.html)
|
- [PushOver](/components/notify.pushover.html)
|
||||||
- [E-Mail](/components/notify.smtp.html)
|
- [Slack](/components/notify.slack.html)
|
||||||
- [Syslog](/components/notify.syslog.html)
|
- [Syslog](/components/notify.syslog.html)
|
||||||
- [Jabber (XMPP)](/components/notify.xmpp.html)
|
|
||||||
|
|
||||||
### Automation example
|
### Automation example
|
||||||
|
|
||||||
@ -34,7 +36,7 @@ automation:
|
|||||||
state_from: above_horizon
|
state_from: above_horizon
|
||||||
state_to: below_horizon
|
state_to: below_horizon
|
||||||
|
|
||||||
execute_service: notify.notify
|
execute_service: notify.NOTIFIER_NAME
|
||||||
service_data: {"message":"YAY"}
|
service_data: {"message":"YAY"}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -17,9 +17,14 @@ To add NMA to your installation, add the following to your `configuration.yaml`
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: nma
|
platform: nma
|
||||||
# Get this by registering a new application on http://www.notifymyandroid.com/
|
# Get this by registering a new application on http://www.notifymyandroid.com/
|
||||||
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
||||||
|
@ -14,10 +14,15 @@ Home Assistant currently supports the awesome [PushBullet](https://www.pushbulle
|
|||||||
|
|
||||||
To add PushBullet to your installation, add the following to your `configuration.yaml` file:
|
To add PushBullet to your installation, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
```
|
```yaml
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: pushbullet
|
platform: pushbullet
|
||||||
api_key: YOUR_API_KEY
|
api_key: YOUR_API_KEY
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
For more automation examples, see the [getting started with automation page]({{site_root}}/components/automation.html).
|
For more automation examples, see the [getting started with automation page]({{site_root}}/components/automation.html).
|
||||||
|
@ -17,6 +17,7 @@ To use PushOver notifications, add the following to your `configuration.yaml` fi
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: pushover
|
platform: pushover
|
||||||
# Get this by registering a new application on https://pushover.net
|
# Get this by registering a new application on https://pushover.net
|
||||||
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
@ -24,6 +25,9 @@ notify:
|
|||||||
user_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
user_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
### Automation example
|
### Automation example
|
||||||
|
|
||||||
@ -38,7 +42,7 @@ automation:
|
|||||||
state_from: above_horizon
|
state_from: above_horizon
|
||||||
state_to: below_horizon
|
state_to: below_horizon
|
||||||
|
|
||||||
execute_service: notify.notify
|
execute_service: notify.NOTIFIER_NAME
|
||||||
service_data: {"message":"YAY"}
|
service_data: {"message":"YAY"}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -19,8 +19,12 @@ To enable the slack notification in your installation, add the following to your
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: slack
|
platform: slack
|
||||||
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
|
||||||
default_channel: '#general'
|
default_channel: '#general'
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
@ -17,6 +17,7 @@ To enable notification by e-mail in your installation, add the following to your
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: mail
|
platform: mail
|
||||||
server: MAIL_SERVER
|
server: MAIL_SERVER
|
||||||
port: YOUR_SMTP_PORT
|
port: YOUR_SMTP_PORT
|
||||||
@ -27,6 +28,10 @@ notify:
|
|||||||
recipient: YOUR_RECIPIENT
|
recipient: YOUR_RECIPIENT
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
This platform is fragile and not able to catch all exceptions in a smart way because of the large number of possible configuration combinations.
|
This platform is fragile and not able to catch all exceptions in a smart way because of the large number of possible configuration combinations.
|
||||||
|
|
||||||
A combination that will work properly is port 587 and STARTTLS. It's recommanded to enable STARTTLS, if possible.
|
A combination that will work properly is port 587 and STARTTLS. It's recommanded to enable STARTTLS, if possible.
|
||||||
|
@ -17,12 +17,17 @@ To enable syslog notifications in your installation, add the following to your `
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: syslog
|
platform: syslog
|
||||||
facility: SYSLOG_FACILITY
|
facility: SYSLOG_FACILITY
|
||||||
option: SYSLOG_LOG_OPTION
|
option: SYSLOG_LOG_OPTION
|
||||||
priority: SYSLOG_PRIORITY
|
priority: SYSLOG_PRIORITY
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
The table contains values to use in your `configuration.yaml` file.
|
The table contains values to use in your `configuration.yaml` file.
|
||||||
|
|
||||||
| facility | option | priority |
|
| facility | option | priority |
|
||||||
|
@ -15,12 +15,17 @@ The xmpp platform allows you to deliver notifications from Home Assistant to a [
|
|||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
notify:
|
notify:
|
||||||
|
name: NOTIFIER_NAME
|
||||||
platform: xmpp
|
platform: xmpp
|
||||||
sender: YOUR_JID
|
sender: YOUR_JID
|
||||||
password: YOUR_JABBER_ACCOUNT_PASSWORD
|
password: YOUR_JABBER_ACCOUNT_PASSWORD
|
||||||
recipient: YOUR_RECIPIENT
|
recipient: YOUR_RECIPIENT
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Setting the optional parameter `name` allows multiple notifiers to be created.
|
||||||
|
The default value is `notify`. The notifier will bind to the service
|
||||||
|
`notify.NOTIFIER_NAME`.
|
||||||
|
|
||||||
All Jabber IDs (JID) must include the domain. Make sure that the password matches the account provided as sender.
|
All Jabber IDs (JID) must include the domain. Make sure that the password matches the account provided as sender.
|
||||||
|
|
||||||
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).
|
||||||
|
Loading…
x
Reference in New Issue
Block a user