diff --git a/source/_integrations/slack.markdown b/source/_integrations/slack.markdown index a2a494dbf75..54a9b749d47 100644 --- a/source/_integrations/slack.markdown +++ b/source/_integrations/slack.markdown @@ -4,10 +4,12 @@ description: Instructions on how to add Slack notifications to Home Assistant. ha_category: - Notifications ha_release: pre 0.7 +ha_config_flow: true ha_domain: slack ha_iot_class: Cloud Push ha_codeowners: - '@bachya' + - '@tkdrob' ha_platforms: - notify ha_integration_type: integration @@ -23,7 +25,7 @@ The `slack` platform allows you to deliver notifications from Home Assistant to 2. Click the `OAuth & Permissions` link in the sidebar, under the Features heading. 3. In the Scopes section, add the `chat:write` scope, `Send messages as user`. If you get a `missing_scope` error when trying to send a message, check these permissions. 4. Scroll up to `OAuth Tokens & Redirect URLs` and click `Add to Workspace`. -5. Copy your `OAuth Access Token` and put that key into your `configuration.yaml` file -- see below. +5. Copy your `OAuth Access Token` and put that key into the config flow.
@@ -37,50 +39,20 @@ It is also possible to use Slack bots as users. Just create a new bot at https:/ Don't forget to invite the bot to the room where you want to get the notifications. -## Configuration +### Icons -To enable the Slack notification in your installation, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -notify: - - name: NOTIFIER_NAME - platform: slack - api_key: YOUR_API_KEY - default_channel: "#general" -``` - -{% configuration %} -name: - description: Setting this parameter allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`. - required: false - type: string - default: "notify" -api_key: - description: The Slack API token to use for sending Slack messages. - required: true - type: string -default_channel: - description: The default channel to post to if no channel is explicitly specified when sending the notification message. A channel can be specified adding a target attribute to the JSON at the same level as "message". - required: true - type: string -username: - description: Home Assistant will post to Slack using the username specified. - required: false - type: string - default: The user account or botname that you generated the API key as. -icon: - description: Use one of the Slack emojis as an Icon for the supplied username. Slack uses the standard emoji sets used [here](https://www.webpagefx.com/tools/emoji-cheat-sheet/). Alternatively a publicly accessible URL may be used. - required: false - type: string -{% endconfiguration %} +Slack uses the standard emoji sets used [here](https://www.webpagefx.com/tools/emoji-cheat-sheet/). Alternatively a publicly accessible URL may be used.
-Note that in order to modify your Slack bot's username and icon, you must ensure your Slack app has the `chat:write.customize` OAuth scope. See [the Slack API documentation](https://api.slack.com/methods/chat.postMessage#authorship) for more information. +In order to modify your Slack bot's username and icon, you must ensure your Slack app has the `chat:write.customize` OAuth scope. See [the Slack API documentation](https://api.slack.com/methods/chat.postMessage#authorship) for more information. + +The added `notify` service will be named after the chat server the app is installed on. For example, a server named "Slack Chat" wil display as `notify.slack_chat`.
+{% include integrations/config_flow.md %} + ### Slack Service Data The following attributes can be placed inside the `data` key of the service call for extended functionality: