El formulario de solicitud

El formulario de solicitud es lo que se abre cuando un visitante toca una acción de solicitud, como Reserve, Schedule a Tour o Request Pickup, en un mapa de Kaleidr, o Revisar y Enviar en una solicitud que preparó Kaleidr AI. Envía la solicitud a la bandeja de entrada de tu organización. Cómo configurar las solicitudes se explica en Solicitudes de reserva.

Dónde funciona

El formulario solo funciona en los sitios propios de Kaleidr. No es un script que añadas a tu página. En tu sitio, se abre dentro de un mapa publicado que insertas con <kaleidr-map product="viewer">: el viewer es una página de Kaleidr dentro de un iframe, y el formulario se abre sobre su mapa. También funciona en Kaleidr Studio, y en Kaleidr Map mientras muestra el mapa base propio 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>

• No hay que añadir nada a tu Content Security Policy. El formulario y su comprobación humana se cargan dentro del iframe del viewer, así que tu página solo necesita las entradas script-src y frame-src del propio viewer.
• Se carga con el primer toque. Un mapa cuyos visitantes nunca abren el formulario nunca lo carga.
• Solo los lugares que aceptan solicitudes muestran el botón. Cuáles lo hacen se define en Studio y en Kaleidr Booking; consulta Activar las solicitudes.

Qué ve el visitante

1. El formulario, titulado con la etiqueta de la acción: los campos del kit tal como los configuró tu organización, nombre, correo electrónico, un teléfono opcional, un mensaje y la línea de consentimiento con el nombre de tu negocio y el enlace a tu política de privacidad.
2. Enviar solicitud, que se activa cuando los campos obligatorios están completos y la casilla de consentimiento está marcada. La casilla empieza sin marcar. Un visitante que no ha iniciado sesión en Kaleidr pasa una breve comprobación humana.
3. Solicitud enviada, con la referencia, como K-7XQ2MD, y "Enviamos una copia a" el correo del visitante cuando tu organización envía acuses.

El formulario no rellena nada sobre el visitante. Una solicitud que preparó Kaleidr AI rellena solo lo que dijo el visitante, como una fecha o el número de personas, y el visitante la revisa antes de enviarla.

El visitante ve	Cuándo
"Este lugar no acepta solicitudes en línea."	Las solicitudes están desactivadas para el lugar o para tu organización.
Lo mismo, con el teléfono o el enlace del lugar	Tu organización alcanzó su límite mensual de solicitudes.
Una frase junto al campo	Un campo obligatorio está vacío o una respuesta está fuera de rango.

Las etiquetas del formulario siguen el idioma del mapa, en inglés, español, francés, alemán, portugués, japonés, coreano, chino simplificado y tradicional, y árabe. Tus propias preguntas y etiquetas se muestran tal como las escribiste.

Eventos

El formulario informa a la página de Kaleidr que lo contiene, no a tu página:

Evento	Cuándo
ready	Se muestra el formulario.
resize	Su altura cambió.
submitted	La solicitud se aceptó, con su referencia.
error	La solicitud se rechazó, con un código de error.
close	El visitante cerró el formulario.

Tu página no recibe ninguno. Un viewer no publica ningún mensaje público cuando se envía una solicitud, y los mensajes del iframe distintos de ready y error no son un contrato público. Para actuar sobre una solicitud, usa tu bandeja de entrada o un webhook, que llega a tus propios sistemas con la solicitud completa.

Cuando el mapa publicado tiene Kaleidr Analytics activado, una solicitud enviada cuenta como una conversión de ese mapa. La conversión solo lleva el tipo de solicitud, nunca los datos del visitante.

Estilo

El formulario se dibuja en su propia shadow root y toma los colores, la fuente y el radio de las esquinas del mapa sobre el que se abre, en modo claro y oscuro. El CSS de tu página no lo alcanza: está dentro del iframe del viewer.

Estas son las propiedades personalizadas de CSS con las que se da estilo al formulario, y sus valores predeterminados. Las páginas de Kaleidr las establecen a partir del tema del mapa.

Propiedad	Predeterminado	Da estilo a
--kbw-font	inherit	La fuente.
--kbw-fg	#111	El texto.
--kbw-bg	#fff	El fondo.
--kbw-muted	#6b7280	Las indicaciones y el texto secundario.
--kbw-border	#d1d5db	Los bordes de los campos.
--kbw-accent	#2da84a	El botón de envío y el anillo de foco.
--kbw-accent-fg	#fff	El texto del botón de envío.
--kbw-danger	#b91c1c	Las frases de error.
--kbw-radius	10px	El radio de las esquinas.
--kbw-space	8px	La unidad de espaciado.

Relacionado

• Solicitudes de reserva
• Referencia de Viewer
• Biblioteca de lugares