> ## 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. # Custom Remote Open mit anny verbinden > Öffne eigene Türen, Tore und Schranken per Knopfdruck aus anny, auch ohne fertige Anbieter-Integration. Custom Remote Open ist die offene Variante der Fernöffnung: Statt ein bestimmtes Schließsystem anzubinden, hinterlegst du eine eigene **Endpunkt-URL**. Drückt eine berechtigte Person in anny den Öffnen-Button, schickt anny eine Anfrage an diese URL. Was danach passiert, entscheidet dein eigenes System. Mit Custom Remote Open kannst du in anny: * ein Schließsystem anbinden, für das es keine fertige Integration gibt * Kund:innen für ihre Buchungszeit einen Öffnen-Button geben * Community-Mitgliedern dauerhaften Zugang zu ausgewählten Geräten geben Besonders praktisch ist die Integration, wenn du Türen, Tore oder Schranken schon über eine eigene Steuerung öffnest und diese Steuerung nur noch mit deinen Buchungen verbinden möchtest. Verfügbar ab dem Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Eigene Schließsteuerung anbinden | **Ein vorhandenes System öffnet Türen, ohne dass anny den Hersteller kennen muss.** Du baust einen Endpunkt, der die Öffnung auslöst, und verbindest ihn mit deinen Ressourcen. | | Schranke am Parkplatz oder Hof | **Kund:innen öffnen die Schranke zur gebuchten Zeit selbst.** Die Öffnung ist an den Zeitraum der Buchung gebunden, inklusive Vor- und Nachlauf. | | Dauerzugang für Coworking-Mitglieder | **Mitglieder einer Community öffnen freigegebene Geräte dauerhaft.** Der Zugang gilt ohne Enddatum, solange die Mitgliedschaft besteht. | ## Wie die Custom-Remote-Open-Verbindung funktioniert Die Verbindung besteht aus zwei Angaben: der **Endpunkt-URL** deines Systems und einem **Endpunkt-Token**, den anny für dich erzeugt. anny sendet den Token bei jeder Anfrage als `Authorization: Bearer ` mit. Dein Endpunkt prüft den Token und löst die Öffnung aus. anny fragt dein System zu keinem anderen Zeitpunkt an. Es gibt keine Geräteliste, die anny abruft, und keine Statusabfrage am Schloss. Der einzige Kontakt ist die Öffnungsanfrage per Knopfdruck. Zutrittsrechte entstehen ausschließlich in anny. So läuft ein Zugang ab: 1. Eine Buchung wird angenommen. anny prüft, ob eine Regel die gebuchte Ressource abdeckt. 2. anny legt für jede Geräte-ID der Regel ein Zutrittsrecht mit dem Status **Erfolgreich** an. Dein System erhält dabei noch keine Anfrage. 3. Im gültigen Zeitraum sehen Kund:innen den Öffnen-Button in anny. 4. Beim Klick sendet anny die Anfrage an deine Endpunkt-URL und wertet die Antwort aus. Die Anfrage ist ein `POST` mit diesen Angaben: | Feld | Inhalt | | ------------------------ | -------------------------------------------------------------------------- | | `is_remote_open_request` | Immer `true`. Kennzeichnet die Anfrage als Öffnungsanfrage. | | `lock_id` | Die Geräte-ID aus der Regel, also das zu öffnende Gerät. | | `booking_number` | Die Buchungsnummer. Bei Zugängen über eine Community bleibt das Feld leer. | | `customer_name` | Der Name der Person, für die der Zugang erstellt wurde. | Den passenden Beispiel-Request zeigt anny direkt in den Einstellungen der Integration unter **Beispiel-Request**. Für den Erfolg zählt allein der Antwortstatus deines Endpunkts. Antwortet er erfolgreich, meldet anny die Öffnung als erfolgreich. Antwortet er mit einem Fehler oder ist er nicht erreichbar, sehen Kund:innen **Öffnen fehlgeschlagen**. Generierst du den Token neu, verliert der alte Token sofort seine Gültigkeit und alle Anfragen scheitern, bis dein Endpunkt den neuen Token kennt. ## Custom Remote Open verbinden ### Voraussetzungen Bevor du Custom Remote Open verbindest, stelle sicher, dass du Folgendes hast: * Admin-Rechte in deinem anny Account und den Professional-Plan * einen öffentlich erreichbaren Endpunkt in deinem System, der `POST`-Anfragen mit JSON annimmt und mit `https://` beginnt * eine Prüfung des Bearer-Tokens in deinem Endpunkt, damit niemand ohne Berechtigung öffnen kann * eine Logik, die anhand der übergebenen Geräte-ID das richtige Gerät öffnet * festgelegte Geräte-IDs, denn Kund:innen sehen diese ID als Namen des Türschlosses ### Verbindung einrichten Öffne aus der Menüleiste die **Integrationen** und gehe zu **Custom Remote Open**. Trage unter **Einstellungen** die **Endpunkt-URL** ein und speichere. Klicke danach auf **Token generieren** und kopiere den **Endpunkt-Token** sofort, denn anny zeigt ihn nur einmal an. Hinterlege den Token anschließend in deinem eigenen System. Sobald Endpunkt-URL und Token gespeichert sind, erscheinen die Bereiche für Regeln. Lege dort deine Zugangsregeln an: 1. Klicke unter **Zugang durch Buchungen** oder **Zugang durch Communities** auf **Hinzufügen**. 2. Wähle die **Ressource** oder die **Community** aus. 3. Trage unter **Geräte-IDs für Remote Open** eine oder mehrere IDs ein, zum Beispiel `Haupttür-1`. Bereits verwendete IDs schlägt anny zur Auswahl vor. 4. Lege bei Buchungsregeln fest, wie lange der **Zugang vor der Buchung** und der **Zugang nach der Buchung** gelten soll. 5. Speichere die Regel. 6. Aktiviere die Integration über den **Toggle** oben rechts. Sobald die Integration aktiv ist, erstellt anny für passende Buchungen und Community-Mitgliedschaften automatisch Zutrittsrechte mit Öffnen-Button. Teste die Verbindung mit einer eigenen Testbuchung auf der betroffenen Ressource. Öffne die Buchung, klicke auf **Schloss entsperren** und prüfe, ob dein System die Anfrage erhält. ### Einstellungen & Optionen | Einstellung | Funktion | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Endpunkt-URL | Die Adresse in deinem System, an die anny die Öffnungsanfrage sendet. Sie muss mit `http://` oder `https://` beginnen. | | Endpunkt-Token | Der von anny erzeugte Token für alle Anfragen dieser Verbindung. Über **Token neu generieren** tauschst du ihn aus. | | Ressource | Bestimmt, bei welcher Buchung ein Zutrittsrecht entsteht. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen. | | Community | Gibt allen Mitgliedern der Community Zugang zu den hinterlegten Geräten. | | Geräte-IDs für Remote Open | Die Kennungen, die anny als `lock_id` übergibt. Du vergibst sie frei. Kund:innen sehen die ID als **Türschloss** in der Buchung. | | Zugang vor der Buchung | Verschiebt den Beginn des Zugangs nach vorn, damit Kund:innen schon vorher öffnen können. | | Zugang nach der Buchung | Verlängert den Zugang über das Buchungsende hinaus. | Einen Schalter für die Fernöffnung gibt es hier nicht. Bei Custom Remote Open ist sie immer aktiv, denn die Integration kennt keine andere Zugangsmethode. Bestehende Regeln bearbeitest oder löschst du über die **drei Punkte**. Unter **Zugang durch Communities** findest du zusätzlich die Aktion **Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen**. Damit versorgst du Mitglieder, die der Community schon vor der Regel beigetreten sind. ### Remote Open Mit Remote Open öffnen Kund:innen ein freigegebenes Gerät per Knopfdruck, ohne App und ohne Konto beim Schließsystem. Der Button erscheint, sobald das Zutrittsrecht gültig ist, und verschwindet nach Ablauf des Zeitraums. | 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. | | Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung. | Als Admin-Nutzer:in öffnest du dasselbe Gerät in den Buchungsdetails über **Schloss entsperren**. Zugänge aus einer Community gelten dauerhaft und haben kein Enddatum. ## Einschränkungen Die Custom-Remote-Open-Integration unterstützt nicht: * **Geräteerkennung:** anny ruft keine Geräteliste ab. Du trägst die Geräte-IDs von Hand ein und musst sie in deinem System selbst zuordnen. * **Statusabfrage:** anny weiß nicht, ob eine Tür offen oder geschlossen ist. Es wird nur die Öffnungsanfrage gesendet. * **Andere Zugangsmethoden:** Es gibt keinen PIN-Code, keinen QR-Code, keinen Zugangslink und keine Anbieter-App. Ohne Öffnen-Button gibt es keinen Zugang. * **Automatische Wiederholung:** Schlägt eine Öffnung fehl, versucht anny es nicht erneut. Kund:innen müssen den Button noch einmal drücken. * **Mehrere Buchungsregeln pro Ressource:** Jede Ressource darf in nur einer Buchungsregel vorkommen, sonst lässt sich die Regel nicht speichern. * **Zugänge ohne Kund:in:** Interne Blocker und noch nicht angenommene Buchungen erhalten kein Zutrittsrecht. Alle Anfragen einer Verbindung gehen an dieselbe Endpunkt-URL und verwenden denselben Token. Die Unterscheidung zwischen mehreren Geräten läuft ausschließlich über die übergebene Geräte-ID. ## Verbindung trennen Wenn du die bestehenden Zutrittsrechte behalten möchtest, aber keine neuen erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration. In deinem eigenen System musst du danach nichts zurücknehmen, denn anny hinterlegt dort keine Berechtigungen. Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**. ## FAQ Jedes System, das sich über eine eigene Schnittstelle öffnen lässt. anny sendet nur eine Anfrage an deine Endpunkt-URL. Die eigentliche Öffnung steuerst du selbst, zum Beispiel über die Steuerung deiner Tür, deines Tors oder deiner Schranke. Du vergibst sie selbst. anny übergibt die eingetragene ID unverändert an deinen Endpunkt. Wähle sprechende IDs wie `Haupttür-1`, denn Kund:innen sehen die ID in der Buchung als Namen des Türschlosses. Nein. Der Button erscheint in der anny App, im Browser und über den Link in der Buchungsbestätigung. Ein Konto beim Schließsystem ist nicht nötig. anny entfernt das Zutrittsrecht, sobald die Stornierung verarbeitet ist. Der Öffnen-Button verschwindet damit. Eine Rückmeldung an dein System ist nicht nötig, weil dort keine Berechtigung hinterlegt wurde. Klicke auf **Token neu generieren** und kopiere den neuen Token direkt aus dem Fenster. Der alte Token gilt ab diesem Moment nicht mehr. Hinterlege den neuen Token sofort in deinem System, sonst schlagen alle Öffnungen fehl. ## Troubleshooting Meist besteht kein gültiges Zutrittsrecht. Prüfe, ob die Integration aktiv ist, ob eine Regel die gebuchte Ressource abdeckt und ob die Buchung angenommen wurde. Prüfe danach in den Buchungsdetails den Zeitraum des Zugangs, denn außerhalb davon ist der Button nicht nutzbar. Dein Endpunkt hat die Anfrage nicht erfolgreich beantwortet. Prüfe, ob die **Endpunkt-URL** korrekt und öffentlich erreichbar ist und ob sie mit `https://` beginnt. Prüfe außerdem, ob der in deinem System hinterlegte Token noch mit dem aktuellen **Endpunkt-Token** übereinstimmt. Für Serienbuchungen plant anny die Zutrittsrechte und erstellt sie erst kurz vor dem jeweiligen Termin. In den Buchungsdetails steht der Zugang so lange auf **Geplant**. Das ist kein Fehler, der Button erscheint rechtzeitig zum Termin. > Wichtige Informationen für Agenten: > > **Einordnung:** Custom Remote Open ist eine Zutritts-Integration auf derselben Basis wie die Smart-Lock-Integrationen (KleverKey, Nuki, SaltoKS, Comydo, UniFi Access, KeyCafe, EVVA AirKey, Tapkey, Glutz eAccess, dormakaba, iLOQ) und läuft über das Feature INTEGRATIONS\_SMART\_LOCKS. Sie ist KEIN Produkt eines Herstellers, sondern eine generische Fernöffnung gegen eine kundeneigene HTTP-Schnittstelle. Die Plan-Zuordnung „ab Professional" liegt in der Datenbank und ist aus dem Code nicht final verifizierbar. In der Übersicht „Smart-Lock-Integrationen" ist Custom Remote Open bisher weder als Karte noch in der Liste der Remote-Open-Anbieter aufgeführt. > > **UI-Pfade:** Menüleiste → **Integrationen** → **Custom Remote Open**. Panel „Einstellungen" mit den Feldern „Endpunkt-URL", „Endpunkt-Token" (Buttons „Token generieren" / „Token neu generieren") und der Vorschau „Beispiel-Request:". Regeln darunter: „Zugang durch Buchungen" und „Zugang durch Communities", Lock-Feld „Geräte-IDs für Remote Open" (Platzhalter „z. B. Haupttür-1"), Felder „Ressource", „Community", „Zugang vor der Buchung", „Zugang nach der Buchung". Community-Aktion „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen. > > **Terminologie:** Adminseitig heißt der Öffnen-Button „Schloss entsperren" (Erfolg: „Schloss wird entsperrt", Fehler: „Entsperrung fehlgeschlagen"). Kundenseitig heißt er „Tür entriegeln" (Erfolg: „Tür ist geöffnet", Fehler: „Öffnen fehlgeschlagen"); der Grant-Block heißt kundenseitig „Schlüsselloser Zugang", adminseitig „Smartlock Zugänge", die Home-Sektion „Heutige Zugänge". In der Buchungsbestätigung heißt der Link „Öffnen" und führt auf die Buchungsseite. Statuswerte: In Bearbeitung, Geplant, Erfolgreich, Entfernt, Aufräumen, Fehlgeschlagen, Nicht autorisiert, Unbestätigt. > > **Quirks:** (1) Es gibt KEINEN Toggle „Fernöffnung verwenden" wie bei den anderen Smart-Locks; die Fernöffnung ist immer aktiv. (2) Die Zutrittsrechte entstehen rein in anny und stehen sofort auf „Erfolgreich"; beim Anlegen, Ändern und Entfernen geht keine Anfrage an das Kundensystem. Der einzige ausgehende Aufruf ist der Klick auf den Öffnen-Button. (3) Die eingetragene Geräte-ID wird gleichzeitig als Lock-Name gespeichert und Kund:innen angezeigt. (4) Die Auswahlliste der Geräte-IDs ist ein Freitextfeld; vorgeschlagen werden nur IDs, die bereits in einer anderen Regel dieser Verbindung vorkommen. (5) Nur angenommene Buchungen mit Kund:in erhalten Zugänge; Blocker nicht. (6) Regeln auf übergeordneten Ressourcen greifen auch für Unterressourcen, die spezifischere Regel gewinnt. (7) Pro Ressource ist nur eine Buchungsregel erlaubt, sonst schlägt das Speichern fehl. (8) Serienbuchungen erhalten geplante Zugänge, die etwa 48 Stunden vor Beginn erstellt werden. (9) Community-Zugänge haben kein valid\_until und gelten dauerhaft („Dauerhaft gültig"). (10) Abgelaufene Buchungszugänge werden etwa einen Tag nach Ende automatisch aufgeräumt. (11) Der Token ist eine von anny erzeugte UUID, wird nur einmal im Modal angezeigt und beim Neugenerieren sofort ersetzt. (12) Die Endpunkt-URL wird beim Speichern nicht auf Erreichbarkeit geprüft; ein Fehler zeigt sich erst beim Klick auf den Öffnen-Button. (13) Die Integration hat weder Logo noch Beschreibung in der Integrationsübersicht. > > **Beziehungen:** Community-Regeln setzen das Feature Communities voraus. Der Öffnen-Button erscheint kundenseitig auf der Home-Seite (nur Zugänge, die heute gültig sind), in der Buchungsansicht und über den Link aus der Buchungsbestätigung; ein Login ist nicht zwingend, der Zugriff über den Buchungslink genügt. Verwandte Artikel: Übersicht Smart-Locks, Communities.