L'integrazione con Cloudbeds: cosa legge Converstay, e cosa non tocca mai

Converstay funziona solo con Cloudbeds e si collega con una chiave API in sola lettura, tre webhook delle prenotazioni e uno snippet sul motore di prenotazione. Ecco cosa fa esattamente ogni parte, per l'hotel e per chi si occupa del tuo account Cloudbeds.

Aggiornato il 16 novembre 2026

Le tre parti

  • Una chiave API in sola lettura che crei in Cloudbeds, con accesso in lettura a Hotel, Rate, Reservation e Room.
  • Tre webhook a cui Converstay si iscrive con quella chiave: prenotazione creata, stato della prenotazione cambiato e date della prenotazione cambiate.
  • Uno snippet di una riga nel Custom JavaScript del motore di prenotazione, o in Google Tag Manager, che si accorge quando un ospite inserisce la sua email e se ne va.

Cosa legge Converstay da Cloudbeds

Tutto ciò che legge serve a rendere esatta l'email all'ospite e a contare le prenotazioni in modo onesto:

Dati di CloudbedsPerché
Hotel: nome, indirizzo, valuta, fuso orarioIl mittente, il piè di pagina dell'email e i prezzi nella tua valuta
Camere: nomi e fotoL'ospite vede la camera che ha scelto, con la sua foto
Tariffe e disponibilitàLa tariffa attuale per le sue date, gli avvisi di calo prezzo e il controllo del tutto esaurito
Prenotazioni: email dell'ospite, date, stato, totaleSmettere di scrivere agli ospiti che hanno prenotato, e abbinare ogni prenotazione tornata

La chiave non può creare, modificare o cancellare nulla in Cloudbeds. Converstay non vede mai i dati delle carte: il pagamento avviene sul motore di prenotazione di Cloudbeds, e lo snippet non legge il passaggio del pagamento.

Cosa fa lo snippet sul motore di prenotazione

Lo snippet carica il tracker di Converstay sul tuo motore di prenotazione Cloudbeds. Segue i passaggi dell'ospite, salva la camera, le date, la tariffa e la lingua che ha scelto, e salva la sua email quando la inserisce nel modulo dei dati dell'ospite. Chi non ha mai inserito un'email non riceve nulla.

Può anche mostrare le schede facoltative che attivi nella dashboard: i vantaggi di prenotare diretto quando un ospite passa a un'altra scheda, Send My Stay, un avviso che altri ospiti stanno guardando le stesse date e altri link di prenotazione quando una data è esaurita. Ognuna resta spenta finché non la attivi.

Come si abbinano le prenotazioni

Quando Cloudbeds comunica a Converstay una nuova prenotazione, Converstay cerca un ospite che ha lasciato il motore di prenotazione con la stessa email nello stesso hotel. Un abbinamento ferma le email ancora in attesa, e se Converstay aveva già scritto a quell'ospite, la prenotazione conta come recuperata.

Le prenotazioni che arrivano senza email vengono abbinate per hotel, date e una finestra di due ore attorno al momento in cui l'ospite se n'è andato. Cancellazioni e cambi di date arrivano dagli altri due webhook, quindi una prenotazione cancellata smette di contare il giorno stesso. Contano anche le prenotazioni fatte al telefono, su WhatsApp o alla reception, indicate per canale, quando l'email dell'ospite corrisponde.

Configurarla

La dashboard ti guida e verifica ogni passaggio. In breve:

  1. In Cloudbeds, apri Account → Apps & Marketplace → API Credentials e crea una credenziale chiamata Converstay.
  2. Crea la sua chiave API con R (lettura) spuntato per Hotel, Rate, Reservation e Room, e incolla la chiave in Converstay. I webhook vengono attivati per te.
  3. Incolla lo snippet in Booking Engine → Customize → Custom JavaScript, oppure aggiungilo a Google Tag Manager.
  4. Collega il tuo dominio di invio e approva le email quando ti convincono.

La guida completa, con i problemi più comuni, è in ricontattare gli ospiti su Cloudbeds.

Disattivarla

Elimina la chiave API in Cloudbeds e rimuovi lo snippet dal motore di prenotazione, e Converstay smette subito di leggere qualsiasi cosa. Puoi chiederci in qualsiasi momento di cancellare i dati del tuo hotel, come descrive l'informativa sulla privacy.

Domande

Converstay è nel Marketplace di Cloudbeds?

Non ancora. Converstay si collega con una chiave API che crei nel tuo account Cloudbeds, e funziona con qualsiasi piano Cloudbeds che includa l'accesso alle API.

Converstay può modificare le mie prenotazioni o tariffe?

No. La chiave è in sola lettura: Hotel, Rate, Reservation e Room. Non può creare, modificare o cancellare nulla.

Quali webhook di Cloudbeds usa Converstay?

Prenotazione creata, stato della prenotazione cambiato e date della prenotazione cambiate. Gli permettono di fermare le email appena un ospite prenota e di togliere le cancellazioni dal conteggio.

Funziona con Cloudbeds Booking Engine Plus?

Sì. Lo snippet va nel Custom JavaScript del motore di prenotazione, o in Google Tag Manager se il tuo motore di prenotazione lo usa.

Fonti