Come collegare Smoobu a HazCheckin: prenotazioni e schedine alloggiati automatiche

Se gestisci le tue strutture con Smoobu, HazCheckin si collega direttamente al tuo account: importa le tue proprietà e riceve ogni prenotazione con i dati dell’ospite — nome, email e telefono. Da lì in poi, il flusso di sempre: l’ospite fa il check-in online prima di arrivare, tu confermi l’arrivo e l’identità con un clic e le schedine alloggiati partono verso Alloggiati Web entro le 24 ore previste dalla legge (6 ore per i soggiorni non superiori a 24 ore).

Cosa fa l’integrazione

• Importa le tue proprietà di Smoobu in HazCheckin, con nome, indirizzo, capienza e posizione — oppure le collega a proprietà che hai già creato.
• Sincronizza le prenotazioni in automatico. Ogni prenotazione di Smoobu compare nella tua dashboard con l’ospite principale e i suoi dati di contatto; i blocchi di calendario non vengono importati.
• Invia il link di check-in senza che tu faccia nulla, perché la prenotazione arriva con l’email dell’ospite — a differenza della sincronizzazione via iCal, che porta solo le date.
• Rispetta il tuo lavoro. La sincronizzazione tocca solo le prenotazioni che non hai ancora gestito: se una ha già il check-in completato o le schedine trasmesse, nessuna modifica in Smoobu la cambia in silenzio.

Requisiti

Un account Smoobu (tutti gli account includono l’accesso alla API, senza costi aggiuntivi) e un account HazCheckin con almeno il periodo di prova attivo. Per trasmettere le schedine ti serviranno anche le credenziali di Alloggiati Web della tua struttura: se non le hai ancora, leggi come ottenere le credenziali della Questura e la chiave web service.

Passo 1: crea la tua API key in Smoobu

1. Accedi al tuo account Smoobu.
2. Vai in Settings → Advanced → API Keys.
3. Clicca su Create API Key, dalle un nome (per esempio «HazCheckin») e usa Generate Secret per creare il secret.
4. Copia la API key e l’API secret: il secret viene mostrato una sola volta. Se lo perdi, generane uno nuovo.

Tratta entrambi i valori come una password: danno accesso al tuo account Smoobu.

Passo 2: collega HazCheckin

1. Nella tua dashboard HazCheckin, vai in Integrazioni (menu laterale).
2. Incolla la API key e l’API secret nella scheda di Smoobu e clicca su Collega Smoobu.
3. HazCheckin verifica subito le credenziali con Smoobu e le salva cifrate; vengono usate solo per leggere le tue proprietà e le tue prenotazioni.

Passo 3: attiva il webhook (consigliato)

Smoobu segnala le nuove prenotazioni in tempo reale tramite un webhook, ma l’URL va configurato dal tuo account Smoobu:

1. Dopo il collegamento, HazCheckin ti mostra il tuo URL di webhook nella scheda di Smoobu — copialo con il pulsante.
2. In Smoobu, vai in Settings → For developers e incolla l’URL nel campo Webhook.
3. Salva. Alla prima notifica, la scheda passerà a «Webhook attivo».

Se salti questo passo non succede nulla: HazCheckin controlla comunque il tuo account Smoobu una volta all’ora. Il webhook accelera solo l’arrivo delle nuove prenotazioni.

Passo 4: collega o importa le tue proprietà

Dopo il collegamento vedrai l’elenco delle tue proprietà di Smoobu. Per ciascuna puoi:

• Importarla come nuova proprietà: HazCheckin la crea con nome, indirizzo, capienza e posizione. Poi ti basta controllare i dati e inserire le credenziali di Alloggiati Web nella sezione Informazioni legali della proprietà (Utente, Password e WSKEY; l’ID appartamento solo se il tuo account ha la Gestione Appartamenti). Al salvataggio HazCheckin verifica le credenziali con il portale e, se funzionano, mostra il badge «credenziali verificate».
• Collegarla a una proprietà esistente: scegli la proprietà dal menu a tendina e clicca su Collega.

Vengono sincronizzate solo le prenotazioni delle proprietà collegate.

E dopo? La schedina alloggiati si fa da sola

Ogni prenotazione importata da Smoobu riceve il suo link di check-in. L’ospite scansiona il documento dal telefono, compila i dati che la schedina richiede (luogo di nascita, luogo di rilascio del documento, tipo di ospite per famiglie e gruppi) e firma. Quando arriva, tu confronti la persona con il documento e clicchi su Conferma arrivo e identità nella scheda «Alloggiati Web — Polizia di Stato» della prenotazione: HazCheckin verifica le schedine e le trasmette alla Questura con le credenziali della tua struttura, riprova ogni ora se manca qualcosa e archivia la ricevuta giornaliera per 5 anni. Il funzionamento completo è spiegato nella guida ad Alloggiati Web.

Domande frequenti

Quali prenotazioni vengono importate?

Tutte le prenotazioni reali delle tue proprietà collegate, che arrivino da Airbnb, Booking.com, dal tuo sito o create a mano in Smoobu. I blocchi di calendario (canale «Blocked») non generano una prenotazione in HazCheckin.

Cosa succede se cancello una prenotazione in Smoobu?

Se in HazCheckin era ancora in attesa o confermata, viene cancellata automaticamente. Se aveva già il check-in completato o le schedine trasmesse, non viene toccata — quel caso lo gestisci tu dalla dashboard.

Devo comunque confermare l’arrivo di ogni ospite?

Sì. La legge richiede che la struttura verifichi l’identità dell’ospite di persona, confrontando la persona con il documento: un modulo online da solo non basta (Consiglio di Stato, sentenza n. 9101 del 21 novembre 2025). Per questo HazCheckin raccoglie i dati prima dell’arrivo ma trasmette le schedine solo dopo la tua conferma. Ne parliamo in dettaglio nella guida su check-in online e identificazione degli ospiti in Italia.

Posso scollegare Smoobu?

Sì, dalla stessa pagina Integrazioni. Le proprietà e le prenotazioni già importate restano; semplicemente smettono di sincronizzarsi.

Posso usare Smoobu e un altro PMS contemporaneamente?

Sì. Ogni integrazione è indipendente e ogni proprietà di HazCheckin è collegata a una sola origine, quindi puoi combinare proprietà di Smoobu, di Guesty, di Lodgify, di Cloudbeds e calendari iCal nello stesso account.