Guida Tecnica: Come Integrare Minut con Lodgify

L'integrazione dello strumento di monitoraggio della proprietà Minut con il sistema di gestione delle locazioni stagionali (PMS) Lodgify consente di automatizzare compiti essenziali, dalla comunicazione con i clienti alla protezione dei vostri beni. Sincronizzando i dati di prenotazione di Lodgify con gli avvisi in tempo reale di Minut, è possibile automatizzare le notifiche ai clienti in caso di rumore eccessivo e programmare messaggi chiave durante l'intero soggiorno.   

Questa guida tecnica vi spiega, passo per passo, come collegare le due piattaforme, configurare le automazioni e risolvere i problemi comuni.

Prerequisiti

Prima di iniziare, assicuratevi di disporre dei seguenti elementi :

• Un account Lodgify attivo : È necessario avere accesso a un account Lodgify funzionante.
• Un abbonamento Minut Pro : L'accesso alle integrazioni PMS è una funzionalità premium. Devi avere un abbonamento Minut Pro o superiore.   
• Almeno un sensore Minut : Il tuo sensore deve essere installato e connesso al Wi-Fi della tua proprietà.
• Accesso amministratore : Avrai bisogno delle credenziali di accesso per entrambe le piattaforme. L'integrazione si configura esclusivamente tramite l'applicazione web di Minut (web.minut.com).   

Fase 1 : Ottenere la tua Chiave API Pubblica da Lodgify

La chiave API (Interfaccia di Programmazione delle Applicazioni) è un codice univoco che consente a Minut di accedere in modo sicuro ai dati di prenotazione del tuo account Lodgify.

1. Accedete al vostro account Lodgify.
2. Nel menu principale, navigate verso Impostazioni (Settings).   
3. Nel menu di sinistra, cliccate su API Pubblica (Public API).   
4. La vostra chiave API personale verrà visualizzata. Cliccate sul pulsante Copia per copiarla negli appunti. Assicuratevi di copiare l'intera chiave senza spazi aggiuntivi.   

Fase 2 : Stabilire la Connessione nel Cruscotto di Minut

Ora che avete la chiave API, la userete per stabilire la connessione sulla piattaforma Minut.

1. Aprite una nuova scheda e accedete all'applicazione web di Minut su web.minut.com.
2. Nel menu di sinistra, cliccate su Integrazioni (Integrations).   
3. Scorrete fino alla sezione dei sistemi di gestione degli immobili (PMS) e trovate Lodgify.
4. Cliccate sul pulsante Connetti (Connect) associato a Lodgify.   
5. Si aprirà una finestra che vi chiederà di inserire la vostra chiave API. Incollate la chiave API che avete copiato da Lodgify al passo 1.   
6. Cliccate nuovamente su Connetti per convalidare. Un messaggio di conferma apparirà se la connessione è riuscita.

Fase 3 : Mappare le vostre Proprietà (Fase Critica)

Questa fase è essenziale per garantire che gli avvisi e i messaggi vengano inviati ai clienti corretti. Dovete indicare a Minut quale sensore corrisponde a quale proprietà in Lodgify.

1. Dopo aver stabilito la connessione, rimanete nella configurazione dell'integrazione Lodgify in Minut e andate nella scheda Unità di locazione (Rental units).   
2. Minut mostrerà l'elenco dei vostri sensori da un lato e l'elenco delle vostre proprietà importate da Lodgify dall'altro.
3. Per ogni sensore Minut, utilizzare il menu a discesa per selezionare e associare la proprietà Lodgify corrispondente.   
4. Ripetete questo processo per tutte le proprietà che desiderate monitorare.

Importante : Un errore di mappatura può comportare l'invio di notifiche al cliente sbagliato. Prendetevi il tempo per verificare attentamente ogni associazione.

Fase 4 : Configurare la Comunicazione Automatica

Una volta attiva l'integrazione, potete configurare le comunicazioni automatizzate per gli avvisi di rumore e i messaggi programmati.

Avvisi di Rumore

1. Nella dashboard di Minut, andate su Impostazioni (Settings) -> Monitoraggio (Monitoring) -> Monitoraggio del rumore (Noise monitoring).
2. Attivate i canali di comunicazione che desiderate utilizzare :
   • SMS al cliente : Invia un messaggio di testo automatico al numero di telefono sincronizzato da Lodgify.
   • Autocall : Effettua una chiamata telefonica automatizzata con un messaggio preregistrato.
   • Flash & Sound : Fa lampeggiare il sensore in rosso e emette un suono per avvertire direttamente gli occupanti.
3. Potete personalizzare il messaggio e creare una sequenza di escalation per il primo, secondo e terzo avvertimento.   

Messaggi Programmati (Guest Connect)

Usate questa funzionalità per inviare messaggi di benvenuto, di arrivo o di partenza.

1. Nella dashboard di Minut, andate nella sezione Messaggistica (Messaging).
2. Cliccate su Aggiungi un messaggio per creare un nuovo modello.
3. Redigete il vostro messaggio utilizzando dei shortcode per personalizzarlo. Queste variabili verranno automaticamente sostituite dalle informazioni della prenotazione.
   • {{stay_contact_name}} : Nome del cliente.
   • {{rental_unit_name}} : Nome della proprietà.
   • {{stay_start_date}} : Data di arrivo.
   • {{stay_end_date}} : Data di partenza.
4. Programmate l'invio del messaggio in base alle date di soggiorno (ad esempio, "3 giorni prima dell'arrivo").   

Risoluzione dei problemi comuni

• Errore di connessione della chiave API :
  • Causa : La chiave API è stata copiata male o il tuo account Lodgify non ha i permessi necessari.
  • Soluzione : Copiate accuratamente la chiave API da Lodgify. Assicuratevi di utilizzare un account amministratore. Se il problema persiste, svuotate la cache del vostro browser o provate a scollegare e ricollegare l'integrazione.   
• Le proprietà o le prenotazioni non si sincronizzano :
  • Causa : La sincronizzazione iniziale può richiedere tempo, soprattutto per un grande numero di proprietà. Potrebbe anche esserci un errore di mappatura.
  • Soluzione : Attendere fino a un'ora dopo la connessione. Verificate che tutte le vostre proprietà siano correttamente mappate nella scheda "Unità di locazione". Alcune piattaforme offrono un pulsante per forzare un aggiornamento manuale ("Request Pull").   
• I messaggi automatici non vengono inviati :
  • Causa : Il numero di telefono del cliente è mancante o incorretto in Lodgify, oppure il paese del numero non è supportato dal servizio SMS di Minut (es.: Emirati Arabi Uniti, Malesia, Singapore).   
  • Soluzione : Verificate le informazioni di contatto del cliente in Lodgify. Assicuratevi che gli alert SMS siano attivi nelle impostazioni di monitoraggio del rumore di Minut.   

Se i problemi persistono, è consigliabile contattare l'assistenza di Minut per questioni relative all'integrazione e al funzionamento dei sensori, e l'assistenza di Lodgify per problemi relativi alla chiave API o ai dati di prenotazione.