Le formulaire de demande
Le formulaire de demande est ce qui s'ouvre lorsqu'un visiteur touche une action de demande, comme Reserve, Schedule a Tour ou Request Pickup, sur une carte Kaleidr, ou Vérifier et Envoyer sur une demande préparée par Kaleidr AI. Il envoie la demande dans la boîte de réception de votre organisation. La configuration des demandes est décrite dans Demandes de réservation.
Où il fonctionne
Le formulaire ne fonctionne que sur les sites de Kaleidr. Ce n'est pas un script que vous ajoutez à votre page. Sur votre site, il s'ouvre dans une carte publiée que vous intégrez avec <kaleidr-map product="viewer"> : le viewer est une page Kaleidr dans un iframe, et le formulaire s'ouvre par-dessus sa carte. Il fonctionne aussi dans Kaleidr Studio, et dans Kaleidr Map tant qu'elle affiche le fond de carte de Kaleidr.
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer" share-id="YOUR_MAP_ID" layout="guide"
style="display:block; height:640px"></kaleidr-map>
- Rien à ajouter à votre Content Security Policy. Le formulaire et sa vérification humaine se chargent dans l'iframe du viewer : votre page n'a besoin que des entrées
script-srcetframe-srcpropres au viewer. - Il se charge au premier toucher. Une carte dont les visiteurs n'ouvrent jamais le formulaire ne le charge jamais.
- Seuls les lieux qui acceptent les demandes affichent le bouton. Lesquels se règle dans Studio et Kaleidr Booking ; voir Activer les demandes.
Ce que voit le visiteur
- Le formulaire, intitulé avec le libellé de l'action : les champs du kit tels que votre organisation les a configurés, le nom, l'e-mail, un téléphone facultatif, un message et la mention de consentement avec le nom de votre entreprise et le lien vers votre politique de confidentialité.
- Envoyer la demande, activé une fois les champs obligatoires remplis et la case de consentement cochée. La case est décochée au départ. Un visiteur qui n'est pas connecté à Kaleidr passe une courte vérification humaine.
- Demande envoyée, avec la référence, par exemple
K-7XQ2MD, et « Nous avons envoyé une copie à » suivi de l'e-mail du visiteur lorsque votre organisation envoie des accusés de réception.
Le formulaire ne préremplit rien sur le visiteur. Une demande préparée par Kaleidr AI ne reprend que ce que le visiteur a dit, comme une date ou un nombre de personnes, et le visiteur la vérifie avant de l'envoyer.
| Le visiteur voit | Quand |
|---|---|
| « Cet établissement n'accepte pas les demandes en ligne. » | Les demandes sont désactivées pour le lieu ou pour votre organisation. |
| La même chose, avec le téléphone ou le lien du lieu | Votre organisation a atteint sa limite mensuelle de demandes. |
| Une phrase à côté du champ | Un champ obligatoire est vide ou une réponse est hors limites. |
Les libellés du formulaire suivent la langue de la carte : anglais, espagnol, français, allemand, portugais, japonais, coréen, chinois simplifié et traditionnel, et arabe. Vos propres questions et libellés s'affichent tels que vous les avez écrits.
Événements
Le formulaire rend compte à la page Kaleidr qui le contient, pas à votre page :
| Événement | Quand |
|---|---|
ready | Le formulaire s'affiche. |
resize | Sa hauteur a changé. |
submitted | La demande a été acceptée, avec sa référence. |
error | La demande a été refusée, avec un code d'erreur. |
close | Le visiteur a fermé le formulaire. |
Votre page n'en reçoit aucun. Un viewer ne publie aucun message public quand une demande est envoyée, et les messages de l'iframe autres que ready et error ne sont pas un contrat public. Pour agir sur une demande, utilisez votre boîte de réception ou un webhook, qui transmet la demande complète à vos propres systèmes.
Lorsque Kaleidr Analytics est activé sur la carte publiée, une demande envoyée compte comme une conversion de cette carte. La conversion ne porte que le type de demande, jamais les coordonnées du visiteur.
Mise en forme
Le formulaire s'affiche dans sa propre shadow root et reprend les couleurs, la police et l'arrondi des coins de la carte sur laquelle il s'ouvre, en mode clair comme sombre. Le CSS de votre page ne l'atteint pas : il se trouve dans l'iframe du viewer.
Voici les propriétés CSS personnalisées qui mettent en forme le formulaire, et leurs valeurs par défaut. Les pages Kaleidr les définissent à partir du thème de la carte.
| Propriété | Par défaut | Met en forme |
|---|---|---|
--kbw-font | inherit | La police. |
--kbw-fg | #111 | Le texte. |
--kbw-bg | #fff | L'arrière-plan. |
--kbw-muted | #6b7280 | Les indications et le texte secondaire. |
--kbw-border | #d1d5db | Les bordures des champs. |
--kbw-accent | #2da84a | Le bouton d'envoi et l'anneau de focus. |
--kbw-accent-fg | #fff | Le texte du bouton d'envoi. |
--kbw-danger | #b91c1c | Les phrases d'erreur. |
--kbw-radius | 10px | L'arrondi des coins. |
--kbw-space | 8px | L'unité d'espacement. |