Technische Anleitung: Integration von Minut mit Avantio

Im wettbewerbsintensiven Ökosystem der Ferienvermietung sind operative Effizienz und Vermögensschutz von zentraler Bedeutung. Die Integration zwischen dem Property-Management-System (PMS) Avantio und der intelligenten Überwachungslösung Minut stellt einen strategischen Fortschritt für moderne Immobilienverwalter dar. Sie verwandelt reaktive Prozesse in ein proaktives und automatisiertes Risikomanagement-System.

1. Bevor Sie beginnen: Voraussetzungen für eine erfolgreiche Minut/Avantio-Integration

Eine gründliche Vorbereitung ist der Schlüssel zu einer reibungslosen und erfolgreichen Integration. Bevor Sie den Verbindungsprozess initiieren, ist es zwingend sicherzustellen, dass die folgenden Bedingungen erfüllt sind. Die Nichteinhaltung dieser Voraussetzungen ist die häufigste Ursache für Konfigurationsfehler.

• Aktive Konten: Aktive Abonnements für die Dienste Minut und Avantio sind erforderlich, um die Integration durchzuführen.
• Physische Installation der Sensoren: Die Minut-Sensoren müssen physisch installiert, geladen und mit dem lokalen Wi‑Fi-Netzwerk in jeder zu überwachenden Immobilie verbunden sein. Es ist wichtig sicherzustellen, dass jeder Sensor im Minut-Dashboard den Status „Online“ anzeigt.
• Kritischer Schritt - Aktivierung auf Avantio-Seite: Dies ist die wichtigste und nicht verhandelbare Voraussetzung. Der Benutzer muss dringend das Support-Team von Avantio kontaktieren, um die Aktivierung der Minut-Integration für sein Konto zu beantragen. Die Integrationsoption wird im Minut-Interface nicht erscheinen oder nicht funktionieren, solange Avantio nicht die Autorisierung serverseitig erteilt hat. Dieser Prozess zeigt, dass die Integration auf einer API mit Berechtigungen oder einer geschlossenen API basiert, im Gegensatz zu vielen SaaS-Integrationen im Self-Service. Dieser Ansatz, obwohl potenziell stabiler, führt zu einer kritischen Abhängigkeit vom Avantio-Support und kann zu einer Verzögerung führen, bevor mit der Konfiguration begonnen werden kann.
• Eigenschaften-Konfiguration in Avantio: Alle Eigenschaften, die integriert werden sollen, müssen vollständig im VRMS (Vacation Rental Management Software) von Avantio konfiguriert sein. Basierend auf den Anforderungen ähnlicher Integrationen mit Avantio wird empfohlen sicherzustellen, dass jede Immobilienanzeige mindestens ein Foto und zugewiesene Tarifperioden hat, da diese Elemente Bedingungen sein können, damit die API die Anzeige erkennt und korrekt synchronisiert.

2. Schritt-für-Schritt-Integrationsleitfaden: Minut mit Ihrem PMS Avantio verbinden

Sobald alle Voraussetzungen validiert sind, kann der technische Verbindungsprozess von der Minut-Plattform aus gestartet werden. Das Verfahren ist darauf ausgelegt, einfach zu sein, erfordert jedoch eine Autorisierung auf der Avantio-Plattform, um die sichere Verknüpfung der Daten abzuschließen.

1. Zugriff auf das Minut-Integrationsmenü : Melden Sie sich bei der Webanwendung von Minut an. Im Hauptnavigationsmenü finden Sie den Abschnitt Integrationen.
2. Wählen Sie die Avantio-Integration: Durchsuchen Sie die Liste der verfügbaren PMS-Integrationen, bis Sie das Logo Avantio finden. Klicken Sie darauf, um zur Seite zur Konfiguration der Integration zu gelangen.
3. Starten Sie die Verbindung: Auf der Seite der Avantio-Integration klicken Sie auf die Schaltfläche "Verbinden" (oder "Connect"). Dieser Schritt initiiert den Autorisierungsprozess und leitet Sie automatisch von der Plattform Minut zu einer Avantio-Anmeldeseite weiter.
4. Autorisierung auf der Avantio-Plattform : Sie werden aufgefordert, sich mit Ihren Administrator-Anmeldedaten bei Ihrem Avantio-Konto anzumelden. Nach der Anmeldung wird Avantio Sie bitten, Minut die Berechtigung zu erteilen, auf Ihre Objekte und Reservierungsdaten zuzugreifen. Es handelt sich um ein Standard-Sicherheitsprotokoll (OAuth), das sicherstellt, dass der Datenaustausch ausdrücklich und sicher ist. Prüfen Sie die angeforderten Berechtigungen und klicken Sie auf "Zulassen" oder eine entsprechende Schaltfläche.
5. Weiterleitung und Bestätigung: Nachdem die Autorisierung erfolgreich erteilt wurde, wird Ihr Browser automatisch zur Webanwendung von Minut weitergeleitet. Eine Bestätigung sollte angezeigt werden, die bestätigt, dass die Verbindung zwischen Minut und Avantio erfolgreich hergestellt wurde.

Dieser technische Ablauf, bei dem die Anfrage von einer Drittanwendung (Minut) initiiert wird, aber die kritische Autorisierung auf der Plattform des Dateninhabers (Avantio) erteilt wird, ist eine gängige Sicherheitspraxis. Es ist daher entscheidend, die Anmeldedaten eines Administrator-Kontos von Avantio griffbereit zu haben. Außerdem wird empfohlen, Pop-up-Blocker oder Script-Blocker im Browser vorübergehend zu deaktivieren, da sie den Redirect-Prozess stören und die Verbindung scheitern lassen könnten.

3. Wesentliche Konfiguration nach der Integration

Die Herstellung der Verbindung ist nur der erste Schritt. Damit die Integration funktionsfähig ist und Nutzen bringt, ist nach der Verbindung eine Nachkonfiguration erforderlich. Diese Phase besteht darin, die Objekte zu verknüpfen und die Automatisierungen der Kommunikation zu konfigurieren.

3.1. Synchronisierung der Objekte: Verknüpfen Sie Ihre Minut- und Avantio-Unterkünfte

Nachdem die technische Verbindung hergestellt wurde, fordert Minut Sie auf, Ihre Objekte zu 'zuordnen' oder zu 'verknüpfen'. Dieser Schritt ist grundlegend für das reibungslose Funktionieren der Automatisierung.

Die Minut-Oberfläche zeigt eine Liste Ihrer Unterkünfte, in denen Sensoren installiert sind. Neben jeder Minut-Unterkunft enthält ein Dropdown-Menü die Liste Ihrer Objekte, die aus Ihrem Avantio-Konto über die API extrahiert wurden. Der Prozess besteht darin, manuell die entsprechende Avantio-Immobilie für jede Minut-Unterkunft auszuwählen.

Diese manuelle Zuordnung ist entscheidend. Sie gibt dem Minut-System an, welcher Satz Reservierungsdaten von Avantio welchem physischen Sensor zugeordnet ist. Ein Mapping-Fehler hätte schwere Folgen, z. B. das Senden einer Warnung wegen Lärmbelästigung an den falschen Mieter, was die Kundenerfahrung erheblich beeinträchtigen würde. Dieser Schritt ist daher keine bloße Konfigurationsaufgabe, sondern eine Maßnahme, die die Integrität des gesamten automatisierten Kommunikationssystems gewährleistet. Es ist auch wichtig zu beachten, dass dieser Prozess jedes Mal wiederholt werden muss, wenn eine neue Immobilie Ihrem Portfolio hinzugefügt wird und mit einem Minut-Sensor ausgestattet wird.

3.2. Einrichtung automatisierter Alarme: Effektive Kommunikation mit den Reisenden

Die wichtigste durch diese Integration freigeschaltete Funktion ist die automatisierte Kommunikation mit den Reisenden bei Erkennung von zu lauter Geräuschentwicklung. Um sie zu konfigurieren, gehen Sie zu den Einstellungen von Nachrichten oder Guest Connect in Ihrem Minut-Konto.   

Die Konfiguration des automatisierten Kommunikationsflusses umfasst mehrere Schlüsselelemente:

• Lärm-Schwellen definieren: Konfigurieren Sie die Dezibelhöhe und die Dauer, die eine Alarmierung auslösen. Diese Parameter können an die Regeln der Unterkunft und die Ruhezeiten angepasst werden.
• Nachrichten anpassen: Verfassen Sie die SMS-Nachricht, die dem Reisenden automatisch gesendet wird. Es wird empfohlen, einen freundlichen und informativen Ton zu verwenden, um Konflikte zu vermeiden. Zum Beispiel: "Hallo [Name des Reisenden], dies ist eine freundliche Erinnerung Ihres Gastgebers an die Ruhezeiten. Der Geräuschpegelsensor hat hohe Geräuschpegel festgestellt. Könnten Sie bitte die Lautstärke senken? Wir danken Ihnen, dass Sie uns helfen, gute Nachbarn zu sein."
• Automatisierung aktivieren: Sobald die Parameter konfiguriert sind, aktivieren Sie die Funktion. Ab jetzt, wenn ein Lärmereignis in einer verknüpften Immobilie erkannt wird, wird das Minut-System die Reservierung in Avantio abfragen, die Kontaktdaten des Reisenden abrufen und die personalisierte Nachricht ohne manuelle Eingriffe senden.

4. Fehlerbehebung und FAQ (FAQ)

Selbst bei sorgfältiger Konfiguration können Probleme auftreten. Dieser Abschnitt bietet Lösungen für die häufigsten Probleme, damit Benutzer Vorfälle eigenständig lösen können, bevor sie den technischen Support kontaktieren.

4.1. Verbindungsprobleme des Minut-Sensors

• Symptóm : Ein Sensor wird im Minut-Dashboard als „Getrennt“ oder „Offline“ angezeigt.
• Lösung : Befolgen Sie das detaillierte Fehlerbehebungsverfahren des Minut-Hilfezentrums.
  1. Erst-Verifizierungen : Stellen Sie sicher, dass der Sensor eingeschaltet ist (via dem Schalter beim Modell M3 oder durch Drücken des Objektivs beim M2), dass er ausreichend geladen ist und sich in Reichweite eines funktionsfähigen Wi‑Fi-Netzwerks befindet.
  2. Wi‑Fi-Fehlerbehebung (Schritt 1) : Starten Sie den Wi‑Fi-Router neu, indem Sie ihn 20 Sekunden lang vom Netz trennen. Schalten Sie den Minut-Sensor aus und lassen Sie ihn 10 Minuten ausgeschaltet. Einschalten, 10 Sekunden warten, dann die Haupttaste drücken, um zu beobachten, ob die LED zuerst weiß dann grün leuchtet, was eine erfolgreiche Verbindung anzeigt.
  3. Wi‑Fi-Fehlerbehebung (Schritt 2) : Wenn Schritt 1 fehlschlägt, verwenden Sie die Minut-Mobile-App, um die Wi‑Fi-Einstellungen zu aktualisieren. Gehen Sie zu Gerät → Einstellungen → Erweitert → Wi‑Fi-Einstellungen aktualisieren und folgen Sie den Anweisungen auf dem Bildschirm.
  4. Minut-Support kontaktieren : Falls der Sensor nach all diesen Schritten weiterhin nicht verbunden ist, kontaktieren Sie den Minut-Support unter der Adresse bonjour@minut.com. Geben Sie eine kurze Problembeschreibung, die Seriennummer oder die MAC-Adresse des Sensors sowie Marke und Modell Ihres Routers an.

4.2. Synchronisationsprobleme mit Avantio

• Symptom 1 : Die Avantio-Integrationsoption fehlt, ist ausgegraut oder im Minut-Integrationsmenü nicht zugänglich.
• Ursache : Die API wurde von Avantio für Ihr Konto nicht aktiviert.
• Solution : Dies ist das am häufigsten auftretende Startproblem. Kontaktieren Sie erneut den Avantio-Support (contact@avantio.com) und bitten Sie sie, zu bestätigen, dass die Minut-Integration von ihrer Seite aus aktiviert wurde.

• Ursache und Lösung :
  1. API-Synchronisationsverzögerung : Die Avantio-API aktualisiert sich möglicherweise nicht sofort. Es wird empfohlen, bis zu 24 Stunden zu warten, damit die neue Property synchronisiert wird.
  2. Unvollständige Anzeige : Vergewissern Sie sich, dass die Immobilienanzeige in Avantio vollständig konfiguriert ist, mit mindestens einem Foto und zugewiesenen Tarifperioden, da diese Elemente von der API verlangt werden können.
  3. Wenn das Problem länger als 24 Stunden besteht, kontaktieren Sie den Avantio-Support, da sie den API-Datenfluss kontrollieren.

• Ursache : Die Kontaktdaten des Reisenden können in der Reservierung bei Avantio fehlen oder falsch sein.
• Lösung : Überprüfen Sie zuerst die Reservierung in Ihrer Avantio-Oberfläche, um sicherzustellen, dass eine gültige Telefonnummer dort registriert ist. Wenn die Daten in Avantio korrekt sind, aber nicht synchronisiert werden, kommt das Problem wahrscheinlich von der API. Kontaktieren Sie den Avantio-Support, damit sie die API-Protokolle für diese Reservierung überprüfen.

4.3. Leitfaden zur Kontaktaufnahme mit dem technischen Support

Für eine effiziente Lösung ist es entscheidend, das richtige Support-Team zu kontaktieren.

• Kontakt zum Minut-Support (bonjour@minut.com) für :
  • Jedes Hardware-Problem mit einem Sensor (Ladung, Stromversorgung).
  • Ein Sensor, der nach Durchführung der Fehlerbehebung weiterhin „Offline“ bleibt.
  • Fragen zu den Funktionen der Minut-Anwendung (Web oder Mobil), z. B. zur Konfiguration von Alarmen.   
• Kontakt zum Avantio-Support (contact@avantio.com) für :
  • Die anfängliche Aktivierungsanfrage der Minut-Integration.
  • Eigenschaften, Reservierungen oder Reisenden-Daten, die nicht ordnungsgemäß mit Minut synchronisiert werden.
  • Fehler, die während des Autorisierungsschritts auf der Avantio-Plattform auftreten.
  • Jede Frage zu den Daten, die von Ihrem PMS stammen.   

Table 1: Schnelle Fehlerbehebungsanleitung der Minut-Avantio-Integration

Die Minut-Integration mit Avantio ist viel mehr als eine bloße technische Verbindung; sie stellt einen entscheidenden Schritt in Richtung intelligenteres, sichereres und skalierbares Immobilienmanagement dar. Wenn Sie diesem Leitfaden folgen, können Verwalter ein robustes System implementieren, das ihr Vermögen schützt und gleichzeitig das Kundenerlebnis verbessert.