Demandes de réservation

Un visiteur de l'une de vos cartes publiées peut envoyer à votre entreprise une demande concernant un lieu de la carte : une réservation dans un établissement, la visite d'un bien, un rendez-vous dans un magasin, une prise en charge à un arrêt. La demande arrive dans la boîte de réception de votre organisation dans Kaleidr Booking, sur booking.kaleidr.com, par e-mail si vous le souhaitez, et dans vos propres systèmes via des webhooks. Vous y répondez depuis la boîte de réception.

Une demande est une demande, pas une réservation. Rien n'est réservé, bloqué ni payé : votre entreprise la confirme, par e-mail ou comme elle le fait d'habitude.

Activer les demandes

1. Dans Kaleidr Booking, ouvrez Paramètres, Général et activez Accepter les demandes. Tant que c'est désactivé, aucun visiteur ne peut envoyer de demande à votre organisation, et les boutons de demande n'apparaissent pas.
2. Dans Kaleidr Studio, ajoutez une action de demande à une collection : ouvrez la collection, Fiche et filtres, Actions du lieu, et ajoutez Demande. Son libellé est le bouton que voient les visiteurs ; chaque kit commence avec le sien :

Type de collection	Libellé par défaut	Le visiteur demande
Magasins	Request an Appointment	Un rendez-vous, un retrait ou la réponse à une question
Annonces	Schedule a Tour	Une visite sur place ou en vidéo, ou plus d'informations
Établissements	Reserve	Une réservation ou la réponse à une question
Arrêts	Request Pickup	Une prise en charge, une précommande ou un avis

3. Publiez une carte qui affiche la collection. Ses fiches de lieu, ses mises en page de lieux et les lieux de ses réponses Ask Kaleidr portent alors le bouton.

• Une action de demande par collection. L'ajouter active les demandes pour tous les lieux de la collection. Une nouvelle collection Établissements commence avec Reserve, et une nouvelle collection Arrêts avec Request Pickup.
• Les collections Véhicules et Personnalisées n'acceptent pas de demandes.
• Lieux du chat. Le paramètre Demandes d'une carte dans Studio, Accepter les Demandes pour Tout Lieu, permet aussi aux visiteurs d'envoyer une demande concernant un lieu que Kaleidr AI cite dans ses réponses, comme un restaurant près de votre hôtel. Il est désactivé par défaut. Une telle demande désigne le lieu par son nom et son adresse. Elle ne porte une position sur la carte que si l'adresse a été trouvée dans les données d'adresses propres à Kaleidr.
• Kaleidr AI peut remplir un formulaire, jamais l'envoyer. À la demande « réserve une table pour quatre à 19 h », le panneau Ask Kaleidr prépare le formulaire avec ce que le visiteur a dit et affiche Vérifier et Envoyer. Le visiteur le vérifie, ajoute ses coordonnées et l'envoie. Kaleidr AI ne voit jamais le nom, l'e-mail ni le téléphone d'un visiteur.

Le formulaire

Le visiteur voit le formulaire par-dessus la carte : les champs du kit de la collection, son nom, son e-mail et un téléphone facultatif, un message et la mention de consentement. Envoyer la demande reste désactivé tant que les champs obligatoires ne sont pas remplis et la case de consentement cochée. Après l'envoi, le visiteur voit Demande envoyée et une référence comme K-7XQ2MD. Pour le formulaire lui-même, voir Le formulaire de demande.

Dans Kaleidr Booking, Paramètres, Formulaires de demande comporte un onglet par kit. Pour chaque champ, vous choisissez s'il est affiché, s'il est obligatoire et son libellé, et vous pouvez ajouter jusqu'à cinq questions personnelles. L'aperçu à côté montre le formulaire tel que les visiteurs le verront.

Kit	Champs standard
Magasins	Objet de la demande, date, moment de la journée, articles
Annonces	Objet de la demande, visite sur place ou en vidéo, jusqu'à trois dates, moment de la journée, financement
Établissements	Objet de la demande, date, heure, nombre de personnes (1 à 50), nuits (1 à 60)
Arrêts	Objet de la demande, prise en charge, destination, date, heure, nombre de personnes (1 à 20), articles

La prise en charge et la destination sont du texte saisi par le visiteur. Dans la mise en page en direct, une collection Arrêts dont l'action de demande laisse les visiteurs les choisir ajoute les deux points, trouvés par une recherche d'adresse ou un toucher sur la carte. C'est ce que le visiteur a choisi pour que vous y donniez suite.

Robots. Un visiteur qui n'est pas connecté à Kaleidr passe une courte vérification humaine avant l'envoi de la demande.

La boîte de réception

Demandes dans Kaleidr Booking est un tableau avec les colonnes Nouvelle, Acceptée, Terminée et Refusée. Faites glisser une carte pour changer son statut, ou utilisez son menu Déplacer vers. Afficher le spam affiche les demandes marquées comme spam. Filtrez par carte, lieu, kit et date, ou recherchez par référence, nom, e-mail ou lieu.

Ouvrez une demande pour voir les coordonnées et les réponses du visiteur, le consentement qu'il a donné, le lieu sur une carte et l'historique de la demande. De là :

Action	Ce qu'elle fait
Accepter, Refuser, Marquer comme terminée, Marquer comme spam, Rouvrir	Change le statut. Une nouvelle demande peut être acceptée, refusée ou marquée comme spam ; une demande acceptée peut être marquée comme terminée ou refusée ; une demande refusée ou marquée comme spam peut être rouverte. Terminée est définitif.
Réponse	Envoie votre réponse au visiteur par e-mail. Sa réponse arrive à votre propre adresse e-mail.
Ajouter une note	Une note réservée à votre équipe. Elle n'est jamais envoyée.
Attribuer à	Confie la demande à un membre de votre organisation.
Effacer le demandeur	Supprime toutes les demandes de cette adresse e-mail dans votre organisation. Voir Conservation et effacement.

Qui peut faire quoi suit les rôles de votre organisation : les propriétaires, administrateurs, membres et lecteurs peuvent lire les demandes ; les propriétaires, administrateurs et membres peuvent les modifier, y répondre et les attribuer ; les propriétaires et administrateurs gèrent les paramètres, les formulaires, les webhooks et les notifications, suppriment et effacent les demandes, et les exportent au format CSV.

E-mail. Sous Paramètres, Notifications, Recevoir les nouvelles demandes par e-mail prévient par e-mail les membres activés sous Équipe à l'arrivée d'une demande. L'e-mail indique le lieu et le type de demande et renvoie vers elle ; il ne contient aucune coordonnée du visiteur. Envoyer des accusés de réception envoie au visiteur une copie avec la référence.

Demandes de test. Une demande que vous envoyez vous-même depuis Studio est marquée Test et ne compte pas dans la limite de votre offre.

Consentement

La mention de consentement du formulaire dit : « J'accepte que votre entreprise utilise ces informations pour répondre à ma demande. Kaleidr les traite pour le compte de votre entreprise. », avec le nom de votre entreprise à la place de votre entreprise : le Nom de l'entreprise sous Paramètres, Général, sinon le nom de votre organisation. Renseignez le Lien vers la politique de confidentialité avec une adresse https:// de votre propre politique, et la mention y renvoie. La case est décochée au départ, et une demande sans elle est refusée. Chaque demande conserve la version de la mention acceptée par le visiteur et la date.

Conservation et effacement

• Durée de conservation supprime une demande après cette durée sans activité : 365 jours sauf modification, de 30 à 730 jours. Une demande marquée comme spam est supprimée au bout de 30 jours.
• Effacer le demandeur supprime toutes les demandes d'une adresse e-mail dans votre organisation, avec les e-mails envoyés à leur sujet. Utilisez-le lorsqu'une personne vous demande de supprimer ses données.
• Supprimer une demande la supprime avec les e-mails envoyés à son sujet.
• Lorsqu'une personne supprime son compte Kaleidr, ses demandes sont supprimées dans toutes les organisations.
• Lorsque votre organisation est supprimée, ses demandes disparaissent avec elle.

Webhooks

Un webhook envoie chaque événement de demande à une adresse vous appartenant dès qu'il se produit, pour que votre système de réservation, votre CRM ou l'automatisation de votre tableur puisse y donner suite. Ajoutez-en un dans Kaleidr Booking sous Paramètres, Webhooks. Les webhooks sont disponibles avec Pro et Enterprise.

• L'adresse doit être en https sur le port 443, et toutes les adresses vers lesquelles son nom est résolu doivent être publiques. Tout autre port, ou une adresse privée, est refusé à l'enregistrement et à nouveau à chaque envoi.
• Le secret n'est affiché qu'une fois, à l'ajout du webhook. Renouveler le secret en émet un nouveau ; l'ancien continue de signer pendant 24 heures, le temps de basculer.
• Envoyer un test envoie un événement webhook.test.

Événement	Envoyé quand
request.created	Un visiteur envoie une demande.
request.status_changed	Le statut d'une demande change. data.from_status contient le précédent.
request.replied	Quelqu'un répond au visiteur. data.reply contient { body, created_at }.
webhook.test	Vous choisissez Envoyer un test.

Chaque envoi est un POST avec un corps JSON et ces en-têtes :

En-tête	Valeur
Kaleidr-Signature	t=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>
Kaleidr-Event-Id	L'identifiant de l'événement, identique à chaque nouvelle tentative. Servez-vous-en pour ignorer une répétition.
Kaleidr-Event-Type	L'événement, comme dans le tableau ci-dessus.
Kaleidr-Delivery-Attempt	De 1 à 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": "…"
    }
  }
}

Une demande concernant un lieu du chat dont l'adresse n'a pas été trouvée dans les données d'adresses propres à Kaleidr a place.lat et place.lng à null.

Vérifier la signature

Vérifiez le corps brut avant de l'analyser, et refusez un horodatage de plus de cinq minutes. Pendant un renouvellement, l'en-tête porte un second v1=, signé avec le secret précédent ; acceptez l'un ou l'autre.

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)

Testez votre code avec ce vecteur :

Entrée	Valeur
secret	whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw
t	1761091200
corps	{"id":"8a1c2b9e-0000-4000-8000-000000000001","type":"webhook.test"}
v1	3e55a2f93ac990282b95fd9140f8290ffaddc5d41969831e4234b164d613bd72

Envoi et nouvelles tentatives

• Répondez avec n'importe quel statut 2xx en moins de 10 secondes. Les redirections ne sont pas suivies.
• Au moins une fois. Un envoi qui échoue est retenté après 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures et 24 heures : sept tentatives sur environ 32 heures. Le même événement peut arriver deux fois ; ignorez un Kaleidr-Event-Id déjà vu.
• Le corps est la demande telle qu'elle est au moment de l'envoi, si bien qu'une nouvelle tentative porte son dernier état. Une demande effacée entre-temps n'est pas envoyée.
• Dix envois d'affilée dont toutes les tentatives échouent désactivent le webhook. Le réactiver remet le compteur à zéro.
• Envois, sous chaque webhook, liste les tentatives des 30 derniers jours avec leur statut, leur code de réponse et leur durée, sans les corps. Réessayer renvoie un envoi qui a échoué.

Limites

Limite	Free	Pro	Enterprise
Demandes par mois	50	1 000	Fixé dans votre contrat
Webhooks	Aucun	5	Fixé dans votre contrat

Un mois correspond à la période de facturation de votre organisation. Les demandes de test ne comptent pas. À la limite, les nouvelles demandes sont refusées jusqu'à la période suivante, et le formulaire affiche à la place le téléphone ou le lien du lieu s'il en a un.

Voir aussi

• Le formulaire de demande
• Bibliothèque de lieux
• Référence Viewer : mises en page de lieux
• Suivi en direct