Skip to main content
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

​
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 <token> 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: 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

1

Endpunkt hinterlegen

Ö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.
2

Konfigurieren

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

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. 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.