In de wereld van smart homes wil je vaak dat al je apparaten samenwerken. Een deurbel is een typische trigger: als iemand op de bel drukt, wil je dat er een notificatie komt, dat er een camera-snapshot wordt gemaakt of dat lichten aangaan, of dat een deurslot de deur open maakt. In dit artikel leg ik uit hoe je een UniFi-deurbel (via UniFi Protect) kunt integreren met Homey via de officiële (community) plug-in Ubiquiti UniFi Protect. We behandelen de vereisten, de installatie, het toevoegen van de deurbel, en hoe je vervolgens flows kunt maken op basis van belacties of beweging.

 

1. Voorwaarden & aandachtspunten

Voordat je begint zijn er een aantal dingen die je moet controleren en voorbereiden:

Voorwaarde / aandachtspunt Waarom belangrijk Tips / opmerkingen
Je hebt een UniFi Protect-omgeving (bijv. Dream Machine, CloudKey, UNVR, Gateway De deurbel moet beheerd worden via UniFi Protect De UniFi Protect plug-in gebruikt de Protect API lokaal. (Plugin)
Homey moet de plug-in kunnen draaien (Homey Pro) De app is beschikbaar als communityapp en vereist Homey Pro volgens documentatie.
Homey moet netwerktoegang hebben tot jouw UniFi Protect controller / server (geen firewall-blokkades) Anders kan Homey niet communiceren met Protect Als je camera’s, Protect, en Homey in aparte VLANs hebt, controleer je firewallregels.
Een “local user” account in UniFi Protect (met geschikte rechten) Je wil een account gebruiken dat door Homey gebruikt wordt, bij voorkeur met alleen de benodigde rechten (bijv. “View”-rechten)

2. Installeren van de UniFi Protect plug-in op Homey

Volg deze stappen:

  1. Open de Homey app op je telefoon of via de webinterface.
  2. Ga naar de App Store / Apps sectie.
  3. Zoek naar “Ubiquiti UniFi Protect” of via deze link
  4. Installeer de app / plug-in op Homey.
  5. Na installatie: open de instellingen van de plug-in.
  6. Je moet de inloggegevens van de UniFi Protect “local user” invullen, samen met het IP-adres of hostnaam van je UniFi Protect controller / server.
  7. Start de “add device wizard” binnen de plug-in: laat Homey zoeken naar je UniFi Protect devices (camera’s, deurbel) en voeg deze toe.
  8. Zodra de devices zijn toegevoegd, zie je ze verschijnen onder je apparaten in Homey.

Opmerking: Als je later de inloggegevens wijzigt in UniFi Protect, moet je die ook aanpassen in de Homey-app instellingen

3. Deurbel (doorbell) detecteren & configureren

Zodra de plug-in actief is en apparaten zijn toegevoegd, kun je controleren of je deurbel verschijnt als een apart device in Homey:

  • De plug-in ondersteunt “Doorbell” als apparaat type (naast camera’s).

  • Je zou flow-triggers moeten krijgen zoals:

    • “Doorbell pressed” (deurbel ingedrukt)

    • Ook beweging, objectdetectie, gezichtsherkenning (afhankelijk van je camera / deurbel model) kunnen beschikbaar zijn.

  • Maak een flow aan, bijv wanneer de deurbel wordt ingedrukt, stuur een snapshot naar smartphone of activeer lichten of laat een geluid afspelen op je speakers (Sonos)

4. Flows maken in Homey op basis van de deurbel

Als de deurbel correct is gekoppeld, kun je in Homey flows maken. Hier is een voorbeeld:

  1. Ga naar Flows in de Homey app.
  2. Bij de trigger (“When …”) kies je Deurbel → Doorbell pressed (of een andere kaart) als start van de flow.
  3. Als “And …” kun je extra voorwaarden toevoegen, bijvoorbeeld “alleen ’s avonds” of “als ik niet thuis ben”.
  4. Bij “Then …” kun je acties kiezen, zoals:
    • Maak een snapshot of video via de camera.

    • Stuur een pushnotificatie naar je telefoon.

    • Zet lichten aan (bijv. buitenlamp).

    • Speel een geluid af via een speaker (Sonos, etc.).

    • Stel het volume van de bel of chime in (deze kaarten zijn beschikbaar in de plug-in).

Een flow zou er bijvoorbeeld uit kunnen zien als:

  • Wanneer: Deurbel wordt ingedrukt

  • Anders: (optioneel) tijd is tussen 18:00 en 07:00

  • Dan:
     – Maak snapshot van deurbelcamera
     – Stuur pushnotificatie: “Er klopt iemand”
     – Zet buitenverlichting aan
     – Speel belgeluid op speaker

5. Deur openen icm een slim deurslot

Je kunt de UniFi-deurbel (met NFC of vingerafdruk-functionaliteit) gebruiken om bijvoorbeeld je Nuki (of ander merk) slot te ontgrendelen door Homey als “tussenpersoon” te gebruiken. De basisgedachte is dat de UniFi-deurbel een event (bijv. doorbell pressed of een specifieke authenticatie-trigger) naar Homey stuurt via de UniFi-Protect-app, en dat Homey vervolgens een unlock-commando naar je Nuki Smart Lock stuurt via de plugin die je aan Homey hebt toegevoegd. Zorg dat zowel de UniFi Protect app als het Nuki apparaat in Homey zijn geïnstalleerd en geconfigureerd zijn.

Een eenvoudig, veilige voorbeeld flow (in Homey) ziet er zo uit:

  1. Trigger: UniFi-deurbel bevat een succesvolle NFC/vingerafdruk-authenticatie (of een aparte sensor/card die aangeeft dat iemand geverifieerd is).
  2. Condition: alleen tussen bepaalde tijden of alleen als een aanwezigheid-conditie (bijv. jouw telefoon thuis = false) geldt — dit voorkomt ongewenst automatisch openen.
  3. Action: stuur het “unlock” commando naar Nuki via de Nuki koppeling in Homey. Let op: voor sommige oudere Nuki-setups moet je de Bridge HTTP API inschakelen of Nuki Web configureren zodat Homey het slot kan aansturen. Bij de Nuki Smart Lock Pro Gen5 kun je deze direct als Matter apparaat aan Homey koppelen waarna je alles kunt gebruiken.

Belangrijke veiligheids tip: activeer altijd extra voorwaarden (tijd, aanwezigheid, bevestiging) voordat je automatisch ontgrendelt en log alle ontgrendelingen. Nuki biedt moderne toegangsmethoden en auto-unlock-opties, maar omdat je een deur opent vanuit een externe trigger, verdient dit extra aandacht qua beveiliging.

Het koppelen van een UniFi-deurbel aan Homey via de Ubiquiti UniFi Protect plug-in is zeker mogelijk en biedt je de flexibiliteit om automations te maken op basis van beldruk, detecties of andere gebeurtenissen. Het vergt echter wel dat je netwerkarchitectuur correct is ingesteld, dat je de juiste rechten hebt en dat je bereid bent enige “tweaks” te doen naar aanleiding van updates of beperkingen in de plug-in.

Meer met UniFi Access

Wil je ook nog je garage deur kunnen openen met UniFi en Homey? Check dan onze blog post voor meer informatie.