Over dit item
UniFi Insights verbindt Home Assistant via een API-sleutel met UniFi Network, Protect, Access en verwante Ubiquiti-producten. Het werkt met een console op het lokale netwerk of met elke console in een UniFi-account via UniFi Cloud, en wordt ingesteld in de UI. Het voegt sensoren, binaire sensoren, schakelaars, knoppen, camera's, sloten, lichten, gebeurtenissen, apparaattrackers en firmware-updates toe, gegroepeerd onder hun UniFi-apparaten. Acties dekken taken zoals het herstarten van apparaten, het uit- en weer inschakelen van PoE-poorten, het opnieuw verbinden van draadloze clients en het exporteren van netwerkregels als document. Met opties kan het WiFi-clients en bekabelde clients volgen, het opvragen beperken tot gekozen sites en Access-deurgebeurtenissen ontvangen. Zes dashboardkaarten worden meegeïnstalleerd, en diagnostiek maskeert API-sleutels, adressen en clientnamen.
Automatische samenvatting van de README en de code van tinkerologie/ha-unifi-insights, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op
Ondersteunt
Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.
Levert
- Lichten
- Rolluiken
- Camera’s
- Sloten
- Alarmpanelen
- Media
- Schakelaars
- Sensoren
- Aanwezigheid
Instellen
Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.
Verbindingstype
- VerbindingstypeLokaal: verbind rechtstreeks met je UniFi-apparaat op je netwerk. Extern: verbind via UniFi Cloud met je cloud-API-sleutel.
Lokale verbinding
- Host-URLDe URL van je UniFi-apparaat (bijvoorbeeld https://192.168.1.1)
- API-sleutelAPI-sleutel van je UniFi Controller (Instellingen → Control Plane → API Keys)
- SSL-certificaat verifiërenSchakel dit uit voor zelfondertekende certificaten (gebruikelijk bij lokale apparaten)
- UniFi Access API-token (optioneel)Maak dit aan in Access > Settings > General > Advanced. Het staat los van de UniFi API-sleutel en geeft toegang tot Access-deuren, noodbediening en gebeurtenissen. Laat leeg om Access over te slaan.
- Poort van de UniFi Access developer APIPoort van de UniFi Access developer API op de console. De officiële standaardwaarde is 12445.
Externe verbinding (UniFi Cloud)
- API-sleutelCloud-API-sleutel van je UniFi-account. Na validatie kies je een van de consoles waartoe deze API-sleutel toegang heeft.
Externe console selecteren
- ConsoleDeze consoles zijn gevonden met je API-sleutel.
UniFi Carrier Fabric
- API-sleutelEen API-sleutel met Carrier Fabric ISP-rechten (type ISP).
Ook gevraagd bij het opnieuw inloggen.
Opnieuw verifiëren
- API-sleutelEen nieuwe API-sleutel van je UniFi Controller (Instellingen → Control Plane → API Keys)
Opnieuw configureren
- Host-URLDe URL van je UniFi-apparaat (bijvoorbeeld https://192.168.1.1)
- API-sleutelAPI-sleutel van je UniFi Controller (Instellingen → Control Plane → API Keys)
- SSL-certificaat verifiërenSchakel dit uit voor zelfondertekende certificaten (gebruikelijk bij lokale apparaten)
- Console-IDDe ID van de UniFi-cloudconsole waarmee deze invoer verbinding maakt
- UniFi Access API-token (optioneel)Voer een nieuw token in om het opgeslagen token te vervangen. Laat leeg om het huidige token te behouden.
- Poort van de UniFi Access developer APIPoort van de UniFi Access developer API op de console.
- Access-token verwijderenSchakel in om het Access-token en de bijbehorende webhook voor toegangsresultaten te verwijderen. Wordt genegeerd als een nieuw token wordt ingevoerd.
Na het instellen
- WiFi-clients volgenMaak apparaattracker-entiteiten aan voor verbonden WiFi-clients. Dit kan veel entiteiten opleveren.
- Bekabelde clients volgenMaak apparaattracker-entiteiten aan voor verbonden bekabelde (LAN) clients. Dit kan veel entiteiten opleveren.
- Clientbediening inschakelenMaak schakelaars om toe te staan of te blokkeren en knoppen om opnieuw te verbinden aan voor verbonden clients, en Wake-on-LAN-knoppen (standaard uitgeschakeld) voor bekabelde clients. Als je dit uitschakelt, worden de clientknoppen verwijderd.
- SitesVraag alleen deze sites op. Laat leeg om elke site op de console mee te nemen. Niet-geselecteerde sites worden niet opgevraagd, wat het API-verkeer op consoles met meerdere sites verlaagt.
- Individuele abonnees als apparaten volgenMaak apparaatinvoer aan voor elke abonnee in je Carrier Fabric-organisatie.
- Service-acties inschakelen (abonnees opschorten en hervatten)Sta toe dat abonneediensten vanuit Home Assistant worden opgeschort en hervat.
- Access-deurgebeurtenissen ontvangen (toegestaan en geweigerd)Home Assistant moet vanaf de console bereikbaar zijn voor deze gebeurtenissen. Schakel uit om de Access-webhook te verwijderen.
Teksten uit de code van tinkerologie/ha-unifi-insights. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.
Entiteiten
- AlarmpanelenAlarm
- KnoppenApparaat herstarten, PoE uit- en weer inschakelen, Gastvoucher genereren, Ontgrendelen, Opnieuw verbinden, Afspelen, PTZ-patrouille starten, PTZ-patrouille stoppen
- RolluikenPoort
- AanwezigheidLocatie
- GebeurtenissenDeurbel, Slimme detectie, Deur/Raam, Wijzigingen in netwerkregels, Toegangsresultaat
- AfbeeldingenPlattegrond, QR-code van laatste voucher, WiFi-QR-code
- SlotenSlot
- MediaLuidspreker
- NummersMicrofoonvolume, Helderheidsniveau, Gongvolume, Aantal herhalingen, Voucherduur, Gastlimiet voucher, Downloadlimiet voucher, Uploadlimiet voucher, Datalimiet voucher
- SelectiesHDR-modus, Videomodus, Beltoon, PTZ-voorinstelling, Liveview
- SensorenCPU-gebruik, Geheugengebruik, Uptime, Uplink-verzendsnelheid, Uplink-ontvangstsnelheid, Temperatuur, Luchtvochtigheid, Batterij en nog 72
- SchakelaarsStatuslampje, High FPS-modus, Toestaan, Aan/uit-cyclus, VPN-client, Lockdown, Evacuatie
- UpdatesFirmware
Acties
- Gegevens vernieuwenForceer een onmiddellijke vernieuwing van de UniFi Insights-gegevens.Velden: Site-ID
- Apparaat herstartenHerstart een UniFi-apparaat.Velden: Site-ID, Apparaat-ID, Entiteit
- Gekoppelde deurbellen van gong instellenKies welke deurbellen een UniFi Protect-gong laten overgaan. De selectie vervangt de huidige koppeling van de gong. Laat Deurbellen leeg om alle deurbellen los te koppelen.Velden: Gong-ID, Deurbellen, Entiteit, Apparaat
- Abonnee opschortenStop de internetdienst van een abonnee. Vereist dat de optie "Enable service actions" is ingeschakeld bij de Carrier Fabric-integratie en een ISP-API-sleutel met de scope suspend:service.Velden: Reden, Entiteit, Apparaat
- Abonnee hervattenHerstel de internetdienst van een abonnee. Vereist dat de optie "Enable service actions" is ingeschakeld bij de Carrier Fabric-integratie en een ISP-API-sleutel met de scope resume:service.Velden: Entiteit, Apparaat
- PoE-poort aan/uit zettenZet een PoE-poort op een UniFi-netwerkapparaat uit en weer aan.Velden: Site-ID, Apparaat-ID, Poortindex, Entiteit
- Client opnieuw verbindenVerbind een verbonden draadloze client opnieuw met wifi. Accepteert alleen clients die momenteel verbonden en draadloos zijn.Velden: Site-ID, Client-ID, Entiteit, Apparaat
- Clients verwijderenVerwijder kortstondige, naamloze historische clients uit het UniFi Network. Vergeet clients zonder naam, hostnaam of vast IP-adres die 15 minuten of korter zijn gezien. Als een tijdstempel ontbreekt, wordt de client niet uitgesloten door de leeftijdscontrole. Verwerkt de sites die in de instellingen van de integratie zijn geselecteerd, op consoles waar Network beschikbaar is. Clients met een tijdstempel die geen getal is, blijven behouden. Vereist een beheerder. Verwijdert geen Home Assistant-apparaten of -entiteiten.
- Beltoon van gong afspelenDeze actie geeft altijd een foutmelding dat dit niet wordt ondersteund, omdat de officiële Protect-API geen route heeft om op een gong af te spelen.Velden: Gong-ID, Beltoon-ID, Entiteit, Apparaat
- Netwerkregels exporterenGeeft een momentopname van de firewallbeleidsregels, op beleid gebaseerde routes, poortdoorsturingen, verkeersregels, NAT-regels en statische routes van één console terug als document met versienummer, voor vergelijking, versiebeheer en handmatig herstel. Het is geen volledige back-up van de console: de netwerken, zones, lijsten voor verkeersherkenning, groepen en VPN-definities waarnaar regels verwijzen zijn niet inbegrepen, en er is geen import. De regels worden uit de console gelezen op het moment dat je de actie uitvoert. Alleen een regeltype met status ok is volledig. Failed betekent dat het antwoord niet gelezen kon worden, geen JSON was, onvolledig was of een record bevatte dat niet verwerkt kon worden. Unsupported betekent dat de console het verzoek weigerde, of dat de site geen klassieke naam heeft voor de vijf andere regeltypen dan firewallbeleidsregels. Vereist een beheerder. De actie geeft alleen gegevens terug en schrijft geen bestand.Velden: Site-ID, Console, Regeltypen, Gevoelige waarden afschermen
- Pincode van Access-gebruiker instellenWijs een pincode toe aan een UniFi Access-gebruiker. De pincode mag alleen uit cijfers bestaan. De console controleert de lengte en geeft een afwijzing terug als de waarde niet wordt geaccepteerd. Vereist een beheerder.Velden: Gebruikers-ID, Pincode, Console
- Pincode van Access-gebruiker verwijderenVerwijder de pincode die aan een UniFi Access-gebruiker is toegewezen. Vereist een beheerder.Velden: Gebruikers-ID, Console
- Status van Access-gebruiker instellenZet een UniFi Access-gebruikersaccount op ACTIVE of DEACTIVATED. Dit geldt voor het hele account, dus een gedeactiveerde gebruiker verliest toegang via elke inloggegevens. Vereist een beheerder.Velden: Gebruikers-ID, Status, Console
Probleemoplossing
- DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
Uit de README
Monitor and control your UniFi system from Home Assistant: UniFi Network, UniFi Protect, UniFi Access, UniFi InnerSpace, UniFi Mobility, UniFi Site Manager and UniFi Carrier Fabric, in one integration.
Te zien in Vulpo
Licht-kaart, “Snel wisselen”-kaart, Rolluik-kaart, Slot-kaart, Apple Watch, Bedieningspaneel.Informatie
- Installaties
- 413 die analysegegevens delen
- GitHub-sterren
- 47
- Verbinding
- Werkt lokaal
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v2026.10.4,
- Categorie
- Computers en netwerk, Routers en netwerk
- Soort
- Marketplace-integratie
- Merk
- Ubiquiti
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
unifi_insights- Problemen
- Probleem melden
















