> ## 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. # Tapkey mit anny verbinden > Vergib bei jeder Buchung automatisch App-Zugänge für deine Tapkey-Schlösser und spare dir die Schlüsselübergabe. [Tapkey](https://www.tapkey.com/) ist ein Smart-Lock-System, das Türschlösser über eine App per Smartphone steuert. Mit der Integration vergibt anny bei Buchungen automatisch Zugangsrechte in der Tapkey App, sodass Kund:innen das Schloss im gebuchten Zeitraum öffnen können. Mit tapkey kannst du in anny: * Buchungsbasierte Zugänge mit Zeit vor und nach der Buchung automatisch erstellen * Mehrere Schlösser mit einer Ressource verknüpfen (oder umgekehrt) * Den Zugangsstatus direkt in der Buchung einsehen Besonders praktisch ist die Integration für kleine Coworking-Spaces und Büros, die ihren Kund:innen einen schlüssellosen Zugang per App ermöglichen möchten. Verfügbar ab Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Coworking-Räume per App öffnen | **Kund:innen erhalten nach der Buchung automatisch Zugangsrechte in der Tapkey App.** Kein Schlüssel, kein Code: Das Smartphone reicht. | | Büroräume mit Zeitfenster absichern | **Der Zugang ist exakt auf den Buchungszeitraum begrenzt.** Nach Ablauf wird die Berechtigung automatisch entfernt, ohne dass du eingreifen musst. | | Mehrere Türen pro Buchung freischalten | **Du kannst mehrere Schlösser mit einer Ressource verknüpfen.** So erhalten Kund:innen z. B. Zugang zum Haupteingang und zum gebuchten Raum in einem Schritt. | ## Wie die tapkey-Verbindung funktioniert Die Integration nutzt OAuth: Du meldest dich mit deinem Tapkey-Besitzerkonto an und autorisierst anny, Zugangsrechte für deine Schlösser zu vergeben und zu entfernen. anny erstellt bei jeder Buchung eine Berechtigung in der Tapkey Cloud, die dem/der Kund:in über die E-Mail-Adresse zugewiesen wird. Kund:innen öffnen das Schloss anschließend über die Tapkey App. Es wird kein separater Zugangslink und kein Pin versendet. Wenn du die Autorisierung in deinem Tapkey-Konto widerrufst, verliert anny den Zugriff. Du musst die Integration in anny dann erneut autorisieren. | Daten | Richtung | Häufigkeit | | ----------------------------------- | ------------- | ------------------------------------------------------- | | Zugangsrechte (erstellen/entfernen) | anny → Tapkey | Bei Buchung/Stornierung; Serientermine etwa 48 h vorher | | Schlösser (Liste) | Tapkey → anny | Bei Regelkonfiguration | Bei Einzelbuchungen wird der Zugang sofort erstellt. Bei Serien- und wiederkehrenden Buchungen plant anny den Zugang pro Termin etwa 48 Stunden vorher ein. Bis dahin steht er auf dem Status **Geplant**. ## tapkey verbinden ### Voraussetzungen Bevor du Tapkey verbindest, stelle sicher, dass du Folgendes hast: * Ein Tapkey-Besitzerkonto mit mindestens einem eingerichteten Schloss * Das Schloss ist im [Tapkey Adminbereich](https://my.tapkey.com/) hinterlegt und online * anny Professional-Plan oder höher ### Verbindung einrichten Öffne aus der Menüleiste die **Integrationen** und gehe zu **Tapkey**. Klicke auf **Autorisieren** und melde dich mit deinem **Tapkey-Besitzerkonto** an. Damit gibst du anny die Berechtigung, Zugangsrechte für deine Schlösser zu verwalten. Lege deine Besitzerkonten und Regeln fest: 1. Wähle über **Besitzerkonto hinzufügen** das Tapkey-Besitzerkonto aus, für das du Regeln anlegen möchtest 2. Prüfe unter **Zeitzone auswählen**, welche Zeitzone Tapkey für die Zugangszeiträume verwendet 3. Klicke auf **Regel hinzufügen**, um eine neue Regel zu erstellen 4. Wähle die **Ressource** aus, die bei Buchung Zugang geben soll 5. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus 6. Lege **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (Minuten vor und nach der Buchung) Sobald die Verbindung aktiv ist, werden Zugangsrechte automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt. Du kannst mehrere Schlösser mit einer Ressource verknüpfen oder ein Schloss mit mehreren Ressourcen. Bestehende Regeln bearbeitest du direkt in der Liste. Zum Löschen nutzt du das Löschsymbol neben der Regel und bestätigst. ### Einstellungen & Optionen | Einstellung | Beschreibung | | ----------------------- | ------------------------------------------------------- | | Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist | | Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt | | Zylinder auswählen | Ein oder mehrere Tapkey-Schlösser pro Regel | | Zeitzone | Zeitzone, die Tapkey für die Zugangszeiträume verwendet | ## Buchungsprozess für Kund:innen So erleben deine Kund:innen die Integration: Kund:innen buchen eine Ressource über anny. anny erstellt automatisch eine Berechtigung in der Tapkey Cloud. Kund:innen erhalten eine Buchungsbestätigung per E-Mail. Kund:innen melden sich in der **Tapkey App** mit ihrer E-Mail-Adresse an. Dort sehen sie, auf welche Schlösser sie Zugriff haben und für welche Zeitfenster. Per Tap auf das Schloss wird die Tür geöffnet. Kund:innen benötigen die Tapkey App (iOS/Android). Der Download-Link kann in der Buchungsbestätigung hinterlegt werden. ## Zugänge im Adminbereich einsehen Im Bereich **Smartlock Zugänge** einer Buchung werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details wie **Zugang beginnt am**, **Zugang endet am**, **Türschloss** und **Erstellt am** einzusehen: | Status | Bedeutung | | -------------- | --------------------------------------------------------------------------------------------------------- | | In Bearbeitung | Der Zugang wurde von anny angefordert, aber noch nicht vom Schließsystem bestätigt | | Geplant | Die Erstellung ist geplant (Serien- und zukünftige Termine); der Zugang wird kurz vor dem Termin erstellt | | Erfolgreich | Der Zugang ist aktiv und Kund:innen können das Schloss im definierten Zeitraum öffnen | | Fehlgeschlagen | Der Zugang konnte nicht erstellt werden, zum Beispiel weil ein Limit erreicht ist | | Entfernt | Der Zugang wurde vom System oder einer Person entfernt | Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang über **Zugang beim Anbieter anzeigen** direkt in Tapkey öffnen oder über **Integrationseinstellungen** zu den Einstellungen in anny navigieren. ## Einschränkungen Die tapkey-Integration unterstützt nicht: * Remote Open (Türöffnung direkt aus anny heraus): Kund:innen öffnen das Schloss ausschließlich über die Tapkey App * Community-Zugänge: Der Zugang wird ausschließlich buchungsbasiert vergeben, Community-Mitglieder erhalten keinen automatischen Zutritt * Zugangslink per E-Mail: Der Zugang funktioniert ausschließlich über die Tapkey App, nicht über einen Browser-Link * Mehr als zehn gleichzeitige Berechtigungen pro Schloss: Tapkey-Schlösser verwalten maximal zehn gleichzeitige Berechtigungen. Ist das Limit erreicht, kann anny keine weitere anlegen. Auch Berechtigungen, die du selbst in Tapkey erstellt hast, zählen mit. ## 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 Alle kompatiblen Schlösser findest du im [Tapkey Shop](https://shop.tapkey.com/de/products/tapkey-smart-lock). Tapkey bietet nachrüstbare Smart-Lock-Zylinder, die sich per DIY installieren lassen. Ja. Der Zugang funktioniert ausschließlich über die Tapkey App (iOS und Android). Kund:innen melden sich dort mit der E-Mail-Adresse an, die sie bei der Buchung verwendet haben. Bei Stornierung der Buchung wird das Zugangsrecht automatisch entfernt. Kund:innen sehen das Schloss dann nicht mehr in ihrer Tapkey App. Tapkey-Schlösser verwalten maximal zehn gleichzeitige Berechtigungen. Dazu zählen auch Berechtigungen, die du selbst in Tapkey erstellt hast. Ist das Limit absehbar erreicht, kann ein kürzerer Vorausbuchungszeitraum helfen, die Anzahl gleichzeitiger Zugänge zu senken. Ja. Tapkey arbeitet mit Abo-Modellen für Nutzer-Berechtigungen. Der kostenlose Tarif erlaubt nur fünf gleichzeitige Smartphone-Nutzer:innen. Informiere dich bei Tapkey über die Kosten für dein erwartetes Buchungsvolumen. ## Troubleshooting Die Berechtigung wurde möglicherweise nicht erstellt. Prüfe im Bereich **Smartlock Zugänge** der Buchung den Status. Stelle außerdem sicher, dass die E-Mail-Adresse in der Buchung mit der in der Tapkey App übereinstimmt. Wahrscheinlich ist ein Tapkey-Limit erreicht: entweder die maximal zehn gleichzeitigen Berechtigungen pro Schloss oder das Nutzerkontingent deines Tapkey-Tarifs. Entferne nicht mehr benötigte Berechtigungen in Tapkey oder erweitere deinen Tapkey-Tarif. Prüfe die Einstellung **Zeitzone auswählen** in der Integration. Weicht sie von der in Tapkey hinterlegten Zeitzone ab, verschieben sich die Zeitfenster der Zugänge. Die OAuth-Verbindung zu Tapkey kann ablaufen. Gehe zu **Integrationen** → **Tapkey** und klicke erneut auf **Autorisieren**, um die Verbindung wiederherzustellen. > Wichtige Informationen für Agenten: > > UI-Pfad: Menüleiste → Integrationen → Tapkey. Ablauf: erst **Besitzerkonto hinzufügen** (mehrere möglich), optional **Zeitzone auswählen**, dann je Besitzerkonto **Regel hinzufügen**. Regelfelder: **Ressource auswählen**, **Zylinder auswählen** (mehrere Schlösser möglich), **Zugang vor der Buchung**, **Zugang nach der Buchung**. Es gibt KEIN Pin- und KEIN App-Einladungs-Feld; der Zugang ist immer eine Smartphone-App-Berechtigung. > > Auth: OAuth über das Tapkey-Besitzerkonto (kein API-Key). Zuordnung des Zugangs über die E-Mail-Adresse der Buchung. > > Zeitpunkt der Erstellung: Einzelbuchungen sofort; Serien-/wiederkehrende Buchungen werden pro Termin etwa 48 h vorher erstellt (Status **Geplant**). Nur bestätigte Buchungen lösen Zugänge aus; Anfragen, Ablehnungen, Stornos und interne Blocker nicht. Änderungen an Zeit/Ressource/Status aktualisieren oder entfernen den Zugang automatisch. Regeln vererben auf Unterressourcen. Pro Ressource ist nur eine Regel möglich (Speichern blockiert bei Dublette). > > Status-Labels (Bereich **Smartlock Zugänge** einer Buchung): In Bearbeitung, Geplant, Unbestätigt, Erfolgreich, Fehlgeschlagen, Aufräumen, Entfernt, Nicht autorisiert. Detailfelder: Zugang beginnt am, Zugang endet am, Türschloss, Erstellt am, Zugang durch, Status. Aktionen: **Zugang beim Anbieter anzeigen** (öffnet my.tapkey.com), **Integrationseinstellungen**. > > Limits: max. zehn gleichzeitige Berechtigungen pro Schloss (inkl. selbst in Tapkey erstellter); kostenloser Tapkey-Tarif max. fünf gleichzeitige Smartphone-Nutzer:innen. Beide Hinweise erscheinen als Infobox in der Integration. > > Kein Remote Open (in anny nicht implementiert). Community-Zugänge werden für Tapkey NICHT unterstützt: kein Community-Regel-Editor, kein Backfill-Button „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". > > Verbindung trennen: Deaktivieren behält bestehende Zugänge, erstellt keine neuen. Löschen entfernt die anny-Zugangsdatensätze und Ressourcen-Verknüpfungen, widerruft die Berechtigungen aber nicht aktiv bei Tapkey; bereits erstellte Berechtigungen können bis zu ihrem eigenen Ablauf am Schloss aktiv bleiben. > > Beziehung: Teil der anny Smart-Lock-Integrationen (Feature INTEGRATIONS\_SMART\_LOCKS), gemeinsames Access-Control-System mit u. a. Nuki, Salto, Iloq. Offizielle Schreibweise der Marke: „Tapkey".