Hostaway si collega con l'Account ID e una chiave API creata nel Marketplace di Hostaway. Poi aggiungi un webhook per ricevere le prenotazioni più in fretta.
Cosa ti serve
il modulo Integrazioni attivo su almeno un appartamento;
un utente Hostaway che può usare il Marketplace e le impostazioni.
In Hostaway: creare la chiave API
Vai su Marketplace e cerca Vikey.
Clicca Connect: si apre una nuova scheda, clicca di nuovo Connect.
Nel riquadro Create public API secret key for Vikey clicca Create.
Annota Account ID e API key: la chiave si vede per intero solo ora.
In Vikey: inserire i codici
Vai su Amministrazione › Integrazioni e clicca Aggiungi integrazione.
Scrivi Hostaway nel campo Integrazione e clicca il logo.
In Account scegli il tuo account Vikey.
In
Account IDincolla l'Account ID di Hostaway.In
ApiKeyincolla la chiave creata per Vikey.Clicca Attiva: compare Risorsa creata e si apre la pagina dell'integrazione.
Collegare gli appartamenti
In Amministrazione › Integrazioni clicca la card HOSTAWAY.
Sulla riga con Nessun collegamento attivo! clicca Aggiungi integrazione.
In Appartamento scegli l'appartamento Vikey, spunta Abilita comunicazione email e Invia documenti, poi Salva.
Ripeti per ogni appartamento, poi clicca Importa prenotazioni.
Hostaway ha due modalità: PROPS (strutture) e ROOMS (camere).
Ultimo passo: il webhook
Dopo Attiva, in Vikey annota il numero dell'integrazione (lo trovi alla fine dell'indirizzo della pagina dell'integrazione). In Hostaway vai su Settings › Integrations, sezione Unified webhooks, incolla https://integrations.vikey.it/hostaway/NUMERO (al posto di NUMERO il numero dell'integrazione) e clicca Add.
Opzione in più
Nella finestra di collegamento trovi anche Invia i dati di fatturazione indietro al PMS/CM
Problemi comuni
Problemi comuni
Messaggio rosso dopo Attiva
Perché: account ID e chiave invertiti, o chiave incompleta.
Cosa fare: Account ID nel primo campo, ApiKey nel secondo.
Le prenotazioni arrivano in ritardo
Perché: manca il webhook.
Cosa fare: Aggiungilo in Settings › Integrations › Unified webhooks.
Ho perso la chiave
Perché: hostaway la mostra per intero solo alla creazione.
Cosa fare: Creane una nuova dal Marketplace, elimina l'integrazione e ricollegala.
Campi non validi, controlla e riprova
Perché: non hai scelto l'Account.
Cosa fare: Scegli l'account Vikey e clicca di nuovo Attiva.
Impossibile completare la richiesta o un altro messaggio rosso dopo Attiva
Perché: il gestionale ha rifiutato i codici: sbagliati, incompleti o con uno spazio in più.
Cosa fare: Copia di nuovo i codici dal gestionale, senza spazi prima o dopo, e riprova.
Nessun appartamento trovato
Perché: vikey sta ancora leggendo l'elenco dal gestionale (fino a 1 ora).
Cosa fare: Aspetta un'ora, poi clicca Aggiorna appartamento. Se è ancora vuoto contatta l'assistenza.
Le prenotazioni non arrivano
Perché: l'appartamento non è abbinato: la riga è grigia con Nessun collegamento attivo!
Cosa fare: Clicca Aggiungi integrazione sulla riga e scegli l'appartamento Vikey.
Arrivano solo le prenotazioni nuove
Perché: le prenotazioni già presenti non sono ancora state scaricate.
Cosa fare: Clicca Importa prenotazioni nella pagina dell'integrazione.
Il check-in online non parte
Perché: nel collegamento non sono attive Abilita comunicazione email e Invia documenti.
Cosa fare: Clicca Modifica sulla riga, spunta le due opzioni e Salva.
Ho cambiato le opzioni ma le prenotazioni non cambiano
Perché: le opzioni valgono solo per le prenotazioni importate dopo.
Cosa fare: Modifica a mano le prenotazioni già presenti.
Prima di contattare l'assistenza
Indica il nome del gestionale (Hostaway), il numero tra parentesi nella card dell'integrazione, l'appartamento interessato, il codice di una prenotazione che non è arrivata e il testo esatto del messaggio che vedi.