Guida Tecnica : Integrazione di Minut con Avantio

Nell'ecosistema competitivo dell'affitto stagionale, l'efficienza operativa e la protezione degli asset sono fondamentali. L'integrazione tra il sistema di gestione degli immobili (PMS) Avantio e la soluzione di monitoraggio intelligente Minut rappresenta un avanzamento strategico per i gestori immobiliari moderni. Essa trasforma processi reattivi in un sistema di gestione del rischio proattivo e automatizzato.

1. Prima di iniziare: prerequisiti per una riuscita integrazione Minut/Avantio

Una preparazione accurata è la chiave per una integrazione fluida e riuscita. Prima di avviare il processo di connessione, è indispensabile assicurarsi che le condizioni seguenti siano soddisfatte. La mancata osservanza di tali prerequisiti è la causa più comune dei fallimenti di configurazione.

• Account attivi: Abbonamenti attivi ai servizi Minut e Avantio sono necessari per procedere all'integrazione.
• Installazione fisica dei sensori: I sensori Minut devono essere installati fisicamente, ricaricati e collegati alla rete Wi-Fi locale in ogni proprietà da monitorare. È essenziale verificare che ogni sensore appaia con lo stato "Online" nella dashboard dell'app Minut.   
• Fase Critica - Attivazione lato Avantio: Si tratta del prerequisito più importante e non negoziabile. L'utente deve obbligatoriamente contattare il team di supporto di Avantio per richiedere l'attivazione dell'integrazione Minut per il proprio account. L'opzione di integrazione non apparirà né sarà funzionale nell'interfaccia Minut finché Avantio non avrà autorizzato sul lato server. Questo processo indica che l'integrazione si basa su una API "permessa" o "chiusa", contrariamente a molte integrazioni SaaS in self-service. Questo approccio, sebbene potenzialmente più stabile, introduce una dipendenza critica dal supporto di Avantio e può comportare un ritardo prima di poter iniziare la configurazione.   
• Configurazione delle Proprietà in Avantio: Tutte le proprietà destinate a essere integrate devono essere completamente configurate nel VRMS (Vacation Rental Management Software) di Avantio. In base alle esigenze di integrazioni simili con Avantio, si consiglia di assicurarsi che ogni annuncio di proprietà possieda almeno una foto e stagioni tariffarie assegnate, poiché questi elementi possono essere condizioni necessarie affinché l'API riconosca e sincronizzi correttamente l'annuncio.   

2. Guida all'integrazione passo-passo: collega Minut al tuo PMS Avantio

Una volta validati tutti i prerequisiti, il processo tecnico di connessione può essere avviato dalla piattaforma Minut. La procedura è progettata per essere semplice, ma richiede l'autorizzazione sulla piattaforma Avantio per finalizzare la connessione sicura dei dati.

1. Accedi al menu delle Integrazioni Minut: Effettua l'accesso all'applicazione web di Minut. Nel menu di navigazione principale, individua e fai clic sulla sezione Integrazioni.   
2. Seleziona l'Integrazione Avantio: Scorri l'elenco delle integrazioni PMS disponibili fino a trovare il logo Avantio. Cliccaci per accedere alla pagina di configurazione dell'integrazione.   
3. Lancia la Connessione: Nella pagina dell'integrazione Avantio, clicca sul pulsante "Collega" (o "Connect"). Questa azione avvierà il processo di autorizzazione e ti reindirizzerà automaticamente dalla piattaforma Minut a una pagina di accesso Avantio.   
4. Autorizzazione sulla Piattaforma Avantio: Verrai invitato a accedere al tuo account Avantio usando le tue credenziali di amministratore. Dopo l'accesso, Avantio ti chiederà di concedere a Minut l'autorizzazione ad accedere ai dati delle tue proprietà e delle prenotazioni. Si tratta di un protocollo di sicurezza standard (OAuth) che garantisce che la condivisione dei dati sia esplicita e sicura. Esamina i permessi richiesti e clicca su "Autorizza" o un pulsante equivalente.
5. Reindirizzamento e Conferma: Una volta concessa l'autorizzazione con successo, il tuo browser verrà automaticamente reindirizzato all'app web di Minut. Un messaggio di conferma dovrebbe apparire, indicando che la connessione tra Minut e Avantio è stata stabilita con successo.   

Questo flusso tecnico, in cui la richiesta è avviata da un'applicazione di terze parti (Minut) ma in cui l'autorizzazione critica è concessa sulla piattaforma del proprietario dei dati (Avantio), è una pratica di sicurezza standard. È quindi cruciale avere a portata di mano i dettagli di amministratore Avantio. Inoltre, si consiglia di disattivare temporaneamente i blocchi di popup o di script nel browser, poiché potrebbero interferire con il processo di reindirizzamento e far fallire la connessione.

3. Configurazione essenziale post-integrazione

La stabilizzazione della connessione è solo la prima fase. Perché l'integrazione sia funzionale e porti valore, è necessaria una configurazione post-connessione. Questa fase consiste nel collegare le proprietà e configurare l'automazione delle comunicazioni.

3.1. Sincronizzazione delle proprietà: Collegare le vostre proprietà Minut e Avantio

Una volta stabilita la connessione tecnica, Minut vi inviterà a "mappare" o "collegare" le vostre proprietà. Questa fase è fondamentale per il corretto funzionamento dell'automazione.   

L'interfaccia di Minut mostrerà un elenco delle vostre proprietà dove sono installati sensori. Accanto a ogni alloggio Minut, un menu a tendina conterrà l'elenco delle vostre proprietà estratte dal vostro account Avantio via API. Il processo consiste nel selezionare manualmente la proprietà Avantio corrispondente per ogni alloggio Minut.

Questa corrispondenza manuale è cruciale. Indica al sistema Minut quale insieme di dati di prenotazione di Avantio si applica a quale sensore fisico. Un errore di mappatura avrebbe conseguenze gravi, come l'invio di un avviso di rumore al viaggiatore sbagliato, il che danneggerebbe gravemente l'esperienza del cliente. Questa fase non è quindi un semplice compito di configurazione, ma un atto che garantisce l'integrità dell'intero sistema di comunicazione automatizzata. È anche importante notare che questo processo deve essere ripetuto ogni volta che viene aggiunta una nuova proprietà al tuo portafoglio dotata di sensore Minut.

3.2. Implementazione delle allerte automatizzate: Comunicare efficacemente con i viaggiatori

La principale funzionalità sbloccata da questa integrazione è la comunicazione automatizzata con i viaggiatori in caso di rilevamento di rumore eccessivo. Per configurarla, accedi alle impostazioni di Messaggistica o Guest Connect nel tuo account Minut.   

La configurazione del flusso di comunicazione automatizzato comprende diverse fasi chiave :

• Definire le Soglie di Rumore: Configura il livello di decibel e la durata che attiveranno un avviso. Questi parametri possono essere adeguati per corrispondere alle regole della proprietà e agli orari di quiete.
• Personalizzare il Messaggio: Scrivi il messaggio SMS che verrà inviato automaticamente al viaggiatore. Si raccomanda di adottare un tono amichevole e informativo per evitare conflitti. Ad esempio: "Ciao [Nome del Viaggiatore], questo è un promemoria amichevole dal tuo host riguardo alle ore di quiete. Il sensore di rumore ha rilevato livelli sonori elevati. Potresti gentilmente abbassare il volume? Grazie per aiutarci a essere buoni vicini."
• Attivare l'Automazione: Una volta configurati i parametri, attiva la funzionalità. D'ora in avanti, quando si verifica un evento di rumore in una proprietà collegata, il sistema Minut interrogherà Avantio per la prenotazione in corso, recupererà i dati di contatto del viaggiatore e invierà il messaggio personalizzato senza alcun intervento manuale.

4. Risoluzione dei problemi e Domande frequenti (FAQ)

Anche con una configurazione accurata possono verificarsi problemi. Questa sezione fornisce soluzioni ai problemi più comuni, permettendo agli utenti di risolvere autonomamente gli incidenti prima di contattare il supporto tecnico.

4.1. Problemi di connettività del sensore Minut

• Sintomo: Un sensore appare come "Disconnesso" o "Offline" nella dashboard Minut.
• Soluzione: Seguire la procedura di risoluzione dei problemi dettagliata fornita dal centro di assistenza di Minut.
  1. Verifiche iniziali: Assicurati che il sensore sia acceso (tramite l'interruttore per il modello M3 o premendo l'obiettivo per il M2), che sia sufficientemente carico e che si trovi a portata di una rete Wi-Fi funzionante.
  2. Dépannage Wi-Fi (Étape 1): Riavvia il router Wi-Fi scollegandolo per 20 secondi. Spegni il sensore Minut e lascialo spento per 10 minuti. Riaccendilo, attendi 10 secondi, quindi premi sul pulsante principale per osservare se il LED si accende di bianco e poi di verde, indicando una connessione riuscita.
  3. Dépannage Wi-Fi (Étape 2): Se la prima fase fallisce, usa l'app mobile Minut per aggiornare i parametri Wi-Fi. Vai su Dispositivo → Impostazioni → Avanzate → Aggiorna parametri Wi‑Fi e segui le istruzioni sullo schermo.
  4. Contattare l'Assistenza Minut: Se il sensore resta disconnesso dopo aver seguito tutte queste fasi, contatta l'assistenza Minut all'indirizzo bonjour@minut.com. Fornisci una breve descrizione del problema, il numero di serie o l'indirizzo MAC del sensore, nonché la marca e il modello del tuo router.   

4.2. Problemi di sincronizzazione con Avantio

• Sintomo 1 : L'opzione di integrazione Avantio è mancante, grigia o inacessibile nel menu delle integrazioni di Minut.
  • Cause : L'API non è stata attivata da Avantio per il tuo account.
  • Soluzione : È il problema di avvio più comune. Contatta nuovamente il supporto di Avantio (contact@avantio.com) e chiedi loro di confermare che l'integrazione Minut sia stata attivata anche dal loro lato.   
• Sintomo 2 : Una nuova proprietà aggiunta in Avantio non appare nella lista a tendina per l'associazione in Minut.
  • Causa e Soluzione :
    1. Ritardo di sincronizzazione dell'API: L'API di Avantio potrebbe non aggiornarsi istantaneamente. Si consiglia di attendere fino a 24 ore affinché la nuova proprietà venga sincronizzata.   
    2. Annuncio incompleto: Verifica che l'annuncio della proprietà sia completamente configurato in Avantio, con almeno una foto e stagioni tariffarie assegnate, poiché questi elementi possono essere richiesti dall'API.   
    3. Se il problema persiste oltre 24 ore, contatta il supporto di Avantio, poiché controllano il flusso di dati dell'API.
• Sintomo 3 : I dati dei viaggiatori (come il numero di telefono) non vengono recuperati, e i messaggi automatizzati non vengono inviati.
  • Causa : Le informazioni di contatto del viaggiatore possono mancare o essere errate nella prenotazione su Avantio.
  • Soluzione : Verifica innanzitutto la prenotazione specifica nella tua interfaccia Avantio per assicurarti che sia registrato un numero di telefono valido. Se i dati sono corretti in Avantio ma non sono sincronizzati, il problema proviene probabilmente dall'API. Contatta il supporto di Avantio affinché esaminino i log dell'API per questa prenotazione.

4.3. Guida di contatto del supporto tecnico

Per una risoluzione efficace, è cruciale contattare la giusta squadra di supporto.

• Contatta il Support Minut (bonjour@minut.com) per :
  • Qualsiasi problema hardware con un sensore (carica, alimentazione).
  • Un sensore che resta "Offline" dopo aver seguito la procedura di risoluzione.
  • Domande sulle funzionalità dell'app Minut (web o mobile), come la configurazione degli avvisi.   
• Contatta il Support Avantio (contact@avantio.com) per :
  • La richiesta iniziale di attivazione dell'integrazione Minut.
  • Le proprietà, le prenotazioni o i dati dei viaggiatori che non si sincronizzano correttamente con Minut.
  • Gli errori che si verificano durante l'autorizzazione sulla piattaforma Avantio.
  • Qualsiasi domanda relativa ai dati provenienti dal tuo PMS.   

Tableau 1: Guida rapida di risoluzione dei problemi dell'integrazione Minut-Avantio

L'integrazione di Minut con Avantio è molto più di una semplice connessione tecnica; rappresenta una tappa decisiva verso una gestione immobiliare più intelligente, più sicura e più scalabile. Seguendo questa guida, i gestori possono mettere in piedi un sistema robusto che protegge i loro asset e migliora l'esperienza dei propri clienti.