Technischer Leitfaden: Integration von Minut mit Beds24

Dieses Handbuch bietet detaillierte technische Anweisungen zur Verbindung Ihres Property-Management-Systems (PMS) Beds24 mit Ihrem Minut-Konto. Das Ziel dieser Integration ist es, die Kommunikation mit den Gästen bei Geräuschdetektion zu automatisieren. Durch die Verknüpfung der beiden Systeme kann Minut automatisch die Kontaktinformationen des in Beds24 für eine bestimmte Immobilie registrierten Gastes abrufen und ihm eine SMS senden, falls die vordefinierten Geräuschpegel überschritten werden.

Voraussetzungen für die Minut- und Beds24-Integration

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein aktives Minut-Konto mit mindestens einem installierten Sensor.
• Ein Beds24-Konto mit administrativen Zugriffsrechten.

Schritt 1: API-Zugriff in Beds24 konfigurieren

Der erste Schritt besteht darin, Minut zu autorisieren, sicher mit Ihrem Beds24-Konto zu kommunizieren, indem Sie einen API-Schlüssel und eine IP-Whitelist konfigurieren.

1. Melden Sie sich bei Ihrem Beds24-Konto an.
2. Gehen Sie zu (SETTINGS) > ACCOUNT > ACCOUNT ACCESS.   
3. Geben Sie im Feld API Key einen eindeutigen und sicheren Schlüssel von mindestens 16 Zeichen Länge ein. Sie können dafür eine zufällige Zeichenfolge generieren. Bewahren Sie diesen Schlüssel auf, da Sie ihn später benötigen werden.   
4. Für den Parameter API Key Access wählen Sie die Option 'allow whitelist IP only' aus. Dies ist eine wesentliche Sicherheitsmaßnahme, um sicherzustellen, dass nur Anfragen von den Servern von Minut autorisiert sind.
5. Im Feld IP Whitelist geben Sie die folgenden IP-Adressen ein, durch Leerzeichen getrennt:  34.210.109.50 52.27.242.23 52.88.133.148 54.68.231.215
6. Stellen Sie den Parameter Allow Writes auf YES. Diese Berechtigung ist erforderlich, damit Minut die Reservierungsdaten abrufen kann.
7. Für Property Access wählen Sie 'Owned by this account only' aus.
8. Klicken Sie auf SAVE.

Schritt 2: Einzigartige Property Keys (propKey) in Beds24 erstellen

Jede Eigenschaft, die Sie verbinden möchten, muss über eine eindeutige Kennung verfügen, die propKey genannt wird und als Verbindung zwischen Beds24 und Minut dient.

1. In Beds24 gehen Sie zu (SETTINGS) > PROPERTIES > ACCESS.   
2. Für die erste Eigenschaft, die Sie verbinden möchten, erstellen Sie eine eindeutige und zufällige Zeichenfolge von mindestens 16 Zeichen und geben Sie sie in das Feld propKey ein.
3. Wichtig : Jede propKey muss für jede Eigenschaft eindeutig sein. Sie können denselben Schlüssel nicht wiederverwenden.   
4. Klicken Sie auf Speichern.
5. Wiederholen Sie diesen Prozess für jede Eigenschaft, die Sie mit Minut integrieren möchten.

Schritt 3: Die Verbindung im Minut-Dashboard abschließen

Jetzt, da Beds24 konfiguriert ist, können Sie die Verbindung von Ihrem Minut-Konto aus herstellen.

1. Melden Sie sich bei der Webanwendung von Minut an.
2. Gehen Sie zum Abschnitt Integrationen im linken Menü.
3. Suchen und wählen Sie Beds24 aus der Liste der verfügbaren PMS.
4. Klicken Sie auf Verbinden.
5. Lesen Sie die Nutzungsbedingungen und akzeptieren Sie sie.
6. Sie werden aufgefordert, zwei Informationen einzugeben:
   • Ihr Beds24-Benutzername.
   • Der API-Schlüssel, den Sie in Schritt 1 erstellt haben.
7. Nachdem Sie diese Informationen eingegeben haben, wird die anfängliche Verbindung hergestellt.

Schritt 4: Die Zuordnung der Eigenschaften

Der letzte Schritt besteht darin, Ihre Minut-Eigenschaften mit den entsprechenden Anzeigen in Beds24 zu verknüpfen.

1. Nachdem die Verbindung hergestellt ist, zeigt Minut eine Liste Ihrer Objekte mit einem Sensor an.
2. Für jede Minut-Eigenschaft verwenden Sie das Dropdown-Menü, um die entsprechende Beds24-Anzeige auszuwählen. Dieser Prozess verwendet die propKey, die Sie erstellt haben, um eine korrekte Zuordnung sicherzustellen.
3. Stellen Sie sicher, dass jede Eigenschaft korrekt gemappt ist.
4. Sobald alle Ihre Eigenschaften verknüpft sind, ist die Integration abgeschlossen und aktiv.

Überprüfung und Fehlerbehebung der Minut/Beds24-Integration

Nachdem die Integration abgeschlossen ist, vergessen Sie nicht, Ihre automatisierten Nachrichten-Einstellungen in Minut zu konfigurieren, um die Geräuschschwellen festzulegen und die an die Gäste gesendete Nachricht anzupassen.