Resivo-Verbindung einrichten: Schritte auf Resivo- und i-Reserve-Seite
Die Resivo-Verbindung erfordert Konfiguration auf zwei Seiten: zuerst API-Credentials im Resivo-Portal, danach die Verbindung selbst in i-Reserve.
1. Auf Resivo-Seite (Portal)
Melden Sie sich bei portal.resivo.io an. Öffnen Sie oben rechts das Organisations-/Site-Menü und wählen Sie API.
1.1 Customer ID (= Site Owner ID) notieren
Unter General → Getting started befindet sich das Feld Customer ID. Dies ist in i-Reserve die Site Owner ID. Notieren Sie diesen Wert.
1.2 Credentials generieren
- Klicken Sie auf Generate new credentials.
- Vergeben Sie einen erkennbaren Name (z. B.
ireserve). - Wählen Sie bei Scope den Wert Customer — dann deckt ein Credential alle Sites der Organisation ab. (Wählen Sie Site nur, wenn Sie den Zugang bewusst auf eine Site beschränken möchten.)
- Nach dem Speichern zeigt Resivo einmalig eine Client ID und ein Secret. Kopieren Sie beide sofort — das Secret ist danach nicht mehr abrufbar.
1.3 Site ID nachschlagen (optional)
Möchten Sie das Mapping befüllen oder den Zugang mit einer bestimmten Site verbinden, notieren Sie auch die Site ID. Diese finden Sie über die Site list im selben Menü (oder in der URL der Site: …/sites/<site-id>/overview).
2. Auf i-Reserve-Seite
Gehen Sie zu Verwaltung → Integrationen und fügen Sie eine Resivo-Verbindung hinzu.
2.1 Authentifizierungs-Tab
| Feld | Was einzutragen ist |
|---|---|
| Site Owner ID | Die Customer ID aus dem Resivo-Portal (Organisationsebene). Erforderlich. |
| Client ID | Die OAuth Client ID des generierten Credentials. Erforderlich. |
| Client secret | Das Secret des generierten Credentials (einmalig angezeigt). Erforderlich. |
| Site ID | Die spezifische Site innerhalb des Site Owner; wird verwendet, um die Komponenten (Türen) für das Mapping abzurufen. Optional. |
| Target mobile app id | (Optional) Numerische Legic-Tür-App-ID, nur erforderlich bei mobilen Credentials über die resivo-App. |
Speichern Sie und testen Sie die Verbindung: i-Reserve ruft ein Token ab und kann die Sites und Komponenten des Site Owner anzeigen.
2.2 Details-Tab
| Feld | Was es bewirkt |
|---|---|
| Trigger-Status (erstellen) | Bei welchen Reservierungsstatus der Zugang erstellt wird (z. B. “Bestätigt”). Mehrfachauswahl. |
| Revoke-Status (entziehen) | Bei welchen Reservierungsstatus der Zugang entzogen wird (z. B. “Storniert”). Mehrfachauswahl. |
| Zeit im Voraus (Minuten) | Anzahl der Minuten vor der Startzeit, ab der der Zugang bereits gültig wird (0 = exakt zur Startzeit). Die Endzeit bleibt die Endzeit der Buchung. |
| Reservierungsfeld für Autorisierungs-ID | Das Reservierungsfeld, in dem die ID der Resivo-Autorisierung gespeichert wird. Erforderlich für das Entziehen von Zugang. |
| Standardsprache (Fallback) | Zweibuchstabiger Sprachcode (nl, en, de, …), der verwendet wird, wenn der Kunde keine Sprache hat. |
2.3 Mapping: Objekt → Tür
Auf dem Mapping-Tab verbinden Sie jedes i-Reserve-Objekt (Raum/Ressource) mit einer oder mehreren Resivo-Komponenten (Türen). Die Auswahlliste zeigt die Anzeigenamen der Komponenten der konfigurierten Site. Das Mapping wird nach Name gespeichert; bei jedem Trigger sucht i-Reserve die aktuellen IDs. Haben Sie keine Komponenten in der Liste, prüfen Sie die eingetragene Site ID und die Verbindung.
Objekte und Sub-Objekte. Die Objekt-Auswahlliste links zeigt nun sowohl Hauptobjekte als auch deren Sub-Objekte. So können Sie ein Mapping auf der Ebene eines bestimmten Sub-Objekts anlegen (zum Beispiel ein einzelnes Studio innerhalb eines Sammelobjekts), nicht nur auf dem Hauptobjekt. Bei einer Reservierung auf einem Sub-Objekt trägt die Buchung dieses Sub-Objekt, wodurch das spezifischste Mapping verwendet wird. Bestehende Hauptobjekt-Mappings funktionieren weiterhin.
2.4 Aktivieren
Speichern Sie und setzen Sie die Verbindung auf aktiv. Testen Sie, indem Sie eine Reservierung in einen Trigger-Status bringen und prüfen, dass der Besucher den Türlink von Resivo erhält; prüfen Sie danach das Entziehen über einen Revoke-Status.
