L’intégration Cloudbeds : ce que Converstay lit, et ce qu’il ne touche jamais

Converstay ne fonctionne qu’avec Cloudbeds. Il se connecte avec une clé API en lecture seule, trois webhooks de réservation et un extrait de code sur le moteur de réservation. Voici exactement ce que fait chaque partie, pour l’hôtel et pour la personne qui gère votre compte Cloudbeds.

Mis à jour le 16 novembre 2026

Les trois parties

  • Une clé API en lecture seule que vous créez dans Cloudbeds, avec un accès en lecture à Hotel, Rate, Reservation et Room.
  • Trois webhooks auxquels Converstay s’abonne avec cette clé : réservation créée, statut de réservation modifié et dates de réservation modifiées.
  • Un extrait de code d’une ligne dans le Custom JavaScript du moteur de réservation, ou dans Google Tag Manager, qui repère quand un client saisit son e-mail puis part.

Ce que Converstay lit dans Cloudbeds

Tout ce qu’il lit sert à rendre l’e-mail du client exact et à compter les réservations honnêtement :

Données CloudbedsPourquoi
Hôtel : nom, adresse, devise, fuseau horaireL’expéditeur, le pied de l’e-mail et les prix dans votre devise
Chambres : noms et photosLe client voit la chambre qu’il a choisie, avec sa photo
Tarifs et disponibilitésLe tarif actuel pour ses dates, les alertes de baisse de prix et la vérification des dates complètes
Réservations : e-mail du client, dates, statut, totalNe plus écrire aux clients qui ont réservé, et rapprocher chaque réservation revenue

La clé ne peut rien créer, modifier ni annuler dans Cloudbeds. Converstay ne voit jamais les données de carte : le paiement se fait sur le moteur de réservation de Cloudbeds lui-même, et l’extrait de code ne lit pas l’étape de paiement.

Ce que fait l’extrait de code sur le moteur de réservation

L’extrait de code charge le traceur de Converstay sur votre moteur de réservation Cloudbeds. Il suit les étapes du client, enregistre la chambre, les dates, le tarif et la langue choisis, et enregistre son e-mail dès qu’il le saisit dans le formulaire de coordonnées. Rien n’est envoyé à un client qui n’a jamais saisi d’e-mail.

Il peut aussi afficher les cartes facultatives que vous activez dans le tableau de bord : vos avantages à réserver en direct quand un client part vers un autre onglet, Send My Stay, une note indiquant que d’autres clients regardent les mêmes dates, et d’autres liens de réservation quand une date est complète. Chacune reste désactivée tant que vous ne l’activez pas.

Comment les réservations sont rapprochées

Quand Cloudbeds signale une nouvelle réservation à Converstay, celui-ci cherche un client parti du moteur de réservation avec le même e-mail, dans le même hôtel. Un rapprochement arrête les e-mails encore en attente, et si Converstay avait déjà écrit à ce client, la réservation compte comme récupérée.

Les réservations qui arrivent sans e-mail sont rapprochées par hôtel, par dates et sur une fenêtre de deux heures autour du moment où le client est parti. Les annulations et les changements de dates arrivent par les deux autres webhooks : une réservation annulée cesse donc de compter le jour même. Les réservations faites par téléphone, par WhatsApp ou à la réception comptent aussi, avec leur canal indiqué, quand l’e-mail du client correspond.

La mise en place

Le tableau de bord vous guide et vérifie chaque étape. En bref :

  1. Dans Cloudbeds, ouvrez Account → Apps & Marketplace → API Credentials et créez une credential nommée Converstay.
  2. Créez sa clé API en cochant R (lecture) pour Hotel, Rate, Reservation et Room, puis collez la clé dans Converstay. Les webhooks sont abonnés pour vous.
  3. Collez l’extrait de code dans Booking Engine → Customize → Custom JavaScript, ou ajoutez-le à Google Tag Manager.
  4. Connectez votre domaine d’envoi et approuvez les e-mails quand ils vous conviennent.

Le guide complet, avec les problèmes fréquents, se trouve dans la relance sur Cloudbeds.

Tout désactiver

Supprimez la clé API dans Cloudbeds et retirez l’extrait de code du moteur de réservation : Converstay cesse aussitôt de lire quoi que ce soit. Vous pouvez nous demander de supprimer les données de votre hôtel à tout moment, comme le décrit la politique de confidentialité.

Questions

Converstay est-il sur le Marketplace de Cloudbeds ?

Pas encore. Converstay se connecte avec une clé API que vous créez dans votre propre compte Cloudbeds, ce qui fonctionne avec toute offre Cloudbeds qui inclut l’accès à l’API.

Converstay peut-il modifier mes réservations ou mes tarifs ?

Non. La clé est en lecture seule : Hotel, Rate, Reservation et Room. Elle ne peut rien créer, modifier ni annuler.

Quels webhooks Cloudbeds Converstay utilise-t-il ?

Réservation créée, statut de réservation modifié et dates de réservation modifiées. Ils lui permettent d’arrêter les e-mails dès qu’un client réserve et de retirer les annulations du décompte.

Est-ce que cela fonctionne avec Cloudbeds Booking Engine Plus ?

Oui. L’extrait de code va dans le Custom JavaScript du moteur de réservation, ou dans Google Tag Manager si votre moteur de réservation l’utilise.

Sources