Zum Hauptinhalt springen

Nuki Integration

Dies ist eine technische Anleitung zur Integration des Nuki-Smartlock-Systems in LIKE MAGIC.

Einleitung​

Auf dieser Seite findest du einen Überblick über die Integration zwischen Nuki und unseren Diensten, einschliesslich der für den Gastzugang verfügbaren Zugangsmodi. Wir beschreiben die notwendigen Voraussetzungen und Einrichtungsanforderungen, einschliesslich des Zugriffs auf die Nuki Web API und der Freigabe des Türzugangs. Zusätzlich erfährst du, welche Konfigurationsschritte in Nuki Web erforderlich sind und wie der Türzugang für Gäste eingerichtet wird.

1. Türöffnungsmodus​

Unsere Integration mit Nuki bietet zwei sich ergänzende Modi zum Öffnen von Türen:

a) „Halten zum Entsperren“​

Gäste öffnen Türen aus der Ferne über unsere Web-Anwendung. Sie halten das Bedienelement Halten zum Entsperren der jeweiligen Tür gedrückt, was eine Nuki-Fernentriegelung am Smartlock auslöst.

b) PIN-Code-Zugang​

Sofern ein Nuki Keypad am Smartlock installiert ist, können Gäste die Tür mit einem 6-stelligen PIN-Code öffnen. LIKE MAGIC erzeugt den PIN und stellt ihn für die Dauer des Aufenthalts auf dem Keypad bereit.

c) Konfiguration​

Beide Methoden können in derselben Property parallel betrieben werden:

  • Halten zum Entsperren: verfügbar an jedem online erreichbaren Nuki-Smartlock
  • PIN-Code: verfügbar an Smartlocks, die mit einem Nuki Keypad ausgestattet sind
info

Hinweis: Die Nuki-Integration ist vollständig schlüssellos. Anders als kartenbasierte Systeme gibt sie keine physischen Schlüsselkarten über die Operations Platform oder den Kiosk aus. Der Gastzugang erfolgt über Fernentriegelung und Keypad-PINs.

2. Voraussetzungen & Einrichtung​

Für eine erfolgreiche Integration müssen die folgenden Voraussetzungen erfüllt sein.

  • Zugriff auf die Nuki Web API: Ein Nuki Web-Konto mit API-Zugriff. LIKE MAGIC authentifiziert sich gegenüber der Nuki Web API (https://api.nuki.io) mit einem pro Property konfigurierten API-Token.
  • Mit Nuki Web verbundene Smartlocks: Jede zu verwaltende Tür muss ein Nuki-Smartlock sein, das online und über Nuki Web erreichbar ist (über eine Nuki Bridge oder eine integrierte Verbindung). Die Fernentriegelung setzt voraus, dass das Schloss online ist.
  • Nuki Keypad (für PIN-Zugang): Der PIN-Code-Zugang erfordert ein am jeweiligen Smartlock installiertes Nuki Keypad. Schlösser ohne Keypad unterstützen weiterhin die Fernentriegelung per Halten zum Entsperren.

3. Nuki Web API-Konfiguration​

Ein entscheidender Schritt für die Integration ist die Bereitstellung eines Nuki Web API-Tokens für LIKE MAGIC.

Konfigurationsschritte​

  1. Melde dich bei Nuki Web an: mit einem Konto, das die Smartlocks der Property verwaltet.
  2. Erzeuge ein API-Token mit allen Berechtigungen.
  3. Teile das API-Token sicher mit dem LIKE MAGIC-Team. Wir speichern es als property-spezifische Nuki-Konfiguration und verwenden es für die gesamte weitere Kommunikation.
info

Sicherheitshinweis: Das API-Token gewährt LIKE MAGIC einen eingegrenzten Zugriff, um Smartlock-Berechtigungen in deinem Namen zu verwalten. Bitte sende diese Anmeldedaten nicht per E-Mail. Nutze stattdessen einen sicheren Dienst für Einmal-Links wie beispielsweise onetimesecret.com.

4. Einrichtung der Türzugangs-Freigabe​

Sobald der API-Zugriff eingerichtet ist, konfigurieren wir den Türzugang gemeinsam mit LIKE MAGIC. LIKE MAGIC liest alle Smartlocks aus deinem Nuki Web-Konto und ordnet jedes Schloss automatisch einem Zimmer zu, indem der Schlossname mit dem PMS-Zimmernamen abgeglichen wird. Die übrige Klassifizierung wird gemeinsam mit dir bestätigt.

Bitte teile dem LIKE MAGIC-Team die folgenden Informationen mit:

a) Private Türen (Zimmer)​

  • Bestätige, welches Smartlock zu welchem Zimmer gehört, damit der Zimmerzugang während des Aufenthalts dem richtigen Gast gewährt werden kann.

b) Öffentlicher Türzugang​

  • Benenne alle Türen, die Gästen öffentlich zur Verfügung stehen sollen (z. B. Haupteingang, Aufzug, Spa).
  • Gib an, ob jede öffentliche Tür allen Gästen oder nur eingecheckten Gästen (In-House) zur Verfügung steht.

c) Service-Türen​

  • Benenne Türen, die nur für Gäste geöffnet werden sollen, die einen bestimmten Service gebucht haben (z. B. Parken, Wellness), sowie den zugehörigen Service.

5. Wie LIKE MAGIC mit Nuki interagiert​

Lies gerne in unserem allgemeinen Türzugangs-Guide mehr dazu:

Einstellungen zum Türzugang

6. Fazit​

Indem du die in dieser Anleitung beschriebenen Schritte befolgst, hast du dein Nuki-System für die Integration mit der LIKE MAGIC-Plattform konfiguriert. Der Gastzugang ist vollständig schlüssellos, über die Fernentriegelung Halten zum Entsperren und Keypad-PIN-Codes.

Sobald du:

  • ein Nuki Web API-Token mit Berechtigungen zur Smartlock-Verwaltung bereitgestellt hast
  • die Zuordnung von Zimmer zu Schloss für die privaten Türen bestätigt hast
  • die Klassifizierung der öffentlichen, In-House- und Service-Türen geteilt hast

melde sie über eine Support Anfrage. LIKE MAGIC prüft anschliessend die Verbindung und die Zugangsverwaltung für deine Property.

Was this article helpful?