mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-12 11:56:50 +00:00
Notify component for Facebook Messenger (#1683)
* Create notify.facebook.markdown * Update notify.facebook.markdown * Update notify.facebook.markdown * Added Facebook logo
This commit is contained in:
parent
492f9753a6
commit
55f99eeaf5
51
source/_components/notify.facebook.markdown
Normal file
51
source/_components/notify.facebook.markdown
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
---
|
||||||
|
layout: page
|
||||||
|
title: "Facebook Messenger"
|
||||||
|
description: "Instructions how to add user notifications to Home Assistant."
|
||||||
|
date: 2016-12-31 14:14
|
||||||
|
sidebar: true
|
||||||
|
comments: false
|
||||||
|
sharing: true
|
||||||
|
footer: true
|
||||||
|
logo: facebook.png
|
||||||
|
ha_category: Notifications
|
||||||
|
ha_release: "0.35"
|
||||||
|
---
|
||||||
|
|
||||||
|
The `facebook` notification platform enables sending notifications via Facebook Messenger, powered by [Facebook](https://facebook.com).
|
||||||
|
|
||||||
|
To use this notification platform in your installation, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
notify:
|
||||||
|
- name: NOTIFIER_NAME
|
||||||
|
platform: facebook
|
||||||
|
page_access_token: FACEBOOK_PAGE_ACCESS_TOKEN
|
||||||
|
```
|
||||||
|
|
||||||
|
Configuration variables:
|
||||||
|
|
||||||
|
- **page_access_token** (*Required*): Access token for your facebook page. Checkout [Facebook Messenger Platform](https://developers.facebook.com/docs/messenger-platform/guides/setup) for more information.
|
||||||
|
- **name** (*Optional*): 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`.
|
||||||
|
|
||||||
|
### Usage
|
||||||
|
|
||||||
|
With Facebook notify service, you can send your notifications to your facebook messenger with help of your facebook page. You have to create a [Facebook Page and App](https://developers.facebook.com/docs/messenger-platform/guides/quick-start) for this service. You can control it by calling the notify service [as described here](/components/notify/). It will send a message on messenger to user specified by **target** on behalf of your page. See the [quick start](https://developers.facebook.com/docs/messenger-platform/guides/quick-start) guide for more information.
|
||||||
|
The phone number used in **target** should be registered with facebook messenger. Phone number of the recipient should be in +1(212)555-2368 format. If your app is not approved by facebook then the recipient should by either admin, developer or tester for your facebook app. [More...](https://developers.facebook.com/docs/messenger-platform/send-api-reference#phone_number)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example automation notification entry
|
||||||
|
automation:
|
||||||
|
- alias: Evening Greeting
|
||||||
|
trigger:
|
||||||
|
platform: sun
|
||||||
|
event: sunset
|
||||||
|
action:
|
||||||
|
service: notify.facebook
|
||||||
|
data:
|
||||||
|
message: 'Good Evening'
|
||||||
|
target:
|
||||||
|
- +919413017584
|
||||||
|
- +919784516314
|
||||||
|
```
|
BIN
source/images/supported_brands/facebook.png
Executable file
BIN
source/images/supported_brands/facebook.png
Executable file
Binary file not shown.
After Width: | Height: | Size: 12 KiB |
Loading…
x
Reference in New Issue
Block a user