- 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
Verfügbar ab dem Professional-Plan.
Typische Anwendungsfälle
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. 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.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
1
Integration öffnen
Öffne aus der Menüleiste die Integrationen und wähle EVVA AirKey.
2
Autorisieren
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.
3
Konfigurieren
Verknüpfe über eine Regel eine anny-Ressource mit einem oder mehreren EVVA-Bereichen (Schlössern):
- Klicke auf Hinzufügen, um eine neue Regel zu erstellen.
- Wähle die Ressource aus, die bei Buchung Zugang geben soll.
- Wähle die zugehörigen Bereiche aus, zu denen Zugang gewährt wird.
- Lege über Zugang vor der Buchung und Zugang nach der Buchung fest, wie lange vor und nach der Buchung der Zugang gültig ist.
4
Handynummer im Formular aktivieren
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.
5
Verbindung prüfen
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.
Einstellungen & Optionen
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:
Ü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
Beides findest du unter Integrationen: Deaktivieren über den Toggle oben rechts, Löschen über die drei Punkte → Löschen.FAQ
Wann genau wird der Zugang erstellt?
Wann genau wird der Zugang erstellt?
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.
Wann erhalten Kund:innen die Benachrichtigung?
Wann erhalten Kund:innen die Benachrichtigung?
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.
Warum ist die Handynummer so wichtig?
Warum ist die Handynummer so wichtig?
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.
Brauchen Kund:innen ein EVVA-Konto?
Brauchen Kund:innen ein EVVA-Konto?
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.
Kann ich mehrere Schlösser pro Ressource freischalten?
Kann ich mehrere Schlösser pro Ressource freischalten?
Ja. Pro Regel kannst du eine Ressource mit einem oder mehreren EVVA-Bereichen verknüpfen.
Troubleshooting
Vor dem Buchungsstart ist noch kein Zugang sichtbar
Vor dem Buchungsstart ist noch kein Zugang sichtbar
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.
Kund:in erhält keinen nutzbaren Zugang
Kund:in erhält keinen nutzbaren Zugang
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.
Kund:in sucht nach einem PIN-Code
Kund:in sucht nach einem PIN-Code
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.