Somfy keyfob / Overkiz unexpected error / unknown user

hi folks,

I have a Somfy key fob, and am running HA 2022.8.7 and created an account on somfy.es (that’s in Europe). Having confirmed the account via email, I can log in to the somfy.es website using these credentials. So the user is known to Somfy in Europe.

When I try to use this account info to log in via the Overkiz integration, using my email address as my username, I get the “Unexpected Error” on the screen and the following error in the logs:

pyoverkiz.exceptions.UnknownUserException: Unknown user : '[email protected]'

There seems no way to proceed, any helpful suggestions appreciated.

You posted in “Zigbee” subforum but as far as I can tell your question has nothing to do with Zigbee?

1 Like

Good point (although it’s a zigbee keyfob that I’m trying to integrate).

Moved, thanks! :+1:

I don’t think Somfy has any Zigbee keyfobs? Regardless it is really only the “integration” used for Home Assistant that matters for the different forum subsections, see → Integrations - Home Assistant

So if Home Assistant is only talking to a cloud-service or a local-API used by a proprietary black-box hub/gateway/bridge/controller/proxy by Somfy or somthing similar then Home Assistant does not need to know if the devices hidden behind that cloud-service or proprietary box is talking Zigbee with it, as Home Assistant itself will never see the Zigbee communication because it is abstracted away. This is the same if you are talking about Philips Hue Bridge, IKEA Trådfri Gateway, Samsung SmartThings Hub, etc. where they all use might talk Zigbee to the device but Home Assistant does not know that and does not need to know that.

This Zigbee subforum is mostly about Zigbee integrations which implement support for standard Zigbee via a Zigbee radio adapter directly connected via USB or Serial/UART, such as the ZHA integration, Zigbee2MQTT, and deCONZ/Phoscon. See ex. → Zigbee Home Automation - Home Assistant

If you buy a inexpensive Zigbee USB adapter then you could try the ZHA integration, Zigbee2MQTT, or deCONZ/Phoscon to control the device directly, if that device uses any standard Zigbee protocols.

1 Like

Thanks for the clarification Hedda. I’m fairly new to HA and zigbee etc. and I’m finding these kinds of classification mistakes easy to make atm. It’s good to be corrected and learn on-the-fly. Thank you. :+1:

I have a pack of Hue lights and motion sensors working via HA, with no Phillips Hue Hub, and I’m really happy with the way HA manages to make everything work mostly smoothly. The integration/s seem to pick up nicely where the official Hub is non-existent.

I’m expecting the Overkiz integration to do this for the Somfy key fob using their agreed protocol/s. The problem I have at the moment is with the username/email not being recognized by the Overkiz integration.

Overkiz (cloud-service integration) discussion probably belongs in the third-party integrations subforum → https://community.home-assistant.io/c/third-party/15 or maybe the general configuration forum → https://community.home-assistant.io/c/configuration/11

1 Like

Yep, third-party, that’s where I have already moved this to. :+1:

I’m using this ConBee integration, which I think is Zigbee2MQTT, to try to connect to the Somfy key fob:

ConBee II - /dev/ttyACM0, s/n: DE2285186 - dresden elektronik ingenieurtechnik GmbH - 1CF1:0030
Zigbee Home Automation

Although I’ve come a long way from day-1, I’m still a bit of a newbie with HA/zigbee. I was following the basic steps:

  1. Buy a Somfy key fob.
  2. Install the Somfy/Overkiz integration.
  3. Configure and use.

It’s entirely possible I’m missing the obvious “manual” workaround/solution to “control the device directly” here.

@richardrfi can you share more information about the Somfy key fob? Do you own a Somfy Protect alarm system?

Regarding your unknown user exception, we recently added better handling to the integration that will show an error when you try to configure a Somfy Protect account. Catch unknown user exception in Overkiz integration by iMicknl · Pull Request #76693 · home-assistant/core (github.com) (PR still pending).

1 Like

hi @imick ,
thanks for your reply,

No, I do not own any Somfy Protect alarm system.
I have an online Somfy account only.
I’m doing this entirely through HA.

It feels like I only need to go through this step to register the device with Somfy and then HA will recognise the keyfob afterwards. This is what I’m attempting to achieve here.

Can you share which device you try to add?

The Overkiz integration can only be used with an Overkiz compatible hub (e.g. Somfy TaHoma). How does your keyfob connect to Home Assistant, if you don’t have a hub?

1 Like

I’m trying to connect the Somfy keyfob. There is no hub that I am aware of. This could explain why it doesn’t work :smiley:

It seems a bit overkill (not overkiz) to have to purchase a hub just to get a radio keyfob to function. Maybe I’d be better off going for a dedicated zigbee keyfob. I may have found one in the Heiman, not sure yet.

I would return it indeed, since you will need a hub for this. This is not just a Zigbee / Z-Wave keyfob.

2 Likes

@richardrfi There seems to be a lot of confusion. It now sounds as if you are actually using the “Zigbee Home Automation” integation (also known as “ZHA” integation ) with a ConBee USB adapter, that is this here → https://www.home-assistant.io/integrations/zha/ or?

And that you do not actually have Overkiz hub (meaning for example Somfy TaHoma hub)? Which in case it is not obviuously needed in order to use the Overkiz integration.

If that is the case then you will need to do more research to make sure that the specific Somfy keyfob you have is actually using Zigbee technology AND also have firmware that at least partially supports one of the standard Zigbee specifications.

If that is the case then and only then might you be able to add support for it to the ZHA integration, but be sure to read https://www.home-assistant.io/integrations/zha/#zha-exception-and-deviation-handling and then post a new “Device support Request” issue to the ZHA Device Handlers repoitory on GitHub → https://github.com/zigpy/zha-device-handlers/issues/new/choose

That is my understanding too, I strongly suspect that his specific Somfy keyfob probably does not use Zigbee wireless protocol at all and instead uses some proprietary RF protocol that is not Zigbee.

Obviously the ZHA ingration only support Zigbee devices → https://www.home-assistant.io/integrations/zha/#knowing-which-devices-are-supported

thanks for the helpful responses here. It’s clear the Somfy keyfob is not immediately supported in ZHA. I suspect I’m the victim of over-enthusiastic “I need one, it should therefore work as I expect it to” :slight_smile:

We live and learn.

@richardrfi if it does not say specifically ”Zigbee” on the device itself, the official marketing material for it, its retail box it shipped in or its manual mentions “Zigbee” then the device is likely not using ”Zigbee”.

However if you want to find out then you can get yourself a ”Zigbee Sniffer” radio adapter (which is actually the same hardware as Zigbee Coordinator adapters with different firmware) and use that togther with Wireshark software to sniff the traffic of it when you to join/pair it to a Zigbee solution (e.i. evesdrop on the device to listen what it actually sending) to see if it sending Zigbee messages or not.

1 Like