Die Cloudbeds-Integration: was Converstay liest und was es nie anrührt

Converstay funktioniert nur mit Cloudbeds und verbindet sich über einen reinen Lese-API-Key, drei Reservierungs-Webhooks und ein Snippet in der Buchungsmaschine. Hier steht genau, was jeder Teil tut, für das Hotel und für die Person, die Ihr Cloudbeds-Konto betreut.

Aktualisiert am 16. November 2026

Die drei Teile

  • Ein reiner Lese-API-Key, den Sie in Cloudbeds anlegen, mit Lesezugriff auf Hotel, Rate, Reservation und Room.
  • Drei Webhooks, die Converstay mit diesem Key abonniert: Reservierung angelegt, Reservierungsstatus geändert und Reservierungsdaten geändert.
  • Ein einzeiliges Snippet im Custom JavaScript der Buchungsmaschine oder im Google Tag Manager, das bemerkt, wenn ein Gast seine E-Mail eingibt und geht.

Was Converstay aus Cloudbeds liest

Alles, was es liest, dient dazu, die E-Mail an den Gast genau zu machen und Buchungen ehrlich zu zählen:

Cloudbeds-DatenWozu
Hotel: Name, Adresse, Währung, ZeitzoneDer Absender, die Fußzeile der E-Mail und Preise in Ihrer Währung
Zimmer: Namen und FotosDer Gast sieht das gewählte Zimmer mit seinem Foto
Raten und VerfügbarkeitDie aktuelle Rate für seine Daten, Hinweise bei Preissenkungen und eine Prüfung, ob ausgebucht ist
Reservierungen: E-Mail des Gastes, Daten, Status, GesamtbetragGästen, die gebucht haben, nicht mehr schreiben und jede zurückgekehrte Buchung zuordnen

Der Key kann in Cloudbeds nichts anlegen, ändern oder stornieren. Kartendaten sieht Converstay nie: Die Zahlung läuft in der Buchungsmaschine von Cloudbeds selbst, und das Snippet liest den Zahlungsschritt nicht.

Was das Snippet in der Buchungsmaschine tut

Das Snippet lädt den Tracker von Converstay in Ihre Cloudbeds-Buchungsmaschine. Es folgt den Schritten des Gastes, speichert das gewählte Zimmer, die Daten, die Rate und die Sprache und speichert seine E-Mail, sobald er sie ins Formular für die Gastdaten eingibt. Wer nie eine E-Mail eingegeben hat, bekommt nichts.

Es kann auch die optionalen Karten zeigen, die Sie im Dashboard einschalten: Ihre Vorteile der Direktbuchung, wenn ein Gast in einen anderen Tab wechselt, Send My Stay, einen Hinweis, dass andere Gäste dieselben Daten ansehen, und weitere Buchungslinks, wenn ein Datum ausgebucht ist. Jede bleibt aus, bis Sie sie einschalten.

Wie Buchungen zugeordnet werden

Meldet Cloudbeds eine neue Reservierung, sucht Converstay nach einem Gast, der die Buchungsmaschine mit derselben E-Mail im selben Hotel verlassen hat. Ein Treffer stoppt alle noch ausstehenden E-Mails. Hatte Converstay diesem Gast schon geschrieben, zählt die Buchung als zurückgewonnen.

Buchungen ohne E-Mail werden über Hotel, Daten und ein Zeitfenster von zwei Stunden um den Moment zugeordnet, in dem der Gast ging. Stornierungen und Datumsänderungen kommen über die anderen beiden Webhooks, sodass eine stornierte Buchung noch am selben Tag nicht mehr zählt. Auch Buchungen per Telefon, WhatsApp oder an der Rezeption zählen, nach Kanal gekennzeichnet, wenn die E-Mail des Gastes übereinstimmt.

Einrichtung

Das Dashboard führt Sie durch und prüft jeden Schritt. Kurz gefasst:

  1. Öffnen Sie in Cloudbeds Account → Apps & Marketplace → API Credentials und legen Sie Credentials mit dem Namen Converstay an.
  2. Erstellen Sie den API-Key mit Häkchen bei R (Lesen) für Hotel, Rate, Reservation und Room und fügen Sie den Key in Converstay ein. Die Webhooks werden für Sie abonniert.
  3. Fügen Sie das Snippet unter Booking Engine → Customize → Custom JavaScript ein oder legen Sie es im Google Tag Manager an.
  4. Verbinden Sie Ihre Versanddomain und geben Sie die E-Mails frei, wenn Sie zufrieden sind.

Die vollständige Anleitung mit den häufigen Stolpersteinen finden Sie unter Nachfassen mit Cloudbeds.

Abschalten

Löschen Sie den API-Key in Cloudbeds und entfernen Sie das Snippet aus der Buchungsmaschine, dann liest Converstay sofort nichts mehr. Sie können uns jederzeit bitten, die Daten Ihres Hotels zu löschen, wie in der Datenschutzerklärung beschrieben.

Fragen

Ist Converstay im Cloudbeds Marketplace?

Noch nicht. Converstay verbindet sich über einen API-Key, den Sie in Ihrem eigenen Cloudbeds-Konto anlegen. Das funktioniert mit jedem Cloudbeds-Tarif mit API-Zugriff.

Kann Converstay meine Reservierungen oder Raten ändern?

Nein. Der Key hat nur Lesezugriff: Hotel, Rate, Reservation und Room. Er kann nichts anlegen, ändern oder stornieren.

Welche Cloudbeds-Webhooks nutzt Converstay?

Reservierung angelegt, Reservierungsstatus geändert und Reservierungsdaten geändert. Damit stoppen die E-Mails, sobald ein Gast bucht, und Stornierungen fallen aus der Zählung.

Funktioniert es mit Cloudbeds Booking Engine Plus?

Ja. Das Snippet kommt ins Custom JavaScript der Buchungsmaschine oder in den Google Tag Manager, wenn Ihre Buchungsmaschine ihn nutzt.

Quellen