跳到主要内容

请求表单

当访客在 Kaleidr 地图上点按请求操作（例如 Reserve、Schedule a Tour 或 Request Pickup），或在 Kaleidr AI 准备好的请求上点按查看并发送时，就会打开请求表单。它会将请求发送到你组织的收件箱。如何设置请求，请参阅预订请求。

在哪里运行​

表单只在 Kaleidr 自己的网站上运行。 它不是你添加到页面中的脚本。在你的网站上，它在你用 <kaleidr-map product="viewer"> 嵌入的已发布地图中打开：viewer 是 iframe 中的一个 Kaleidr 页面，表单在其地图上方打开。它也在 Kaleidr Studio 中运行；在 Kaleidr Map 中，仅在显示 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>
  • 无需向你的 Content Security Policy 添加任何内容。 表单及其人机验证在 viewer 的 iframe 中加载，因此你的页面只需要 viewer 自身的 script-src 和 frame-src 条目。
  • 首次点按时才加载。 访客从不打开表单的地图永远不会加载它。
  • 只有接受请求的地点才显示按钮。 哪些地点接受请求在 Studio 和 Kaleidr Booking 中设置；参阅开启请求。

访客看到什么​

  1. 以操作标签为标题的表单：按你组织的设置显示的套件字段、姓名、电子邮件、可选的电话、留言，以及包含你的商家名称和隐私政策链接的同意声明。
  2. 发送请求，在必填字段填写完毕并勾选同意框后可用。同意框初始未勾选。未登录 Kaleidr 的访客需要通过一次简短的人机验证。
  3. 请求已发送，并显示参考编号（例如 K-7XQ2MD）；如果你的组织发送回执，还会显示已将副本发送到访客的电子邮件。

表单不会预先填写任何关于访客的信息。Kaleidr AI 准备的请求只填入访客说过的内容，例如日期和人数，访客会在发送前检查。

访客看到条件
“此地点不接受在线请求。”该地点或你的组织关闭了请求。
同样的句子，并附地点的电话或链接你的组织已达到每月请求限制。
字段旁边的一句话必填字段为空，或回答超出范围。

表单的标签遵循地图的语言，支持英语、西班牙语、法语、德语、葡萄牙语、日语、韩语、简体中文、繁体中文和阿拉伯语。你自己的问题和标签按你编写的原样显示。

事件​

表单向包含它的 Kaleidr 页面报告，而不是向你的页面报告：

事件时机
ready表单已显示。
resize其高度发生了变化。
submitted请求已被接受，附带参考编号。
error请求被拒绝，附带错误代码。
close访客关闭了表单。

你的页面不会收到其中任何事件。 发送请求时，viewer 不会发布任何公开消息，而除 ready 和 error 之外的 iframe 消息都不是公开契约。要处理请求，请使用你的收件箱或 webhook，它会把完整的请求送达你自己的系统。

当已发布地图开启了 Kaleidr Analytics 时，发送的请求会计为该地图的一次转化。转化只包含请求的类型，绝不包含访客的信息。

样式​

表单在自己的 shadow root 中绘制，并在浅色和深色模式下沿用其所打开地图的颜色、字体和圆角。你页面的 CSS 无法影响它：它位于 viewer 的 iframe 内。

以下是表单样式所使用的 CSS 自定义属性及其默认值。Kaleidr 的页面会根据地图的主题设置它们。

属性默认值作用于
--kbw-fontinherit字体。
--kbw-fg#111文本。
--kbw-bg#fff背景。
--kbw-muted#6b7280提示和次要文本。
--kbw-border#d1d5db字段边框。
--kbw-accent#2da84a发送按钮和焦点环。
--kbw-accent-fg#fff发送按钮上的文本。
--kbw-danger#b91c1c错误语句。
--kbw-radius10px圆角半径。
--kbw-space8px间距单位。

相关内容​