diff --git a/atom.xml b/atom.xml index 387aa47c34..ee8faa81b5 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@
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.
-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