From 55f99eeaf5ac59e1178b2945fdc8f10ca2fe3e0b Mon Sep 17 00:00:00 2001 From: Gopal Kildoliya Date: Mon, 16 Jan 2017 13:01:23 +0530 Subject: [PATCH] Notify component for Facebook Messenger (#1683) * Create notify.facebook.markdown * Update notify.facebook.markdown * Update notify.facebook.markdown * Added Facebook logo --- source/_components/notify.facebook.markdown | 51 ++++++++++++++++++++ source/images/supported_brands/facebook.png | Bin 0 -> 12708 bytes 2 files changed, 51 insertions(+) create mode 100644 source/_components/notify.facebook.markdown create mode 100755 source/images/supported_brands/facebook.png diff --git a/source/_components/notify.facebook.markdown b/source/_components/notify.facebook.markdown new file mode 100644 index 00000000000..55f9adc4c78 --- /dev/null +++ b/source/_components/notify.facebook.markdown @@ -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 +``` diff --git a/source/images/supported_brands/facebook.png b/source/images/supported_brands/facebook.png new file mode 100755 index 0000000000000000000000000000000000000000..26333d70c5e7b7286d5eb8953dd3c999a4ddb5bf GIT binary patch literal 12708 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 U;pGm$9fQxsCg#SOI~{)gfAwJB-~a#s literal 0 HcmV?d00001