O formulário de solicitação
O formulário de solicitação é o que se abre quando um visitante toca em uma ação de solicitação, como Reserve, Schedule a Tour ou Request Pickup, em um mapa da Kaleidr, ou em Revisar e Enviar em uma solicitação que a Kaleidr AI preparou. Ele envia a solicitação para a caixa de entrada da sua organização. A configuração das solicitações está em Solicitações de reserva.
Onde funciona
O formulário funciona apenas nos sites da própria Kaleidr. Não é um script que você adiciona à sua página. No seu site, ele se abre dentro de um mapa publicado que você incorpora com <kaleidr-map product="viewer">: o viewer é uma página da Kaleidr em um iframe, e o formulário se abre sobre o mapa dele. Ele também funciona no Kaleidr Studio, e no Kaleidr Map enquanto ele mostra o mapa base da própria 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>
- Nada a adicionar à sua Content Security Policy. O formulário e a verificação humana carregam dentro do iframe do viewer, então sua página precisa apenas das entradas
script-srceframe-srcdo próprio viewer. - Ele carrega no primeiro toque. Um mapa cujos visitantes nunca abrem o formulário nunca o carrega.
- Só os locais que aceitam solicitações mostram o botão. Quais aceitam é definido no Studio e no Kaleidr Booking; consulte Ativar as solicitações.
O que o visitante vê
- O formulário, com o título do rótulo da ação: os campos do kit como sua organização os configurou, nome, e-mail, um telefone opcional, uma mensagem e a linha de consentimento com o nome da sua empresa e o link da sua política de privacidade.
- Enviar solicitação, ativado quando os campos obrigatórios estão preenchidos e a caixa de consentimento está marcada. A caixa começa desmarcada. Um visitante que não entrou na Kaleidr passa por uma breve verificação humana.
- Solicitação enviada, com a referência, como
K-7XQ2MD, e "Enviamos uma cópia para" o e-mail do visitante quando sua organização envia recibos.
O formulário não preenche nada sobre o visitante. Uma solicitação que a Kaleidr AI preparou traz apenas o que o visitante disse, como uma data ou o número de pessoas, e o visitante a revisa antes de enviar.
| O visitante vê | Quando |
|---|---|
| "Este local não aceita solicitações online." | As solicitações estão desativadas para o local ou para sua organização. |
| O mesmo, com o telefone ou o link do local | Sua organização atingiu o limite mensal de solicitações. |
| Uma frase ao lado do campo | Um campo obrigatório está vazio ou uma resposta está fora do intervalo. |
Os r ótulos do formulário seguem o idioma do mapa: inglês, espanhol, francês, alemão, português, japonês, coreano, chinês simplificado e tradicional, e árabe. Suas próprias perguntas e rótulos aparecem como você os escreveu.
Eventos
O formulário informa a página da Kaleidr que o contém, não a sua página:
| Evento | Quando |
|---|---|
ready | O formulário é exibido. |
resize | A altura dele mudou. |
submitted | A solicitação foi aceita, com a referência. |
error | A solicitação foi recusada, com um código de erro. |
close | O visitante fechou o formulário. |
Sua página não recebe nenhum deles. Um viewer não publica nenhuma mensagem pública quando uma solicitação é enviada, e as mensagens do iframe que não sejam ready e error não são um contrato público. Para agir sobre uma solicitação, use sua caixa de entrada ou um webhook, que chega aos seus próprios sistemas com a solicitação completa.
Quando o mapa publicado tem o Kaleidr Analytics ativado, uma solicitação enviada conta como conversão desse mapa. A conversão traz apenas o tipo de solicitação, nunca os dados do visitante.
Estilo
O formulário é desenhado em uma shadow root própria e usa as cores, a fonte e o raio dos cantos do mapa sobre o qual se abre, nos modos claro e escuro. O CSS da sua página não o alcança: ele está dentro do iframe do viewer.
Estas são as propriedades personalizadas de CSS que definem o estilo do formulário, e seus valores padrão. As páginas da Kaleidr as definem a partir do tema do mapa.
| Propriedade | Padrão | Define o estilo de |
|---|---|---|
--kbw-font | inherit | A fonte. |
--kbw-fg | #111 | O texto. |
--kbw-bg | #fff | O fundo. |
--kbw-muted | #6b7280 | Dicas e texto secundário. |
--kbw-border | #d1d5db | As bordas dos campos. |
--kbw-accent | #2da84a | O botão de envio e o anel de foco. |
--kbw-accent-fg | #fff | O texto do botão de envio. |
--kbw-danger | #b91c1c | As frases de erro. |
--kbw-radius | 10px | O raio dos cantos. |
--kbw-space | 8px | A unidade de espaçamento. |