home-assistant.github.io/source/components/notify.pushover.markdown
2015-06-02 09:55:31 +02:00

47 lines
1.4 KiB
Markdown

---
layout: page
title: "Notifications"
description: "Instructions how to add user notifications to Home Assistant."
date: 2015-01-20 22:36
sidebar: false
comments: false
sharing: true
footer: true
---
<img src='/images/supported_brands/pushover.png' class='brand pull-right' />
The [PushOver service](https://pushover.net/) is a platform for the notify component. This allows components to send messages to the user using PushOver.
To use PushOver notifications, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
notify:
platform: pushover
# Get this by registering a new application on https://pushover.net
api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
# Get this by logging into your account on https://pushover.net
user_key: ABCDEFGHJKLMNOPQRSTUVXYZ
```
### Automation example
Notifications are great to be used within Home Automation. Below is a an example configuration that you can add to your `configuration.yaml` to be notified when the sun sets.
```
automation:
alias: Sun set notification
platform: state
state_entity_id: sun.sun
state_from: above_horizon
state_to: below_horizon
execute_service: notify.notify
service_data: {"message":"YAY"}
```
For more automation examples, see the [getting started with automation page]({{site_root}}/components/automation.html).
[James Cole](https://github.com/jamespcole) has contributed the PushOver platform.