Add description of configuration variables

This commit is contained in:
Fabian Affolter 2017-08-21 15:28:55 +02:00
parent 350a062ca9
commit 2ab796979a
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336

View File

@ -12,25 +12,28 @@ ha_category: Notifications
ha_release: "0.40"
---
The `Cisco Spark` platform allows you to deliver notifications from Home Assistant to [Cisco Spark](https://ciscospark.com/).
The `ciscospark` notification platform allows you to deliver notifications from Home Assistant to [Cisco Spark](https://ciscospark.com/).
To use this notification platform you need to get a developer token. To obtain a token visit [Spark for Devleopers](https://developer.ciscospark.com/index.html)
At this time you also need to specify the `Cisco Spark` `roomid`. The `roomid` can also be found at [Spark for Devleopers](https://developer.ciscospark.com/index.html).
Just look in the Doumentation under Rooms.
At this time you also need to specify the `Cisco Spark` `roomid`. The `roomid` can also be found at [Spark for Devleopers](https://developer.ciscospark.com/index.html). Just look in the Doumentation under Rooms.
To enable the `Cisco Spark` notification in your installation, add the following to your `configuration.yaml` file:
To enable the Cisco Spark notification in your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
notify:
- name: NOTIFIER_NAME
platform: ciscospark
token: <YOUR_DEVELOPER_TOKEN>
roomid: <CISCO_SPARK_ROOMID>
token: YOUR_DEVELOPER_TOKEN
roomid: CISCO_SPARK_ROOMID
```
Configuration variables:
- **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 development token.
- **roomid** (*Required*): The Room ID.
To use notifications, please see the [getting started with automation page](/getting-started/automation/).