Small updates with extra help - based on reviewing forums (#21057)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Huwee2 2022-02-18 22:31:08 +00:00 committed by GitHub
parent 64e33c666b
commit 7467411c72
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -106,7 +106,7 @@ It is therefore recommended to use [an individual development account](#developm
</div>
To be able to receive events from [Netatmo](https://www.netatmo.com/en-gb/), your Home Assistant instance needs to be accessible from the web over port `80` or `443`. To achieve this you can either use your Nabu Casa account or for example Duck DNS ([Home Assistant instructions](/addons/duckdns/)). You also need to have the external URL configured in the Home Assistant [configuration](/docs/configuration/basic).
To be able to receive events from [Netatmo](https://www.netatmo.com/en-gb/), your Home Assistant instance needs to be accessible from the web over port `443`. To achieve this you can either use your Nabu Casa account or for example Duck DNS ([Home Assistant instructions](/addons/duckdns/)). You also need to have the external URL configured in the Home Assistant [configuration](/docs/configuration/basic).
Events coming in from Netatmo will be available as an event in Home Assistant and are fired as `netatmo_event`, along with their data. You can use these events to trigger automations.
@ -214,6 +214,12 @@ to declare a new application in the [Netatmo Developer Page](https://dev.netatmo
Sign in using your username and password from your regular Netatmo account.
<div class='note warning'>
In your Netatmo Application configuration, do not enter a 'redirect URI' or a 'webhook URI'. The 'webhook URI' is automatically registered by this integration based on the external URL configured in the Home Assistant [configuration](/docs/configuration/basic).
</div>
Next, add the following lines to your `configuration.yaml`:
```yaml
@ -243,6 +249,10 @@ After completing the configuration flow, the Netatmo integration will be availab
## Troubleshooting
### Receiving events
To confirm your Home Assistant instance is receiving events via webhooks, you can listen to `netatmo_event` in {% my developer_events title="Developer Tools -> Events" %}.
### Light
If the lights show as unavailable the issue usually is that webhook is banned by Netatmo. To solve that [unregister](#un-register-webhooks) the webhook, go to the [Netatmo Developer Page](https://dev.netatmo.com/) to unban your webhook and then [register](#un-register-webhooks) the webhook.