SwitchBotAPI icon indicating copy to clipboard operation
SwitchBotAPI copied to clipboard

Keypad & Keypad Touch new webhook messages

Open AdyRock opened this issue 1 year ago • 11 comments

Current Situation

Currently there are no notifications about the keypad usage so we can't log who is using it and if there are hacking attempts.

Proposed Change

Create a webhook for keypad usage that includes the name of the password / fingerprint / card that was used (the name recorded when adding the code, etc), and the method such as password, fingerprint or card. If the method was not recognised then send something like Unknown for the name.

{
    "eventType": "usageReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoKeypad",
        "deviceMac": DEVICE_MAC_ADDR,
        "eventName": "usedKey",
        "commandId": "CMD-1663558451952-01",
        "name": "pascodeName",
        "type": "password",
        "result": "success",
        "timeOfSample": 123456789
    }
}

Additional Context

Providing this information would allow further automations based on who has unlocked the door or for notifications to be sent out if the operator is unknown which could be an opportunist trying their luck.

AdyRock avatar Oct 15 '22 10:10 AdyRock

Any idea if this would be possible?

AdyRock avatar Oct 25 '22 10:10 AdyRock

I too am looking for this functionality because you can then:

  • Log who actually unlocked the door for security purposes (it's available in the app)
  • Use the information to trigger automations specific to the person opening the front door. e.g. different actions for house owners versus a cleaner entering your property

asknoone avatar Nov 12 '22 17:11 asknoone

Je valide.... ainsi que le remote, rien dans les webhooks, donc inutilisable :-/

jeremyarnoux avatar Nov 20 '22 08:11 jeremyarnoux

@Minsheng is it planned to enhance Keypad & Keypad Touch requested webhooks like suggested by @AdyRock?? If yes, when we can expect the GA of this APIs?

franden avatar Mar 30 '23 08:03 franden

Wow, nearly a year with no feedback at all - this would be so useful since you could trigger automations based on who unlocked the door...

koshisan avatar Jun 19 '23 12:06 koshisan

I also find this very helpful. Please consider this feature.

Marosso avatar Sep 15 '23 08:09 Marosso

For me it is a critical feature. It is complete non-sense when this keypad device is "talking" only with a lock.

PrzemekLipka avatar Nov 24 '23 13:11 PrzemekLipka

it would be a huge advantages, and wouldn't be a security impact I think

lukes-ha avatar Dec 07 '23 20:12 lukes-ha

Please add this feature. And please also include it into scenarios, then you could for instance open the garage door when the lock is opened (my case).

frean087 avatar Dec 21 '23 14:12 frean087

One quarter later, Please consider this since sales for these keypads and locks would increase significantly if this request was implemented. There is a lot of scenarios where it can be used and the hardware is great!

frean087 avatar Mar 13 '24 07:03 frean087

Hi,

Keypad Touch Lock.

I need following feature in API

  1. List of Passcode, Fingerprint, NFC Cards
  2. Enable/Disable Lock Button
  3. Enable/Disable Keypad

I need following event in webhooks.

  1. Unlock (Passcode + Fingerprint + NFC) - with type and its id
  2. Locked (Auto + Manually)
  3. Keypad Removal Alerts

We need API and Webhook for security purpose and making attendance system using this device.

We are making fully automated office using SwitchBot Devices, only above mentioned API + Webhook are missing.

Please update your API and Webhook.

Thanks.

vishwajit76 avatar Apr 10 '24 12:04 vishwajit76