Vai al contenuto principale

Integrazioni - guida al collegamento del proprio portale per importare tutte le prenotazioni in Vikey e risoluzione dei problemi

collega il tuo PMS/CM o OTA (booking o Airbnb) con la dashboard Vikey

Con le Integrazioni colleghi Vikey ad Airbnb, al tuo gestionale (PMS) o al tuo Channel Manager: le prenotazioni arrivano in Vikey da sole e l'ospite riceve in automatico il link per il check-in online.

Le parole da conoscere

Parola

Cosa vuol dire

PMS (gestionale)

Il programma con cui gestisci la struttura, per esempio Mews o KrossBooking

Channel Manager

Il programma che tiene allineati calendario e prenotazioni dei portali, per esempio Octorate, WuBook o Beds24

Integrazione

Il collegamento tra Vikey e uno di questi programmi, oppure Airbnb

Collegamento dell'appartamento

L'abbinamento tra un appartamento del gestionale e il suo appartamento Vikey. Senza questo non arriva nessuna prenotazione

Card

Il riquadro di ogni integrazione nella pagina Integrazioni

Cosa ti serve

  • il modulo Integrazioni attivo su almeno un appartamento. Se non è attivo compare l'avviso INTEGRAZIONI (Stato inattivo): clicca Acquista modulo;

  • per Airbnb: l'account del titolare dell'annuncio;

  • per un gestionale: i codici di collegamento. Prima di iniziare chiedi al supporto del tuo gestionale se il tuo profilo è abilitato all'integrazione con Vikey.

Booking.com

Booking.com non si collega direttamente a Vikey: si integra solo con Channel Manager e PMS. Puoi: collegare il tuo Channel Manager o PMS (meglio se partner Vikey); usare il Channel Manager Vikey; oppure inserire le prenotazioni a mano da Prenotazioni › Nuova prenotazione.

Come funziona, in breve

  1. Aggiungi l'integrazione: scegli il gestionale e collegalo (capitolo 3).

  2. Collega gli appartamenti: abbina ogni appartamento del gestionale al suo appartamento Vikey (capitolo 4).

  3. Scegli le opzioni: orari, email, documenti, pagamenti, contratto (capitolo 5).

Le guide dei singoli gestionali

Dove trovare i codici e i problemi tipici di ogni gestionale sono nel suo articolo:

Gestionale

Come si collega

Articolo

Airbnb

accesso ad Airbnb

Beds24

codici

Cloudbeds

accesso a Cloudbeds

Guesty

codici

Hostaway

codici + webhook

KrossBooking

codici

Lodgify

codici

Mews

codici

Octorate

accesso a Octorate

Smoobu

codici

WuBook

codici

WuBook Zak

codici


2. Cosa faccio se…

Ho ricevuto una prenotazione ma in Vikey non c'è ancora

È normale: le prenotazioni arrivano in Vikey da 60 a 120 minuti dopo che sono state create nel gestionale.

Se l'ospite arriva a breve, falla arrivare subito: Amministrazione › Integrazioni, clicca la card dell'integrazione, poi Importa prenotazioni in alto. Quando compare Operazione completata la prenotazione arriva in pochi istanti e l'ospite riceve le comunicazioni.

Se dopo 2 ore non c'è ancora, controlla le domande qui sotto.


Da un appartamento non arriva nessuna prenotazione

Apri la card dell'integrazione e cerca l'appartamento: se la riga è grigia con Nessun collegamento attivo! l'appartamento non è collegato. Clicca Aggiungi integrazione sulla riga, scegli l'appartamento Vikey e Salva (capitolo 4). Poi clicca Importa prenotazioni.


Non arriva più nessuna prenotazione dal mio gestionale

Guarda la card dell'integrazione in Amministrazione › Integrazioni:

  • badge rosso BLOCK (Airbnb): vedi la domanda successiva;

  • stato in rosso invece di ACTIVE in verde: di solito hai cambiato password, chiave o token nel gestionale. Elimina l'integrazione e ricollegala con i nuovi codici (capitolo 3 e la guida del tuo gestionale).


Sulla card Airbnb vedo BLOCK

L'autorizzazione Airbnb non vale più, di solito perché hai cambiato le credenziali Airbnb o aggiunto nuovi annunci. Non eliminare l'integrazione: clicca leggi come sbloccare l'integrazione Airbnb sulla card e segui la procedura (capitolo 7 o articolo).


L'ospite non ha ricevuto la mail per il check-in online

  • Nel collegamento dell'appartamento deve essere attiva Abilita comunicazione email (capitolo 5).

  • I promemoria a 7, 3 e 1 giorno partono solo se l'ospite non ha ancora fatto il check-in online.

  • Se la prenotazione è Bloccata per una sovrapposizione, l'ospite non riceve messaggi: vedi la domanda successiva.

  • Prenotazioni Airbnb che arrivano da un Channel Manager: da ottobre 2023 Airbnb non passa più l'email dell'ospite. Soluzioni nel capitolo 7.

  • Prenotazioni Booking.com: se l'ospite vede i link oscurati, autorizza i domini Vikey nell'extranet di Booking (guida).

  • Per inviare subito la mail a un ospite: apri la prenotazione e inviala a mano.


La prenotazione importata risulta Bloccata

Si sovrappone a un'altra prenotazione dello stesso appartamento: Vikey la crea comunque (il portale l'ha già confermata), ma blocca il check-in e ti manda un'email di overbooking. Finché è bloccata l'ospite non riceve messaggi e non può completare il check-in.

Si sblocca da sola quando il conflitto sparisce: cancella una delle due prenotazioni o spostala su date libere. I messaggi saltati non vengono reinviati: se l'arrivo è vicino, manda tu il link di check-in. Dettagli.


Le prenotazioni Airbnb compaiono due volte

Le ricevi sia da Airbnb collegato direttamente sia dal tuo Channel Manager. Sull'integrazione del Channel Manager, in ogni collegamento, spunta Non aggiungere prenotazioni che provengono da questi channel › Airbnb (capitolo 7). I doppioni creati durante la prima configurazione vanno cancellati a mano; dopo non se ne creano più.


Ho cambiato le opzioni ma le prenotazioni già presenti non cambiano

Le opzioni del collegamento valgono solo per le prenotazioni che arrivano dopo la modifica. Per quelle già presenti apri la singola prenotazione e cambia l'opzione nella scheda Check-in online.


Voglio chiedere (o non chiedere più) le foto dei documenti

Amministrazione › Integrazioni, apri la card, clicca Modifica sulla riga dell'appartamento e, sotto Invia documenti, spunta o togli Richiedi foto documento ospite principale e Richiedi foto documento ospiti aggiuntivi. Con solo Invia documenti attivo l'ospite inserisce i dati senza foto.


Voglio smettere di inviare email automatiche da un'integrazione

Clicca Modifica sulla riga dell'appartamento, togli la spunta a Abilita comunicazione email e Salva. Vale per le nuove prenotazioni; per quelle già presenti disattiva l'email nella singola prenotazione.


Dopo il collegamento vedo «Nessun appartamento trovato»

Vikey sta leggendo l'elenco dal gestionale: può servire fino a 1 ora. Poi clicca Aggiorna appartamento. Se è ancora vuoto, contatta l'assistenza.


Un'opzione è grigia o Aggiungi integrazione è grigio

Cosa è grigio

Cosa serve

Aggiungi integrazione

Modulo Integrazioni: clicca Acquista modulo

SMS e WhatsApp

Modulo Messaging: clicca Attiva il modulo

Pagamenti

Account Stripe collegato all'appartamento (Appartamenti › Connessioni › Stripe)

Tassa di soggiorno

Modulo Tassa Turistica e regole nella scheda Tasse dell'appartamento

Contratto

Modulo Contratti e almeno un contratto creato

Importa prenotazioni

Hai appena cliccato: aspetta 1 minuto


3. Aggiungere un'integrazione

  1. Vai su Amministrazione › Integrazioni e clicca Aggiungi integrazione.

  2. Scrivi il nome del gestionale nel campo Integrazione e clicca il suo logo.

  3. Il passo successivo dipende dal gestionale: vedi sotto.

Gestionali che si collegano con i codici

È il caso della maggior parte dei gestionali (WuBook, Zak, Beds24, Smoobu, Guesty, KrossBooking, Hostaway, Lodgify, Mews…).

  1. In Account scegli il tuo account Vikey.

  2. Compila i campi: hanno i nomi tecnici del gestionale (per esempio ApiKey, PropKey, HotelId). Dove trovarli è spiegato nella guida del tuo gestionale (capitolo 1).

  3. Clicca Attiva: compare Risorsa creata e si apre la pagina dell'integrazione.

⚠️ Se compare Campi non validi, controlla e riprova non hai scelto l'Account. Se compare un altro messaggio rosso, i codici sono sbagliati, invertiti o con uno spazio in più: ricopiali.

Airbnb e gestionali che si collegano con il loro accesso

Airbnb, Octorate, Cloudbeds, Hospitable, Hostfully, Hostex, BBPlanner e BookingSync: non servono codici.

  1. Clicca Connect with ….

  2. Accedi al sito del partner e conferma l'autorizzazione a Vikey.

💡 Per Airbnb accedi con l'account del titolare dell'annuncio, non di un co-host.

Gestionali senza campi da compilare

Per alcuni gestionali (Siteminder, RoomRaccoon, Scidoo, ePrenotazioni, Direct Holiday, ItalianWay) la finestra mostra solo Account, senza Attiva: contatta l'assistenza Vikey per completare il collegamento.


4. Collegare gli appartamenti

Dopo il collegamento Vikey legge l'elenco degli appartamenti del gestionale (fino a 1 ora). Ora abbini ognuno al suo appartamento Vikey.

  1. In Amministrazione › Integrazioni clicca la card dell'integrazione.

  2. In Appartamenti su … trovi a sinistra (in verde) gli appartamenti del gestionale.

  3. Sulla riga con Nessun collegamento attivo! clicca Aggiungi integrazione.

  4. In Appartamento scegli l'appartamento Vikey corrispondente.

  5. Imposta le opzioni (capitolo 5): almeno Abilita comunicazione email e Invia documenti, che servono al check-in online.

  6. Clicca Salva: la riga diventa azzurra. Ripeti per ogni appartamento.

  7. Clicca Importa prenotazioni per scaricare subito le prenotazioni già presenti.

💡 Per trovare un appartamento usa Ricerca per appartamento e i filtri Filtra per strutture associate / non associate. Per cambiare le opzioni clicca Modifica sulla riga.

⚠️ Elimina sulla riga scollega subito l'appartamento, senza chiedere conferma.

Modalità Integrazione

Alcuni gestionali offrono più modalità (ROOMS = camere, PROPS = annunci/strutture, CHANNEL, ROOMTYPE, UNITS): indicano come Vikey legge le unità del gestionale. In Vikey ogni unità è una camera o un appartamento reale, per questo, dove c'è, è consigliata PROPS: ogni annuncio del gestionale si collega al suo appartamento Vikey.

⚠️ La modalità cambia subito, senza conferma, e cambia l'elenco degli appartamenti. Su un'integrazione che già funziona chiedi all'assistenza prima di cambiarla.


5. Le opzioni del collegamento

Nella finestra Nuova integrazione (o Modifica) decidi cosa succede alle prenotazioni di quell'appartamento. La finestra parte sempre dai valori predefiniti: controlla ogni opzione prima di salvare.

Dati di base

  • Appartamento: l'appartamento Vikey da collegare;

  • Orario Check-in e Orario Check-out (all'inizio 15:00 e 10:00);

  • Check-in Online: la procedura da usare (Vikey Default o una tua);

  • Colore: uno dei 6 colori.


Email e messaggi all'ospite

Spunta Abilita comunicazione email e scegli quando inviare le email:

Opzione

Quando parte

Invia notifica alla creazione

Appena la prenotazione arriva in Vikey, con il link al check-in online

Invia notifica a 7 / 3 / 1 giorno dal check-in

Solo se l'ospite non ha ancora fatto il check-in online

Invia mail di check-in completato 1 giorno prima del check-in

Solo se l'ospite ha finito il check-in e tu hai confermato i documenti

Invia mail di check out

Alla partenza

SMS e WhatsApp (Invia SMS remind, Invia WHATSAPP remind, Abilita comunicazione WhatsApp…) richiedono il modulo Messaging.

⚠️ Se togli la spunta a Abilita comunicazione email si spengono tutte le email sotto. È il modo per non inviare più email da questa integrazione.


Documenti

Spunta Invia documenti perché l'ospite inserisca i dati. Poi scegli se chiedere anche le foto: Richiedi foto documento ospite principale, ospiti aggiuntivi, minorenni (no selfie). Con Nega caricamento da file l'ospite deve scattare la foto; Attiva verifica automatica documenti ospiti richiede il modulo Riconoscimento Biometrico dei Documenti.


Pagamenti

Richiedono un account Stripe collegato all'appartamento: Richiedi pagamento soggiorno, Richiedi pagamento deposito cauzionale (modulo Deposito cauzionale automatico), Richiedi pagamento tassa di soggiorno (modulo Tassa Turistica e regole nella scheda Tasse). In Scegli per quale canale richiedere il pagamento scegli i portali; con Ribalta il costo della commissione sull'ospite la commissione la paga l'ospite.


Contratto e fatturazione

L'ospite dovrà obbligatoriamente accettare il contratto per concludere il check-in richiede il modulo Contratti e almeno un contratto; puoi aggiungere Richiedi verifica OTP e Richiedi firma grafometrica. Richiedi dati di fatturazione chiede all'ospite i dati per la fattura.


Opzioni di alcuni gestionali

Compaiono solo se il gestionale le supporta: Invia i dati degli ospiti una volta confermati al PMS/CM, Aggiorna lo stato della prenotazione sul PMS quando l'ospite entra in struttura, Invia i dati di fatturazione indietro al PMS/CM.


Le modifiche non valgono per le prenotazioni già presenti

Ogni opzione vale solo per le prenotazioni che arrivano dopo il salvataggio. Per quelle già in Vikey apri la singola prenotazione e cambia l'opzione nella scheda Check-in online.


6. Tempi e importazione

Le prenotazioni arrivano in Vikey da 60 a 120 minuti dopo essere state create nel gestionale.


Far arrivare subito una prenotazione

  1. Vai su Amministrazione › Integrazioni e clicca la card dell'integrazione.

  2. Clicca Importa prenotazioni in alto.

  3. Aspetta il messaggio verde Operazione completata: in pochi istanti la prenotazione arriva e l'ospite riceve le comunicazioni impostate.

💡 Dopo il clic il pulsante resta grigio per 1 minuto. Aggiorna appartamento invece rilegge l'elenco degli appartamenti: usalo quando ne aggiungi di nuovi nel gestionale.


Prenotazioni che si sovrappongono

Una prenotazione importata che si sovrappone a un'altra dello stesso appartamento viene creata ma Bloccata: niente check-in né messaggi finché non risolvi il conflitto. Vedi «Cosa faccio se…» (capitolo 2).


7. Airbnb

Sbloccare l'integrazione (BLOCK)

Se hai cambiato le credenziali Airbnb o aggiunto annunci, sulla card compare il badge rosso BLOCK e le prenotazioni non arrivano.

  1. Non eliminare l'integrazione bloccata.

  2. Clicca Aggiungi integrazione, scegli Airbnb e accedi con l'account del titolare dell'annuncio.

  3. Controlla che gli annunci mostrino Nessun collegamento attivo! e fermati qui: non abbinare gli appartamenti.

  4. Scrivi all'assistenza dalla chat della dashboard: sbloccherà l'integrazione.

⚠️ Se completi l'abbinamento da solo rischi prenotazioni doppie e messaggi doppi agli ospiti.


Se usi anche un Channel Manager

Da ottobre 2023 Airbnb non passa più l'email dell'ospite ai Channel Manager: gli ospiti Airbnb che arrivano tramite il Channel Manager non ricevono le email di Vikey (tranne con Smoobu, Guesty, Lodgify, CiaoBooking e AvaiBook). Hai due soluzioni:

  1. WhatsApp: attiva il modulo Messaging (o Messaging Lite) dallo Shop e, nel collegamento, i messaggi WhatsApp.

  2. Airbnb collegato direttamente: (a) sull'integrazione del Channel Manager clicca Modifica su ogni appartamento e spunta Non aggiungere prenotazioni che provengono da questi channel › Airbnb; (b) aggiungi l'integrazione Airbnb (capitolo 3) e collega gli appartamenti (capitolo 4).

💡 Solo durante la prima configurazione possono crearsi prenotazioni doppie: cancellale a mano. Dopo non se ne creano più.


8. Leggere l'elenco delle integrazioni


  • In alto il collegamento, per esempio «Vikey (4821) -> WUBOOK Casa Roma». Il numero tra parentesi serve all'assistenza.

  • Sotto, lo stato: ACTIVE in verde se funziona, in rosso se c'è un problema (BLOCK per Airbnb). Accanto la modalità.

  • Una riga per ogni appartamento del gestionale: a destra l'appartamento Vikey collegato, oppure «--» con Se vuoi collegare il tuo appartamento clicca qui.

  • Le icone colorate sulla riga sono le funzioni attive (email, SMS, documenti, contratto, pagamenti…); quelle sbiadite sono spente.


9. Eliminare un'integrazione

  1. Apri la pagina dell'integrazione.

  2. Clicca Elimina (rosso, in alto) e conferma con Elimina.

  3. Compare Operazione completata.

⚠️ Dopo l'eliminazione le nuove prenotazioni del gestionale non arrivano più in Vikey.


Prima di contattare l'assistenza

Indica: nome del gestionale, numero tra parentesi nella card, appartamento interessato, codice di una prenotazione che non è arrivata e testo esatto del messaggio che vedi.

Hai ricevuto la risposta alla tua domanda?