Somfy
The Somfy Open API (cloud-based) has been deprecated in favor of the Somfy TaHoma Developer Mode and will shut down after June 21st, 2022. The Overkiz integration will support this new local API and can already be used to control your Somfy devices via the cloud.
The Somfy integration will allow users to integrate their Somfy devices into Home Assistant using the official API.
Installation
Somfy is leveraging the new account linking service. This means that to set up Somfy, you only need to go to the integrations page and click on add new integration.
Installation with own developer account
It is possible to create your own developer account and configure Somfy via that.
Setting up developer account
- Visit https://developer.somfy.com.
- Log in using your Somfy credentials.
- Open the My Apps menu.
- Add a new App:
- App Name: Home Assistant
- Callback URL:
<YOUR_HOME_ASSISTANT_URL>/auth/external/callback
- Description: Home Assistant instance
- Product: Somfy Open API
Pre-configuration
# Example configuration.yaml entry
somfy:
client_id: CONSUMER_KEY
client_secret: CONSUMER_SECRET
optimistic mode should only be used when the integration is not able to gain information on whether a cover is open or closed (e.g., RTS devices). It will attempt to track the status within Home Assistant. This mode should only be used if Home Assistant is the only way you operate the blind. If you also use the physical remote control or the Somfy app, Home Assistant will become out of sync.
Configuration
Adding Somfy to your Home Assistant instance can be done via the user interface, by using this My button:
Somfy can be auto-discovered by Home Assistant. If an instance was found, it will be shown as “Discovered”, which you can select to set it up right away.
If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the sidebar click on Settings.
-
From the configuration menu select: Devices & Services.
-
In the bottom right, click on the Add Integration button.
-
From the list, search and select “Somfy”.
-
Follow the instruction on screen to complete the set up.