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
Aggiungi l'integrazione: scegli il gestionale e collegalo (capitolo 3).
Collega gli appartamenti: abbina ogni appartamento del gestionale al suo appartamento Vikey (capitolo 4).
Scegli le opzioni: orari, email, documenti, pagamenti, contratto (capitolo 5).
Le guide dei singoli gestionali
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…
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
3. Aggiungere un'integrazione
Vai su Amministrazione › Integrazioni e clicca Aggiungi integrazione.
Scrivi il nome del gestionale nel campo Integrazione e clicca il suo logo.
Il passo successivo dipende dal gestionale: vedi sotto.
Gestionali che si collegano con i codici
Gestionali che si collegano con i codici
È il caso della maggior parte dei gestionali (WuBook, Zak, Beds24, Smoobu, Guesty, KrossBooking, Hostaway, Lodgify, Mews…).
In Account scegli il tuo account Vikey.
Compila i campi: hanno i nomi tecnici del gestionale (per esempio
ApiKey,PropKey,HotelId). Dove trovarli è spiegato nella guida del tuo gestionale (capitolo 1).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 e gestionali che si collegano con il loro accesso
Airbnb, Octorate, Cloudbeds, Hospitable, Hostfully, Hostex, BBPlanner e BookingSync: non servono codici.
Clicca Connect with ….
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
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
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.
In Amministrazione › Integrazioni clicca la card dell'integrazione.
In Appartamenti su … trovi a sinistra (in verde) gli appartamenti del gestionale.
Sulla riga con Nessun collegamento attivo! clicca Aggiungi integrazione.
In Appartamento scegli l'appartamento Vikey corrispondente.
Imposta le opzioni (capitolo 5): almeno Abilita comunicazione email e Invia documenti, che servono al check-in online.
Clicca Salva: la riga diventa azzurra. Ripeti per ogni appartamento.
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
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
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
Vai su Amministrazione › Integrazioni e clicca la card dell'integrazione.
Clicca Importa prenotazioni in alto.
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
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.
Non eliminare l'integrazione bloccata.
Clicca Aggiungi integrazione, scegli Airbnb e accedi con l'account del titolare dell'annuncio.
Controlla che gli annunci mostrino Nessun collegamento attivo! e fermati qui: non abbinare gli appartamenti.
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:
WhatsApp: attiva il modulo Messaging (o Messaging Lite) dallo Shop e, nel collegamento, i messaggi WhatsApp.
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
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
9. Eliminare un'integrazione
Apri la pagina dell'integrazione.
Clicca Elimina (rosso, in alto) e conferma con Elimina.
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.




