- Ressourcen mit einer oder mehreren UniFi-Türen verknüpfen
- Community-Mitgliedern Zugang zu ausgewählten Türen gewähren
- den Zutritt über die UniFi App, einen PIN-Code oder Remote Open ermöglichen
Die UniFi-Integration ist ab dem Professional-Plan verfügbar.
Typische Anwendungsfälle
Wie die UniFi-Verbindung funktioniert
anny authentifiziert sich mit der Host-URL deines UniFi-Netzwerks und einem API-Token. Die Host-URL muss von außen erreichbar sein. Über die Verbindung ruft anny die in UniFi Access eingerichteten Türen und Nutzer:innen ab und verwaltet passende Zutrittsrechte. Standardmäßig erzeugt anny für jede Buchung einen Gastzugang mit PIN-Code. Aktivierst du in der Zutrittsregel die Option Berechtigungen für bestehende Benutzer erweitern, gleicht anny zuerst die Buchungs-E-Mail mit bestehenden UniFi-Accounts ab: Bei einer Übereinstimmung läuft der Zugang über die UniFi App, sonst wird ein PIN-Code erzeugt. App-Zugänge über bestehende UniFi-Accounts erstellt anny kurz vor Buchungsbeginn (Just-in-Time). anny fügt den Account dafür einer selbst verwalteten Zutritts-Richtlinie (Policy mit dem Zusatz „anny“) hinzu und entfernt ihn am Ende des Zeitraums wieder. Bis zur Erstellung hat der Zugang den Status Geplant. Wenn du den API-Token widerrufst oder die Host-URL nicht mehr erreichbar ist, kann anny keine Türen abrufen und keine Zutrittsrechte über UniFi verwalten.UniFi verbinden
Voraussetzungen
Bevor du UniFi verbindest, stelle sicher, dass du Folgendes hast:- ein eingerichtetes UniFi-Netzwerksystem mit UniFi Access und funktionsfähigen Türen
- eine von außen erreichbare Host-URL für dein UniFi-Netzwerk
- einen API-Token, den du in der UniFi Access App erstellst
- den Professional-Plan oder höher in anny
- mindestens eine Ressource oder Community für die Zutrittsregel
Verbindung einrichten
1
Integration öffnen
Öffne aus der Menüleiste die Integrationen und gehe zu UniFi.
2
Authentifizieren
Trage die Host-URL deines UniFi-Netzwerks und den API-Token ein. Hinweise zum externen Netzwerkzugang findest du in dieser Anleitung.
3
Konfigurieren
Lege die benötigten Zutrittsregeln an:
- Klicke bei Buchungen oder Communities auf Hinzufügen.
- Wähle die Ressource oder Community aus.
- Ordne eine oder mehrere UniFi-Türen zu.
- Lege bei Buchungsregeln Zugang vor der Buchung und Zugang nach der Buchung fest.
- Aktiviere bei Bedarf Fernöffnung verwenden oder Berechtigungen für bestehende Benutzer erweitern.
4
Verbindung prüfen
Erstelle eine Testbuchung und öffne ihre Detailansicht. Prüfe dort den Status, den Zugangszeitraum, die Tür und bei Gastzugängen den PIN-Code.
Die Detailansicht einer Buchungsregel zeigt die zugeordnete Ressource, die Türen sowie den zeitlichen Vor- und Nachlauf.
Für Communitys ordnest du einer Community eine oder mehrere Türen zu. So erhalten ihre Mitglieder die festgelegten Zutrittsrechte.
Einstellungen & Optionen
Du kannst aktive und inaktive Smart-Lock-Zugänge in der Buchungsdetailansicht prüfen. Dort siehst du den Status, den Zugangszeitraum, die Tür, das Erstellungsdatum und bei Gastzugängen den PIN-Code.
Remote Open
Mit der Remote-Open-Funktion können Kund:innen Türschlösser per Knopfdruck öffnen: direkt über die anny Homepage oder die Buchungsansicht.
Die Buchungsansicht zeigt den Button nur während des gültigen Zugangszeitraums.
Für Remote Open über eine Community aktivierst du die Option Fernöffnung verwenden in der Community-Regel.
Einschränkungen
Die UniFi-Integration unterstützt nicht:- die Einrichtung, Wartung oder Absicherung deines UniFi-Netzwerks und deiner Türhardware
- eine Verbindung ohne öffentlich erreichbare Host-URL
- den Zugang über die UniFi App ohne aktivierte Option Berechtigungen für bestehende Benutzer erweitern und ohne UniFi-Account mit der Buchungs-E-Mail
- einen Gastzugang per PIN ohne kompatible UniFi-Hardware mit Keypad
- Remote Open über eine Community ohne aktivierte Option Fernöffnung verwenden in der Community-Regel
Verbindung trennen
Beides findest du unter Integrationen: Deaktivieren über den Toggle oben rechts, Löschen über die drei Punkte → Löschen.FAQ
Wie erhalten Kund:innen Zugang zur gebuchten Tür?
Wie erhalten Kund:innen Zugang zur gebuchten Tür?
Standardmäßig erzeugt anny einen PIN-Code für den Gastzugang. Aktivierst du Berechtigungen für bestehende Benutzer erweitern und existiert ein UniFi-Account mit der Buchungs-E-Mail, läuft der Zugang über die UniFi App. Zusätzlich kann Remote Open verfügbar sein.
Wann ist der Zugang gültig?
Wann ist der Zugang gültig?
Der Zugang gilt für den Buchungszeitraum einschließlich des Vor- und Nachlaufs, den du in der Zutrittsregel festgelegt hast.
Kann ich mehrere Türen mit einer Ressource verbinden?
Kann ich mehrere Türen mit einer Ressource verbinden?
Ja. Du kannst einer Ressource mehrere Türen zuordnen und eine Tür mit mehreren Ressourcen verknüpfen.
Was passiert bei einer Stornierung?
Was passiert bei einer Stornierung?
Wenn eine Buchung storniert und ihr Zugang entfernt wird, kann die gebuchte Tür nicht mehr über dieses Zutrittsrecht geöffnet werden.
Wo finde ich den API-Token in UniFi?
Wo finde ich den API-Token in UniFi?
Erstelle den API-Token in der UniFi Access App. Trage ihn anschließend zusammen mit der Host-URL in anny ein.
Troubleshooting
Die Verbindung zu UniFi lässt sich nicht herstellen
Die Verbindung zu UniFi lässt sich nicht herstellen
Die Host-URL ist möglicherweise nicht von außen erreichbar oder der API-Token ist ungültig. Prüfe die Host-URL, den Token sowie die Netzwerk- und Firewall-Konfiguration.
Mein Zugang bleibt im Status „In Bearbeitung“
Mein Zugang bleibt im Status „In Bearbeitung“
UniFi hat das angeforderte Zutrittsrecht noch nicht bestätigt. Prüfe die Verbindung und die zugeordnete Tür in UniFi. Teste die Regel anschließend mit einer neuen Buchung.
Remote Open wird nicht angezeigt
Remote Open wird nicht angezeigt
Prüfe den gültigen Zugangszeitraum und die Türzuordnung. Bei Community-Zugängen muss Remote Open zusätzlich in den Community-Berechtigungen aktiviert sein.