diff --git a/source/_components/wink.markdown b/source/_components/wink.markdown index 4cd2283687b..e8e43b30bfb 100644 --- a/source/_components/wink.markdown +++ b/source/_components/wink.markdown @@ -32,12 +32,36 @@ wink: access_token: YOUR_ACCESS_TOKEN ``` +You can also request API access via Wink's [contact us](http://www.wink.com/help/contact/) page. + +You will be provided with a client ID and a client secret via email. These can then be used in your configuration in place of the access_token this will prevent you from having to manually refresh your access token. + +```yaml +wink: + email: YOUR_WINK_EMAIL_ADDRESS + password: YOUR_WINK_PASSWORD + client_id: YOUR_WINK_CLIENT_ID + client_secret: YOUR_WINK_CLIENT_SECRET +``` + +The following can also be provied to allow access to the Wink Relay sensors. This value could change at any time. + +```yaml +wink: + user_agent: Manufacturer/Home-Assistant WinkAndroid/4 +``` + Configuration variables: -- **access_token** (*Required*): The retrieved access token. +- **access_token** (*Required if the below aren't present.*): The retrieved access token. +- **email** (*Required if access token isn't provied*): Your Wink login email. +- **password** (*Required if access token isn't provied*): Your Wink loging password. +- **client_id** (*Required if access token isn't provied*): Your provided Wink client_id. +- **client_secret** (*Required if access token isn't provied*): Your provided Wink client_secret. +- **user_agent** (*Optional*): The user-agent passed in the API calls to Wink. This will connect to the Wink hub and automatically set up any lights, switches and sensors that it finds.

-The Wink hub can only be accessed via the cloud. This means it requires an active internet connection and you will experience delays when controlling devices (~3s) and getting an updated device state (~15s). +The Wink hub can only be accessed via the cloud. This means it requires an active internet connection and you will experience delays when controlling and updating devices (~3s).