> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.
# KleverKey mit anny verbinden
> Automatisiere zeitlich begrenzte, schlüssellose Zutritte für Buchungen und Community-Mitglieder.
[KleverKey](https://www.kleverkey.com/) ist ein Smart-Lock-System für digitale und zeitlich gesteuerte Türzugänge. Mit der Integration erstellt anny automatisch passende Zutrittsrechte für Buchungen und Communities.
Mit KleverKey kannst du in anny:
* digitale Gastzugänge für Buchungen erstellen
* Ressourcen und Communities mit einem oder mehreren Schlössern verbinden
* Türen per Zugangslink oder Remote Open ohne zusätzlichen KleverKey Account öffnen
Besonders praktisch ist die Integration für Teams, die Räume ohne Schlüsselübergabe und zusätzlichen Vor-Ort-Aufwand bereitstellen.
Verfügbar ab dem Professional-Plan.
## Typische Anwendungsfälle
| Anwendungsfall | Beschreibung |
| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Räume nach einer Buchung öffnen | **Kund:innen erhalten automatisch einen zeitlich begrenzten Zugang.** Der Zugang gilt für das verknüpfte Schloss und den in der Regel festgelegten Zeitraum. |
| Community-Mitgliedern Zutritt geben | **Mitglieder erhalten Zugang zu gemeinsam genutzten Bereichen.** Du verknüpfst eine Community mit einem oder mehreren Schlössern. |
| Türen direkt über anny öffnen | **Remote Open öffnet ein berechtigtes Schloss per Knopfdruck.** Der Button erscheint auf der anny Homepage oder in der Buchungsansicht. |
## Wie die KleverKey-Verbindung funktioniert
anny authentifiziert die Verbindung über einen KleverKey API-Token und die Organisations-ID. Der Token erlaubt anny, Schlösser abzurufen und anhand deiner Regeln zeitlich begrenzte Gastzugänge zu erstellen.
Bei einer Buchung erstellt KleverKey einen individuellen digitalen Schlüssel. anny zeigt den Zugang in der Buchung an und kann ihn mit der Buchungsbestätigung versenden. Wird eine Buchung storniert, wird das zugehörige Zutrittsrecht entzogen. anny erstellt den Zugang nur für angenommene Buchungen. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen.
| Daten | Richtung | Häufigkeit |
| -------------------------------- | ---------------- | ------------------------------------------------------- |
| Schlösser und Organisationsdaten | KleverKey → anny | Beim Einrichten und Aktualisieren der Verbindung |
| Buchungsbezogene Zutrittsrechte | anny → KleverKey | Bei Erstellung, Änderung oder Stornierung einer Buchung |
| Zugangslink und Zugangsdetails | KleverKey → anny | Als Antwort beim Erstellen oder Ändern eines Zugangs |
Wenn der API-Token widerrufen oder ersetzt wird, kann anny keine neuen Zugänge erstellen, bis du die Verbindung mit einem gültigen Token aktualisierst.
## KleverKey verbinden
### Voraussetzungen
Bevor du KleverKey verbindest, stelle sicher, dass du Folgendes hast:
* einen eingerichteten KleverKey Account mit mindestens einem funktionsfähigen Schloss
* aktivierte Gastzutritte in den KleverKey Organisationseinstellungen
* einen KleverKey API-Token und deine Organisations-ID
* den Professional-Plan in anny
### Verbindung einrichten
Öffne aus der Menüleiste **Integrationen** und gehe zu **KleverKey**. Trage deinen [API-Token](https://portal.kleverkey.com/account/api-keys) und die [Organisations-ID](https://portal.kleverkey.com/organization/settings) ein. Wähle außerdem die **Zeitzone**, in der die Zugangszeiten gelten sollen. Standard ist die Zeitzone deiner Organisation.
Lege anschließend deine Zugangsregeln fest:
1. Klicke im Bereich für Buchungs- oder Community-Regeln auf **Hinzufügen**.
2. Wähle die Ressource oder Community aus.
3. Ordne ein oder mehrere KleverKey Schlösser zu.
4. Lege bei Buchungsregeln fest, wie lange der Zugang vor und nach der Buchung gelten soll.
5. Aktiviere bei Bedarf **Zusätzliche Einladungen von KleverKey versenden** oder **Fernöffnung**.
Sobald die Verbindung aktiv ist, erstellt anny anhand der Regeln automatisch passende KleverKey Zugänge.
Das [Video zur KleverKey-Einrichtung](https://www.loom.com/share/707db5b54f7d47b0a7bc5f78eaf1d5df) zeigt den vollständigen Ablauf im KleverKey Portal und im anny Admin-Bereich.
Du kannst mehrere Schlösser mit einer Ressource verbinden oder dasselbe Schloss mehreren Ressourcen zuordnen.
### Einstellungen & Optionen
| Einstellung | Funktion |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Ressource | Bestimmt, bei welcher Buchung ein Zutrittsrecht erstellt wird. |
| Community | Gibt Mitgliedern der ausgewählten Community Zugang zu den zugeordneten Schlössern. |
| Schlösser | Legt fest, welche Türen mit der Regel geöffnet werden können. |
| Zugang vor der Buchung | Erweitert den Zugangszeitraum vor der gebuchten Zeit. |
| Zugang nach der Buchung | Erweitert den Zugangszeitraum nach der gebuchten Zeit. |
| Zusätzliche Einladungen von KleverKey versenden | Lässt KleverKey zusätzlich eine eigene Einladungs-E-Mail mit dem Zugangslink verschicken. |
| Fernöffnung (Remote Open) | Erlaubt berechtigten Kund:innen, das Schloss direkt über anny zu öffnen. Der Toggle heißt **Fernöffnung verwenden**. |
Bestehende Regeln kannst du über die **drei Punkte** bearbeiten oder löschen.
### Remote Open
Mit Remote Open können Kund:innen berechtigte Türschlösser per Knopfdruck öffnen. Der Zugang erscheint für heutige Buchungen und Community-Berechtigungen auf der anny Homepage sowie in den Buchungsdetails.
| Ort | Wo öffnest du die Tür? |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| E-Mail | Der Link **Öffnen** in der Buchungsbestätigung führt in den Browser. Dort erscheint der Button **Tür entriegeln**. |
| anny App | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung unter **Meine Buchungen**. |
| Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung unter **Meine Buchungen**. |
Für Remote Open über eine Community aktivierst du die Funktion in den Community-Berechtigungen der Smart-Lock-Integration.
### Zugänge prüfen
Öffne eine Buchung und wähle den zugehörigen Smart-Lock-Zugang aus. Dort siehst du Status, Zugriffszeitraum, Türschloss, Erstellungsdatum und Zugangslink.
| Status | Bedeutung |
| -------------- | ----------------------------------------------------------------------------------------------------------------- |
| In Bearbeitung | anny hat den Zugang angefordert, KleverKey hat ihn aber noch nicht erstellt. |
| Geplant | Bei Serienbuchungen plant anny den Zugang und erstellt ihn kurz vor Beginn des jeweiligen Termins. |
| Erfolgreich | Der Zugang ist aktiv und kann im angezeigten Zeitraum genutzt werden. |
| Entfernt | Das System oder ein:e Admin-Nutzer:in hat den Zugang entfernt. Das Schloss kann damit nicht mehr geöffnet werden. |
Das [Video zum Buchungsablauf](https://www.loom.com/share/ed44e7768f13451392cf0da986e5f67a) zeigt, wie Kund:innen den digitalen Schlüssel nach der Buchung verwenden.
## Einschränkungen
Die KleverKey-Integration unterstützt nicht:
* Zugänge ohne aktivierte Gastzutritte im KleverKey Account
* die Erstellung neuer Zugänge mit einem widerrufenen oder ungültigen API-Token
* Zugänge außerhalb des in der Regel definierten Zeitraums
* mehr als eine Buchungsregel für dieselbe Ressource
* eine Statusabfrage am Schloss: anny sendet Zugänge, fragt aber den Live-Zustand des Schlosses nicht ab
Die Anzahl der Gastzugänge ist laut KleverKey nicht begrenzt. Hardwarepreise und verfügbare Schlossmodelle können sich ändern. Prüfe aktuelle Angaben direkt im [KleverKey Shop](https://www.kleverkey.com/shop).
## Verbindung trennen
Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.
## FAQ
Nein. Ein individueller Gastzugangslink kann das Schloss ohne zusätzlichen KleverKey Account öffnen.
Ja. Eine Regel kann mehrere Schlösser enthalten. Du kannst ein Schloss außerdem mehreren Ressourcen zuordnen.
anny entzieht das mit der Buchung verknüpfte Zutrittsrecht, sobald die Stornierung verarbeitet wurde.
Öffne die Buchungsdetails und wähle den Smart-Lock-Zugang aus. Dort findest du Status, Zeitraum, Schloss und Zugangslink.
anny kann den Link in der Buchungsbestätigung senden. Optional versendet KleverKey eine zusätzliche E-Mail mit demselben Link.
## Troubleshooting
Prüfe nacheinander:
1. Die KleverKey-Integration ist aktiv.
2. Der API-Token und die Organisations-ID sind gültig.
3. Gastzutritte sind im KleverKey Account aktiviert.
4. Für die gebuchte Ressource besteht eine Regel mit mindestens einem Schloss.
KleverKey hat den von anny angeforderten Zugang noch nicht bestätigt. Öffne den Zugang in den Buchungsdetails und prüfe über die **drei Punkte** die zugehörige Verbindung in KleverKey.
Prüfe, ob **Remote Open** in der Integration aktiviert ist und aktuell ein gültiger Zugang besteht. Für Community-Zugänge muss die Funktion zusätzlich in den Community-Berechtigungen aktiviert sein.
> Wichtige Informationen für Agenten:
>
> **Einordnung:** KleverKey ist eine Smart-Lock-Integration (Zutritt), gemeinsame Basis mit den anderen Smart-Lock-Integrationen (Salto KS, Nuki, Comydo, UniFi Access, Key Cafe). Freischaltung über das Feature INTEGRATIONS\_SMART\_LOCKS (Plan-Zuordnung „ab Professional" liegt in der Datenbank, aus dem Code nicht final verifizierbar).
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **KleverKey**. Auth-Felder: „KleverKey API Token", „KleverKey Organisations ID", plus Zeitzone-Auswahl. Regeln im selben Bereich: „Zugang durch Buchungen" und „Zugang durch Communities". Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Terminologie (wichtig):** Adminseitig heißt die Fernöffnung „Fernöffnung verwenden" (Spalte „Fernöffnung"); kundenseitig zeigt anny das Badge „Remote Open" und den Button „Tür entriegeln". Der Zusatz-Mail-Toggle heißt „Zusätzliche Einladungen von KleverKey versenden". Padding-Felder heißen „Zugang vor der Buchung" / „Zugang nach der Buchung". Der Grant-Block in der Buchung heißt „Smartlock Zugänge". Statuswerte: In Bearbeitung, Geplant, Erfolgreich, Entfernt, Unbestätigt, Fehlgeschlagen, Nicht autorisiert.
>
> **Quirks:** (1) Nur angenommene Buchungen erhalten Zugänge; angefragte/abgelehnte/stornierte Buchungen und interne Blocker nicht. (2) Genau eine Buchungsregel pro Ressource (Speichern wird sonst abgelehnt); mehrere Schlösser pro Regel und ein Schloss für mehrere Ressourcen sind erlaubt. (3) Eine Regel auf einer übergeordneten Ressource greift auch für Unterressourcen; die spezifischere Regel hat Vorrang. (4) Serienbuchungen erhalten geplante Zugänge (Status „Geplant"), Erstellung kurz vor Beginn; Einzelbuchungen sofort. (5) Ändern der Schlösser/Ressource einer Regel aktualisiert bzw. entfernt zukünftige Zugänge automatisch. (6) Community-Regeln bieten die Aktion „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". (7) Keine Statusabfrage am Schloss und kein laufender Statussync. (8) Die gewählte Zeitzone bestimmt die Gültigkeitszeiten inkl. Vor-/Nachlauf.
>
> **Remote Open:** separater Zugang zusätzlich zum Link-Zugang. Button in App/Browser nur bei heute gültigem Zugang aktiv; Home-Seite listet ihn unter „Heutige Zugänge". Für Community-Zugänge muss die Fernöffnung in den Community-Berechtigungen aktiviert sein. In der Buchungsbestätigung erscheinen die Zugänge im Abschnitt „Schlüsselloser Zugang" mit dem Link „Öffnen".
>
> **Verbindung trennen:** Deaktivieren behält bestehende Zugänge und erstellt keine neuen; Löschen entfernt die lokal gespeicherten Zugänge. Hinweis für Support: Beim Löschen der gesamten Integration werden die einzelnen Links nicht aktiv aus KleverKey entfernt, sie laufen über ihr Zeitprofil aus (im Gegensatz zum Stornieren einer einzelnen Buchung, das den Link per API löscht).