Zum Hauptinhalt springen

Buchungsanfragen

Ein Besucher einer Ihrer veröffentlichten Karten kann Ihrem Unternehmen eine Anfrage zu einem Ort darauf senden: eine Reservierung in einer Location, die Besichtigung eines Objekts, einen Termin in einem Geschäft, eine Abholung an einer Haltestelle. Die Anfrage landet im Posteingang Ihrer Organisation in Kaleidr Booking unter booking.kaleidr.com, auf Wunsch per E-Mail, und über Webhooks in Ihren eigenen Systemen. Sie beantworten sie im Posteingang.

Eine Anfrage ist eine Anfrage, keine Buchung. Nichts wird reserviert, vorgemerkt oder bezahlt: Ihr Unternehmen bestätigt sie, per E-Mail oder wie es das sonst tut.

Anfragen aktivieren​

  1. Öffnen Sie in Kaleidr Booking Einstellungen, Allgemein und aktivieren Sie Anfragen annehmen. Solange dies aus ist, kann kein Besucher Ihrer Organisation eine Anfrage senden, und die Anfrage-Schaltflächen erscheinen nicht.
  2. Fügen Sie in Kaleidr Studio einer Sammlung eine Anfrageaktion hinzu: Öffnen Sie die Sammlung, Ortskarte & Filter, Ortsaktionen, und fügen Sie Anfrage hinzu. Ihre Beschriftung ist die Schaltfläche, die Besucher sehen; jedes Kit beginnt mit seiner eigenen:
SammlungstypStandardbeschriftungDer Besucher bittet um
GeschäfteRequest an AppointmentEinen Termin, eine Abholung oder die Antwort auf eine Frage
InserateSchedule a TourEine Besichtigung vor Ort oder per Video, oder weitere Informationen
LocationsReserveEine Reservierung oder die Antwort auf eine Frage
HaltestellenRequest PickupEine Abholung, eine Vorbestellung oder eine Benachrichtigung
  1. Veröffentlichen Sie eine Karte, die die Sammlung zeigt. Ihre Ortskarten, ihre Orts-Layouts und die Orte in ihren Ask-Kaleidr-Antworten tragen dann die Schaltfläche.
  • Eine Anfrageaktion pro Sammlung. Sie aktiviert Anfragen für jeden Ort der Sammlung. Eine neue Locations-Sammlung beginnt mit Reserve, eine neue Haltestellen-Sammlung mit Request Pickup.
  • Sammlungen vom Typ Fahrzeuge und Benutzerdefiniert nehmen keine Anfragen an.
  • Orte im Chat. Die Einstellung Anfragen einer Karte in Studio, Anfragen für Jeden Ort Annehmen, lässt Besucher auch eine Anfrage zu einem Ort senden, den Kaleidr AI in ihren Antworten nennt, etwa ein Restaurant in der Nähe Ihres Hotels. Sie ist standardmäßig aus. Eine solche Anfrage nennt den Ort mit Namen und Adresse. Eine Kartenposition enthält sie nur, wenn die Adresse in Kaleidrs eigenen Adressdaten gefunden wurde.
  • Kaleidr AI kann ein Formular ausfüllen, nie senden. Auf die Bitte „Reserviere einen Tisch für vier um 19 Uhr“ bereitet das Ask-Kaleidr-Panel das Formular mit dem vor, was der Besucher gesagt hat, und zeigt Prüfen und Senden. Der Besucher prüft es, ergänzt seine Angaben und sendet es. Kaleidr AI sieht nie Name, E-Mail oder Telefonnummer eines Besuchers.

Das Formular​

Ein Besucher sieht das Formular über der Karte: die Felder des Kits der Sammlung, seinen Namen, seine E-Mail und optional eine Telefonnummer, eine Nachricht und die Einwilligungszeile. Anfrage senden bleibt deaktiviert, bis die Pflichtfelder ausgefüllt sind und das Einwilligungskästchen angehakt ist. Nach dem Senden sieht der Besucher Anfrage gesendet und eine Referenz wie K-7XQ2MD. Zum Formular selbst siehe Das Anfrageformular.

In Kaleidr Booking hat Einstellungen, Anfrageformulare einen Tab pro Kit. Für jedes Feld wählen Sie, ob es gezeigt wird, ob es Pflicht ist und wie es heißt, und Sie können bis zu fünf eigene Fragen hinzufügen. Die Vorschau daneben zeigt das Formular so, wie Besucher es sehen werden.

KitStandardfelder
GeschäfteWofür die Anfrage ist, Datum, Tageszeit, Artikel
InserateWofür die Anfrage ist, Besichtigung vor Ort oder per Video, bis zu drei Daten, Tageszeit, Finanzierung
LocationsWofür die Anfrage ist, Datum, Uhrzeit, Personenzahl (1 bis 50), Nächte (1 bis 60)
HaltestellenWofür die Anfrage ist, Abholort, Ziel, Datum, Uhrzeit, Personenzahl (1 bis 20), Artikel

Abholort und Ziel sind Text, den der Besucher eintippt. Im Live-Layout fügt eine Haltestellen-Sammlung, deren Anfrageaktion Besucher sie wählen lässt, die beiden Punkte hinzu, gefunden per Adresssuche oder Tippen auf die Karte. Sie sind das, was der Besucher gewählt hat, damit Sie danach handeln.

Bots. Ein Besucher, der nicht bei Kaleidr angemeldet ist, durchläuft vor dem Senden eine kurze Prüfung, ob er ein Mensch ist.

Der Posteingang​

Anfragen in Kaleidr Booking ist ein Board mit den Spalten Neu, Angenommen, Erledigt und Abgelehnt. Ziehen Sie eine Karte, um ihren Status zu ändern, oder nutzen Sie ihr Menü Verschieben nach. Spam anzeigen zeigt die als Spam markierten Anfragen. Filtern Sie nach Karte, Ort, Kit und Datum, oder suchen Sie nach Referenz, Name, E-Mail oder Ort.

Öffnen Sie eine Anfrage, um die Angaben und Antworten des Besuchers, die erteilte Einwilligung, den Ort auf einer Karte und den Verlauf der Anfrage zu sehen. Von dort aus:

AktionWas sie tut
Annehmen, Ablehnen, Als erledigt markieren, Als Spam markieren, Wieder öffnenÄndert den Status. Eine neue Anfrage kann angenommen, abgelehnt oder als Spam markiert werden; eine angenommene als erledigt markiert oder abgelehnt; eine abgelehnte oder als Spam markierte wieder geöffnet. Erledigt ist endgültig.
AntwortSendet Ihre Antwort per E-Mail an den Besucher. Seine Rückmeldung kommt an Ihre eigene E-Mail-Adresse.
Notiz hinzufügenEine Notiz nur für Ihr Team. Sie wird nie gesendet.
Zuweisen anWeist die Anfrage einem Mitglied Ihrer Organisation zu.
Anfragende Person löschenLöscht alle Anfragen dieser E-Mail-Adresse in Ihrer Organisation. Siehe Aufbewahrung und Löschung.

Wer was darf, folgt den Rollen Ihrer Organisation: Inhaber, Administratoren, Mitglieder und Betrachter können Anfragen lesen; Inhaber, Administratoren und Mitglieder können sie ändern, beantworten und zuweisen; Inhaber und Administratoren verwalten Einstellungen, Formulare, Webhooks und Benachrichtigungen, löschen Anfragen und exportieren sie als CSV.

E-Mail. Unter Einstellungen, Benachrichtigungen schickt Neue Anfragen per E-Mail den unter Team aktivierten Mitgliedern eine E-Mail, wenn eine Anfrage eintrifft. Die E-Mail nennt den Ort und die Art der Anfrage und verlinkt sie; sie enthält keine Angaben des Besuchers. Eingangsbestätigungen senden schickt dem Besucher eine Kopie mit der Referenz.

Testanfragen. Eine Anfrage, die Sie selbst aus Studio senden, wird als Test markiert und zählt nicht zum Limit Ihres Tarifs.

Die Einwilligungszeile des Formulars lautet: „Ich bin damit einverstanden, dass Ihr Unternehmen diese Angaben verwendet, um meine Anfrage zu beantworten. Kaleidr verarbeitet sie im Auftrag von Ihr Unternehmen.“, mit Ihrem Unternehmensnamen anstelle von Ihr Unternehmen: dem Name des Unternehmens unter Einstellungen, Allgemein, sonst dem Namen Ihrer Organisation. Tragen Sie unter Link zur Datenschutzerklärung eine https://-Adresse Ihrer eigenen Erklärung ein, dann verlinkt die Zeile darauf. Das Kästchen ist anfangs nicht angehakt, und eine Anfrage ohne Haken wird abgelehnt. Jede Anfrage speichert die Version der Zeile, der der Besucher zugestimmt hat, und den Zeitpunkt.

Aufbewahrung und Löschung​

  • Anfragen aufbewahren für löscht eine Anfrage nach so langer Zeit ohne Aktivität: 365 Tage, sofern Sie es nicht ändern, von 30 bis 730 Tage. Eine als Spam markierte Anfrage wird nach 30 Tagen gelöscht.
  • Anfragende Person löschen löscht alle Anfragen einer E-Mail-Adresse in Ihrer Organisation, samt den E-Mails dazu. Nutzen Sie es, wenn eine Person Sie bittet, ihre Daten zu löschen.
  • Eine Anfrage löschen löscht sie samt den E-Mails dazu.
  • Wenn eine Person ihr Kaleidr-Konto löscht, werden ihre Anfragen in allen Organisationen gelöscht.
  • Wenn Ihre Organisation gelöscht wird, werden ihre Anfragen mit gelöscht.

Webhooks​

Ein Webhook sendet jedes Anfrageereignis sofort an eine Adresse von Ihnen, damit Ihr Reservierungssystem, Ihr CRM oder Ihre Tabellenautomatisierung darauf reagieren kann. Fügen Sie einen in Kaleidr Booking unter Einstellungen, Webhooks hinzu. Webhooks gibt es bei Pro und Enterprise.

  • Die Adresse muss https auf Port 443 sein, und jede Adresse, in die ihr Name aufgelöst wird, muss öffentlich sein. Jeder andere Port oder eine private Adresse wird beim Speichern und erneut bei jeder Zustellung abgelehnt.
  • Das Secret wird einmal gezeigt, wenn Sie den Webhook hinzufügen. Secret erneuern stellt ein neues aus; das alte signiert noch 24 Stunden weiter, damit Sie umstellen können.
  • Test senden sendet ein Ereignis webhook.test.
EreignisGesendet, wenn
request.createdEin Besucher eine Anfrage sendet.
request.status_changedSich der Status einer Anfrage ändert. data.from_status enthält den vorigen.
request.repliedJemand dem Besucher antwortet. data.reply enthält { body, created_at }.
webhook.testSie Test senden wählen.

Jede Zustellung ist ein POST mit einem JSON-Body und diesen Headern:

HeaderWert
Kaleidr-Signaturet=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>
Kaleidr-Event-IdDie ID des Ereignisses, bei jedem erneuten Versuch dieselbe. Nutzen Sie sie, um eine Wiederholung zu ignorieren.
Kaleidr-Event-TypeDas Ereignis, wie in der Tabelle oben.
Kaleidr-Delivery-Attempt1 bis 7.
{
  "id": "8a1c2b9e-0000-4000-8000-000000000001",
  "type": "request.created",
  "api_version": "2026-10-22",
  "created_at": "2026-10-22T15:04:05Z",
  "org_id": "…",
  "data": {
    "request": {
      "id": "…",
      "ref": "K-7XQ2MD",
      "kit": "venues",
      "status": "new",
      "place": { "name": "Sample Venue", "line": "…", "lat": 40.7411, "lng": -73.9897 },
      "requester": { "name": "…", "email": "…", "phone": null, "locale": "en", "signed_in": false },
      "fields": { "kind": "reservation", "date": "2026-10-30", "time": "19:00", "party_size": 4 },
      "message": "…"
    }
  }
}

Bei einer Anfrage zu einem Ort im Chat, dessen Adresse nicht in Kaleidrs eigenen Adressdaten gefunden wurde, sind place.lat und place.lng auf null gesetzt.

Die Signatur prüfen​

Prüfen Sie den Roh-Body, bevor Sie ihn parsen, und lehnen Sie einen Zeitstempel ab, der älter als fünf Minuten ist. Während einer Erneuerung trägt der Header ein zweites v1=, signiert mit dem vorigen Secret; akzeptieren Sie beide.

import hashlib, hmac, time

def verify(header: str, secret: str, body: bytes, tolerance: int = 300) -> bool:
    parts = [p.split("=", 1) for p in header.split(",")]
    t = next((v for k, v in parts if k == "t"), "")
    if not t.isdigit() or abs(time.time() - int(t)) > tolerance:
        return False
    expected = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256).hexdigest()
    return any(k == "v1" and hmac.compare_digest(v, expected) for k, v in parts)

Testen Sie Ihren Code mit diesem Vektor:

EingabeWert
Secretwhsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw
t1761091200
Body{"id":"8a1c2b9e-0000-4000-8000-000000000001","type":"webhook.test"}
v13e55a2f93ac990282b95fd9140f8290ffaddc5d41969831e4234b164d613bd72

Zustellung und erneute Versuche​

  • Antworten Sie innerhalb von 10 Sekunden mit einem beliebigen 2xx-Status. Weiterleitungen werden nicht verfolgt.
  • Mindestens einmal. Eine fehlgeschlagene Zustellung wird nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden erneut versucht: sieben Versuche über etwa 32 Stunden. Dasselbe Ereignis kann zweimal ankommen; ignorieren Sie eine Kaleidr-Event-Id, die Sie schon gesehen haben.
  • Der Body ist die Anfrage im Zustand beim Senden, ein erneuter Versuch trägt also ihren neuesten Stand. Eine inzwischen gelöschte Anfrage wird nicht gesendet.
  • Zehn Zustellungen in Folge, bei denen jeder Versuch fehlschlägt, deaktivieren den Webhook. Ihn wieder zu aktivieren setzt den Zähler zurück.
  • Zustellungen zeigt bei jedem Webhook die Versuche der letzten 30 Tage mit Status, Antwortcode und Dauer, ohne die Bodys. Erneut senden sendet eine fehlgeschlagene noch einmal.

Limits​

LimitFreeProEnterprise
Anfragen pro Monat501.000In Ihrer Vereinbarung festgelegt
WebhooksKeine5In Ihrer Vereinbarung festgelegt

Ein Monat ist der Abrechnungszeitraum Ihrer Organisation. Testanfragen zählen nicht. Am Limit werden neue Anfragen bis zum nächsten Zeitraum abgelehnt, und das Formular zeigt stattdessen die Telefonnummer oder den Link des Ortes, sofern vorhanden.

Siehe auch​