diff --git a/atom.xml b/atom.xml index 387aa47c34..ee8faa81b5 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index 8f8b14e2db..fb181c2eba 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 77ef32e713..fac2b8ad4c 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 0e208b4542..8295273719 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 27055f6ee6..f7c1cf0011 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index d42d544b46..e89e8ec411 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 39a01ba641..1a28b16b6e 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 22cc606423..5f8c681b55 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 9c39342e28..235149d366 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index b1954eb302..141cf3041b 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index c3bc75716e..193b7a6abc 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 7ed1d4a0f9..a16e0b0179 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index c660d2c817..59d894fc38 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index ebf595c469..e7392451d0 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 2607f6cc02..50cab84aa5 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 45909b749d..ec0e0269ce 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 1ee83a4920..e3259db558 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 8f2c39ab73..036c44f4ef 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index c8b5a9395b..061ef69135 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 1a5b3e8786..3df3fe98fd 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index daf7e732fb..b906f07758 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index d60b75ae7a..d72b9b6e2b 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index cdce32ed16..46b00c71f3 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 9debf00be3..81dd73a1b7 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-07-02T20:50:21+00:00 + 2017-07-03T06:07:09+00:00 https://home-assistant.io/ diff --git a/components/index.html b/components/index.html index 1a781b546b..f411eeff04 100644 --- a/components/index.html +++ b/components/index.html @@ -266,7 +266,7 @@ var allComponents = [ {url:"/components/binary_sensor.digital_ocean/", title:"Digital Ocean Binary Sensor", cat:"system-monitor", featured: false, v: "0.30", logo: "digital_ocean.png"}, {url:"/components/switch.digital_ocean/", title:"Digital Ocean Switch", cat:"switch", featured: false, v: "0.30", logo: "digital_ocean.png"}, {url:"/components/media_player.directv/", title:"DirecTV", cat:"media-player", featured: false, v: "0.25", logo: "directv.png"}, -{url:"/components/notify.discord/", title:"Discord", cat:"notifications", featured: false, v: "0.0", logo: "discord.png"}, +{url:"/components/notify.discord/", title:"Discord", cat:"notifications", featured: false, v: "0.37", logo: "discord.png"}, {url:"/components/discovery/", title:"Discovery", cat:"other", featured: false, v: "0.0", logo: "home-assistant.png"}, {url:"/components/camera.dispatcher/", title:"Dispatcher IP Camera", cat:"camera", featured: false, v: "0.4", logo: "camcorder.png"}, {url:"/components/image_processing.dlib_face_detect/", title:"Dlib Face Detect", cat:"image-processing", featured: false, v: "0.44", logo: "dlib.png"}, diff --git a/components/notify.discord/index.html b/components/notify.discord/index.html index ac28ac3ff3..8ebff83956 100644 --- a/components/notify.discord/index.html +++ b/components/notify.discord/index.html @@ -75,9 +75,8 @@

The Discord service is a platform for the notify component. This allows components to send messages to the user using Discord.

-

In order to get a token you need to go to the Discord My Apps page and create a new application. Once the application is ready, create a bot user. Retreive the client ID and the (hidden) token of your bot for later.

+

In order to get a token you need to go to the Discord My Apps page and create a new application. Once the application is ready, create a bot user (Create a Bot User) and activate Require OAuth2 Code Grant. Retreive the Client ID and the (hidden) Token of your bot for later.

When setting up the application you can use this icon.

-

Configuration

To use Discord notifications, add the following to your configuration.yaml file:

# Example configuration.yaml entry
 notify:
@@ -91,15 +90,22 @@
   
  • 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.
  • token (Required): Your bot’s token.
  • -

    Using the bot

    -

    Bots can only send messages to servers. To add the bot to a server you are an admin on, use the Discord OAuth2 Authorization page:

    -

    https://discordapp.com/api/oauth2/authorize?client_id=1234567890&scope=bot&permissions=0

    -

    Replace the client ID with the appropriate one from the Discord My Apps page.

    -

    Once the bot user has been added to your server, get the channel ID of the channel you want the bot to operate in.

    -
      -
    • In The Discord app go to Settings > Appearance > Check developer mode
    • -
    • Right click channel name > Copy ID
    • -
    +

    Setting up the bot

    +

    Bots can only send messages to servers. To add the bot to a server you are an admin on, get the details of the bot from the Discord My Apps page.

    +

    + +

    +

    Now use the Discord Authorization page with the Client ID of your bot.

    +

    https://discordapp.com/api/oauth2/authorize?client_id=[CLIENT_ID]&scope=bot&permissions=0

    +

    + +

    +

    Wait for the confirmation which should say “Authorized”.

    +

    Once the bot has been added to your server, get the channel ID of the channel you want the bot to operate in. In The Discord application go to Settings > Appearance > Check developer mode.

    +

    + +

    +

    Right click channel name and copy the channel ID (Copy ID).

    This channel ID has to be used as the target when calling the notification service. Multiple channel IDs can be specified, across multiple servers.

    Example service payload

    {
    @@ -123,6 +129,9 @@
       
    +
    + Introduced in release: 0.37 +
    This is a platform for the Notifications component. diff --git a/images/screenshots/discord-api.png b/images/screenshots/discord-api.png new file mode 100644 index 0000000000..6ba7302799 Binary files /dev/null and b/images/screenshots/discord-api.png differ diff --git a/images/screenshots/discord-auth.png b/images/screenshots/discord-auth.png new file mode 100644 index 0000000000..a34c06dc62 Binary files /dev/null and b/images/screenshots/discord-auth.png differ diff --git a/images/screenshots/discord-bot.png b/images/screenshots/discord-bot.png new file mode 100644 index 0000000000..11da0c9764 Binary files /dev/null and b/images/screenshots/discord-bot.png differ diff --git a/sitemap.xml b/sitemap.xml index e77e1a74c3..71fecb3a94 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -3674,62 +3674,62 @@ https://home-assistant.io/demo/frontend.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/index.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2017-07-02T20:48:44+00:00 +2017-07-03T06:05:29+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2017-07-02T20:48:45+00:00 +2017-07-03T06:05:30+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2017-07-02T20:48:45+00:00 +2017-07-03T06:05:30+00:00 https://home-assistant.io/static/mdi-demo.html -2017-07-02T20:48:45+00:00 +2017-07-03T06:05:30+00:00