Homey Pro Webhook Integration with Unifi Protect for Fingerprint & NFC

In my previous post, I mentioned the long waited release from Unifi Protect on the G4 Pro Doorbell.

Having seen a few videos online people using webhook to have Home Assistant to work using Webhook with Unifi Protect, I believe Homey Pro will be able to do something similar.

However, Webhook is new to me and it took me awhile with some help in Homey forum. Finally I managed to have that integration completed.

First you need to prepare a few things:

1. Homey Cloud ID

It is under Settings, General and Cloud section.

2. You need to have a event name to be capture in Homey Flow Webhook Logic card. If you mouse over the information icon, you will see the screenshot below with the delivery URL to be use in Unifi Protect app.

https://webhook.homey.app/<homey_ID>/<my_event>?tag=<tag_name>

What we need to change is the <my_event> a name which you will be using to recognize the Webhook event call. The other is a <tag_name> if send a state. In my case, I am using fingerprint and I want to make sure all registered fingerprint in Unifi Protect via G4 Pro doorbell, will send a "yes". It will then looks something like this: 

https://webhook.homey.app/xxxxxx/fingerprint?tag=yes

The flow will looks like below. 

What happen here is whenever a registered fingerprint is triggered on Unifi G4 Pro Doorbell, an alarm is created with the Webhook URL with a POST containing an even name "fingerprint" and a tag name, "yes".

A separate alarm with Webhook URL with a tag name, "no" was also create to define the different. That only a message is send.

As you can see above, I also send a message for registered fingerprint to ensure my Webhook flow is correctly triggered.

So you can do the same with registered NFC. Once again, I do not recommend to use NFC due to the fact it can be easily duplicated as mentioned in my previous post.

Ubiquiti G4 Pro Doorbell New Features

With the new release of Unifi Protect, originally featured when this doorbell was release almost 2 years ago, it does came slightly late than never. This doorbell now support fingerprint and NFC.

To use this features, you will need to have some home automation or have a Unifi Access setup. I am not an office owner and only a simple home owner. So I do have my smart home setup using Homey Pro. Why I did not choose other platform, I will leave that to another article.

Back to our main topic. The registeration of fingerprint and NFC is very simple, you can just add them easily and follow the screen procedure on the G4 Pro doorbell.

When you click on Add New (fingerprint), you will get a prompt and select a user. If the user is new, you can just add one. You do not need to assign any roles, it can be just a simple user with a name.

Press and register your fingerprint on the reader till you reach 100%. Tilt and turn your finger so it capture the bigger surface area.

Choose a user or add a new one.

Once that is done you will be able to just press the read and it will recognize the user and displaying the user name.

Unifi Protect with this update also include a new notification manager call Alarm Manager.

I created an alarm for known fingerprint and push out a Webhook. You can either push that to Slack or for my case, custom to my Homey Pro.

With my Smart Home integration with Homey Pro, I will then unlock my door and send a message to my user as a notification to my Homey mobile app.

I will not recommend any NFC card access, as it only register typical NFC card, those can be easily duplicated. It can register encrypted ones e.g. HID, but it cannot read from it after to use as an access. It is a bummer.

A video on how it looks like. A next article to show my Webhook integration into Homey Pro. 

p.s. my fingerprint sensor on my smart lock is no longer working so this feature comes just in time instead of number pad access which is very cumbersome.