> ## 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. # EVVA AirKey mit anny verbinden > Erstelle pro Buchung automatisch einen App-Zugang für EVVA-gesicherte Türen, zeitlich begrenzt und ohne Schlüsselübergabe. [EVVA AirKey](https://www.evva.com/de-de/produkte/elektronische-schliesssysteme-zutrittskontrolle/airkey/) ist ein elektronisches Schließsystem, das Türen per Smartphone-App steuert. Mit der Integration erstellt anny pro Buchung automatisch einen zeitlich begrenzten App-Zugang für die passende EVVA-gesicherte Tür. Mit EVVA AirKey kannst du in anny: * Pro Buchung automatisch einen zeitlich begrenzten App-Zugang für EVVA-gesicherte Bereiche erstellen * anny-Ressourcen über Regeln mit einem oder mehreren EVVA-Schlössern verknüpfen * Kund:innen ohne Registrierung oder Schlüsselübergabe Zutritt gewähren Besonders praktisch ist die Integration, wenn du EVVA-gesicherte Räume über anny buchbar machst und den Zugang vollständig automatisieren möchtest, ohne manuelle Freigabe oder Schlüsselkoordination. Verfügbar ab dem Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Meetingräume automatisch freischalten | **Zugang genau zum gebuchten Zeitpunkt.** Wird ein Meetingraum gebucht, erhält die buchende Person kurz vor Beginn per E-Mail den Link zur EVVA-App. Der Raum lässt sich dann im gebuchten Zeitfenster öffnen. | | Coworking- und Studioflächen | **Schlüsselloser Zutritt ohne Rezeption.** Kund:innen betreten gebuchte Flächen eigenständig per App, ohne dass das Team manuell freigeben muss. | | Buchungen mit wechselnden Nutzer:innen | **Automatische Zuordnung über Handynummer.** Jede buchende Person bekommt ihren eigenen Zugang, zeitlich passend erstellt und nach Ende wieder entfernt. | ## Wie die EVVA AirKey-Verbindung funktioniert Die Verbindung wird über einen API-Key hergestellt. Du erstellst den Key im EVVA-Adminbereich und hinterlegst ihn in anny. Damit authentifiziert sich anny bei deinem EVVA AirKey Cloud-Zugang und darf dort Zugänge anlegen und entfernen. Sobald eine Ressource mit passender Regel gebucht wird, plant anny einen Zugang für genau diese Buchung ein und schreibt ihn erst etwa 30 Minuten bevor der Zugang gültig wird an das passende Schloss. Die Zuordnung zur buchenden Person erfolgt über die hinterlegte Handynummer. Beim Schreiben verschickt EVVA an neue Gäste eine E-Mail mit dem Link zur Einrichtung in der EVVA-App. Wer bereits ein aktiviertes AirKey-Medium hat, bekommt keine neue E-Mail und nutzt den bestehenden App-Zugang. Der Zugang wird bewusst erst kurz vor Zugangsbeginn beim Schloss angelegt, nicht schon beim Buchen. Das ist kein Fehler, sondern Teil der Integrationslogik. Bei weit im Voraus liegenden Terminen ist der Zugang deshalb erst kurz vorher sichtbar. Wenn du den API-Key widerrufst oder änderst, verliert anny den Zugriff und kann keine neuen Zugänge erstellen. Aktualisiere in diesem Fall den Key in der Integration. | Daten | Richtung | Häufigkeit | | ------------------------------ | -------------- | ------------------------------------------------------ | | Zugänge (Erstellen, Entfernen) | anny → EVVA | Etwa 30 Minuten vor Zugangsbeginn bzw. bei Stornierung | | Benachrichtigung (E-Mail) | EVVA → Kund:in | Beim Erstellen des Zugangs, nur für neue Gäste | ## EVVA AirKey verbinden ### Voraussetzungen Bevor du EVVA AirKey verbindest, stelle sicher, dass du Folgendes hast: * Einen aktiven EVVA AirKey Cloud-Zugang mit eingerichteten Schlössern und Bereichen * Einen API-Key aus dem EVVA-Adminbereich (unter **Einstellungen** → **Allgemein** → **AirKey Cloud Interface (API)** → **Key erstellen**) * Admin-Rechte mit Zugriff auf die **Integrationen** in anny * Eine Buchungsoption, bei der die Handynummer im Formular abgefragt wird ### Verbindung einrichten Öffne aus der **Menüleiste** die **Integrationen** und wähle **EVVA AirKey**. Erstelle im EVVA-Adminbereich unter **Einstellungen** → **Allgemein** → **AirKey Cloud Interface (API)** einen neuen API-Key. Kopiere den Key und füge ihn in anny im Feld **API-Key** ein. Klicke auf **Speichern**. Verknüpfe über eine **Regel** eine anny-Ressource mit einem oder mehreren EVVA-**Bereichen** (Schlössern): 1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen. 2. Wähle die **Ressource** aus, die bei Buchung Zugang geben soll. 3. Wähle die zugehörigen **Bereiche** aus, zu denen Zugang gewährt wird. 4. Lege über **Zugang vor der Buchung** und **Zugang nach der Buchung** fest, wie lange vor und nach der Buchung der Zugang gültig ist. Pro Ressource ist nur eine Regel möglich. Eine Regel auf einer übergeordneten Ressource greift auch für Buchungen ihrer Unterressourcen.  Gehe zu **Ressourceneinstellungen** → **Buchungsoption bearbeiten** → **Formular** und aktiviere **Handynummer immer abfragen**. Aktiviere dies für alle betroffenen Ressourcen, bevor du die Regel speicherst, sonst lässt sich die Regel nicht sichern. Ohne Handynummer kann kein Zugang zugeordnet werden. Prüfe in den **Integrationen**, ob EVVA AirKey als aktiv angezeigt wird. Lege eine Testbuchung an und prüfe, ob der Zugang kurz vor Zugangsbeginn erstellt wird. Sobald die Verbindung aktiv ist und eine Regel greift, erstellt anny bei jeder passenden Buchung automatisch kurz vor Beginn einen App-Zugang. Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen. ### Einstellungen & Optionen | Einstellung | Beschreibung | | ----------------------- | --------------------------------------------------------------------------------- | | Zugang vor der Buchung | Minuten vor Buchungsbeginn, ab denen der Zugang aktiv ist. | | Zugang nach der Buchung | Minuten nach Buchungsende, bis zu denen der Zugang aktiv bleibt. | | Handynummer im Formular | Muss aktiviert sein, damit die buchende Person dem Zugang zugeordnet werden kann. | ### Zugänge im Adminbereich einsehen In der **Buchungsdetailansicht** siehst du unter **Smartlock Zugänge** aktive und vergangene Zugänge. Für jeden Zugang siehst du: | Information | Beschreibung | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Status | **Geplant** (angelegt, wird kurz vor Einsatz erstellt), **Erfolgreich** (Zugang aktiv), **Fehlgeschlagen** (Erstellen fehlgeschlagen), **Aufräumen** (wird gelöscht) oder **Entfernt** (Zugang widerrufen). | | Zugang beginnt am / Zugang endet am | Zeitfenster, in dem der Zugang gültig ist. | | Türschloss | Der verknüpfte EVVA-Bereich. | | Erstellt am | Wann der Zugang angelegt wurde. | Über die **drei Punkte** am Zugang kannst du zu den Integrationseinstellungen navigieren. ## Einschränkungen Die EVVA AirKey-Integration unterstützt nicht: * PIN-Code-Zugang: Es wird ausschließlich der App-Zugang über die EVVA-App unterstützt. * Remote Open (Fernöffnung): Es gibt keinen Button zum Öffnen aus anny heraus. * Sofortigen Zugang nach Buchung: Der Zugang wird erst kurz vor Zugangsbeginn erstellt. * Communities: Zugänge lassen sich nur über Buchungen vergeben, nicht über Community-Mitgliedschaften. ## 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 Der Zugang wird geplant, sobald die Buchung feststeht, und erst etwa 30 Minuten vor Zugangsbeginn beim Schloss angelegt. Bei Serienbuchungen plant anny jeden Termin erst etwa 48 Stunden vorher ein. Das späte Anlegen ist beabsichtigt und Teil der Integrationslogik. EVVA versendet die E-Mail mit dem Link zur Einrichtung des Zugangs, wenn anny den Zugang anlegt, also etwa 30 Minuten vor Zugangsbeginn. Neue Gäste bekommen den Registrierungslink, Gäste mit bereits aktiviertem AirKey-Medium nutzen ihren bestehenden App-Zugang. Die Zuordnung des Zugangs zur buchenden Person läuft über die Handynummer. Fehlt sie oder ist sie nicht im erwarteten Format hinterlegt, kann anny den Zugang nicht zuordnen. Nein. Kund:innen müssen sich nicht bei EVVA registrieren. Die Einrichtung läuft über den Link in der E-Mail und die EVVA-App. Ja. Pro Regel kannst du eine Ressource mit einem oder mehreren EVVA-Bereichen verknüpfen. ## Troubleshooting Das ist in den meisten Fällen erwartetes Verhalten. Der Zugang wird bewusst erst etwa 30 Minuten vor Zugangsbeginn beim Schloss angelegt. Bei Serienbuchungen erscheint der Zugang für einen Termin erst etwa 48 Stunden vorher. Warte bis kurz vor dem Buchungszeitpunkt und prüfe dann erneut. Prüfe zuerst, ob die Ressource korrekt einem EVVA-Bereich zugeordnet ist. Kontrolliere dann, ob für die buchende Person eine gültige Handynummer hinterlegt ist. Ohne beides kann anny den Zugang nicht erstellen. EVVA AirKey unterstützt ausschließlich App-Zugang. Ein fehlender PIN ist kein Fehler, sondern Teil des vorgesehenen Flows. Weise Kund:innen auf die EVVA-App hin. > Wichtige Informationen für Agenten: > > UI-Pfad Einrichten: Menüleiste → Integrationen → EVVA AirKey → API-Key eintragen → Speichern. Regel-Editor: Regel „Zugang durch Buchungen" → Hinzufügen. Felder: Ressource, Bereiche auswählen, Zugang vor der Buchung, Zugang nach der Buchung. Regel-Spalten: Ressource, Schlösser, Zugang vor der Buchung, Zugang nach der Buchung. Verbindung trennen: Integrationen → EVVA AirKey → Toggle oben rechts deaktivieren → drei Punkte → Löschen. > > Authentifizierung: API-Key (nicht OAuth). Key in EVVA unter Einstellungen → Allgemein → AirKey Cloud Interface (API) → Key erstellen. > > Zugangserstellung: Just in time. Zugang wird bei Buchung als „Geplant" angelegt und erst ca. 30 Minuten vor Zugangsbeginn (= Buchungsbeginn minus „Zugang vor der Buchung") beim Anbieter geschrieben. Der oft genannte Grund „pro Schloss nur 1 Zugang gleichzeitig" ist nicht bestätigt; mehrere Berechtigungen pro Bereich können koexistieren. > > Serien-/wiederkehrende Buchungen: jeder Termin wird erst ca. 48 h vor Zugangsbeginn eingeplant; vorher kein Zugangsdatensatz sichtbar. Einzelbuchungen: Datensatz sofort (Status „Geplant"). > > Benachrichtigung: EVVA „Send a Key" per E-Mail beim Schreiben des Zugangs. Nur für neue/nicht aktivierte Handynummern; Gäste mit aktiviertem AirKey-Medium bekommen keine neue E-Mail. SMS aus anny-Code nicht belegt. > > Zuordnung: Person → Handynummer → Zugang. Ohne Handynummer kein Zugang. „Handynummer immer abfragen" wird beim Speichern erzwungen: fehlt sie an einem Service einer verregelten Ressource, schlägt das Speichern fehl. > > Kein PIN-Code, kein Remote Open, keine Community-Regeln. Nur App-Zugang über Buchungen. > > Nur akzeptierte Buchungen erhalten Zugang (keine Anfragen/Blocker). Storno/Ablehnung → entfernt; Zeitänderung → Zeitraum aktualisiert; Ressourcenwechsel → neu erstellt; Blocker↔Buchung → erstellt/entfernt. > > Eine Regel pro Ressource (Speichern sonst blockiert). Regel auf übergeordneter Ressource greift auch für Unterressourcen. Mehrere Bereiche pro Regel möglich. > > Buchungsdetail-Bereich „Smartlock Zugänge". Felder: Status, Zugang beginnt am, Zugang endet am, Türschloss, Erstellt am. Zugangsstatus: Geplant | Erfolgreich | Fehlgeschlagen | Aufräumen | Entfernt (auch möglich: In Bearbeitung, Unbestätigt, Nicht autorisiert). Kein Anbieter-Deep-Link am Zugang, nur Sprung zu den Integrationseinstellungen. > > Feature INTEGRATIONS\_SMART\_LOCKS, verfügbar ab Professional-Plan (DB-seitig, nicht code-verifiziert). Verwandte Artikel: Smart-Locks Übersicht, Glutz eAccess, Nuki, Salto KS.