Resivo-Verbindung: Einführung und funktionaler Hintergrund
Was ist Resivo?
Resivo ist ein cloudbasiertes Zugangskontrollsystem von dormakaba. Die Plattform verwaltet digitale Schlüssel und die Türöffnung für Bewohner, Administratoren und Besucher und bietet separate Dokumentation je Zielgruppe:
- Bewohner & Mieter — die resivo home-App zum Aktivieren digitaler Schlüssel und zum Verwalten von Mitbewohnern oder temporärem Zugang.
- Administratoren (Facility Management) — die resivo Utility-App für Ein- und Auscheckprozesse von Mietern.
- Entwickler — die Resivo API für Verträge, Rechnungsstellung und Zugangsverwaltung.
i-Reserve verbindet sich mit der Resivo API und nutzt eine Funktion: Besucherverwaltung mit Remote-Türöffnung. Eine Reservierung gibt dem Besucher automatisch Zugang zur/zu den richtigen Tür(en) für die Dauer der Buchung; bei Stornierung wird dieser Zugang wieder entzogen. Resivo ist der Nachfolger der alten Exivo-Verbindung.
Terminologie: Exivo → Resivo
| Exivo / Dormakaba | Resivo |
|---|---|
| Customer / Site | Site Owner (Organisation) → Site |
| Visit | Remote Access Authorization Set |
| Component | Component (gleicher Begriff: Tür / Zugangspunkt) |
In der i-Reserve-Konfiguration verwenden wir Resivos eigene Terminologie (Site Owner statt “customer”).
Authentifizierung
Die Verbindung verwendet OAuth 2.0 Client Credentials auf Organisationsebene. Ein Credential (Client-ID + Client-Secret) eines Site Owner gibt Zugang zu all dessen Sites. i-Reserve ruft automatisch ein Access-Token ab und verwendet dieses wieder, solange es gültig ist.
Was bei einer Statusänderung geschieht
Die Verbindung reagiert auf Statusänderungen einer Reservierung:
- Gelangt eine Reservierung in einen Trigger-Status, erstellt i-Reserve ein Remote Access Authorization Set: die verbundene(n) Tür(en), mit einer Gültigkeit von (Start − Zeit im Voraus) bis zur Endzeit der Buchung.
- Resivo sendet selbst eine E-Mail/SMS an den Besucher mit einem Türlink, mit dem die Tür aus der Ferne geöffnet werden kann.
- Die ID der erstellten Autorisierung wird in einem gewählten Reservierungsfeld gespeichert — erforderlich, um den Zugang später entziehen zu können.
- Gelangt die Reservierung in einen Revoke-Status (z. B. storniert), entzieht i-Reserve den Zugang wieder.
Mapping nach Name
Die Verbindung von i-Reserve-Objekten mit Resivo-Türen (Components) erfolgt nach Name, nicht nach ID. Der Anzeigename einer Komponente (z. B. “Digitaler Zylinder – doppelt”) ist pro Site eindeutig, während sich die ID bei einer Site-Migration ändern kann. Bei jedem Trigger sucht i-Reserve die aktuellen IDs anhand der gewählten Namen.
Telefonnummern (SMS)
Resivo akzeptiert für SMS nur Mobilnummern im E.164-Format (+31612345678). i-Reserve normalisiert 00… zu +… und entfernt Leerzeichen. Eine Nummer ohne Ländervorwahl (z. B. 06… oder ein Festnetzanschluss) wird übersprungen: Dann entfällt nur die SMS, der Zugang und die E-Mail funktionieren weiterhin.
Einschränkungen (aktueller Stand)
- Türlink nicht über die API — der Portal-Link, den Resivo verwendet, wird nicht in der API-Antwort zurückgegeben. i-Reserve kann diesen Link daher nicht vorab in eine eigene Mail-Vorlage einfügen; Resivo versendet den Link über seine eigene E-Mail/SMS.
- Mail-Sprache über die Site — die Sprache der Nachrichten von Resivo stammt aus der
defaultLocaleder Site (einmalig im Resivo-Portal einzustellen). - Benachrichtigungen nur über Resivo — die E-Mail an den Besucher wird ausschließlich von Resivo versendet; i-Reserve versendet hierfür keine eigene Mail. Der Text dieser Resivo-E-Mails ist nicht anpassbar.
- Zeitzonen — Gültig-von/bis werden in UTC versendet. Der i-Reserve-Server muss die richtige Zeitzone als Standard haben, sonst stimmen die Zeiten nicht.
