表单

浏览时使用的筛选、搜索和视图选项会保存在浏览器标签页中，刷新页面或切换页面后仍然保留，并按用户和工作区分别保存。

表单可以将网站访客转化为联系人。你可以在控制台中构建表单，将其发布到托管页面，然后分享链接或嵌入任意网站。每次提交都会存储；如果包含电子邮件地址，系统会创建或更新联系人，应用你选择的标签，并可直接将其加入营销活动。

打开侧边栏中的表单即可使用。查看表单需要与查看联系人相同的权限；构建和发布表单需要管理联系人权限。

新建表单会创建一份预置了名字、姓氏和电子邮件字段的草稿，并打开构建器。中央画布是实时预览，你看到的效果与托管页面完全一致。

• 点击左侧组件面板中的内容块，或将其拖到画布上，即可添加。蓝线标出内容块将插入的位置；在画布之外松开鼠标会取消拖动。
• 点击内容块，在右侧面板编辑其标签、占位文本、帮助文字、必填设置和宽度。两个半宽字段会共用一行。
• 拖动内容块上的拖拽手柄可以调整顺序。拖动期间，表单本身保持不动，由蓝线提示内容块的落点。手柄也支持不用鼠标操作：按 Tab 聚焦手柄，按空格拾起内容块，用方向键移动，再按空格放下，或按 Escape 取消。
• 内容块上的复制和垃圾桶按钮分别用于复制和移除该块。

字段类型

页面

在任意位置放入分页符，即可将表单拆分为多个步骤。访客通过“下一步”和“返回”切换页面，每页都会在继续之前进行验证；可选的进度条（在设计标签页设置）显示填写进度。分页符可以带有页面标题，用于标识表单中的页面以及分析报表中的页面。避免将分页符放在最开头或最后：空白页不会渲染任何内容，构建器也会在发布前发出警告。

提交内容的保存位置

每个回答都会原样保存在提交记录中。此外，每个输入字段还可以写入联系人：

• 联系人列。 映射到名字、姓氏、电子邮件、公司或电话的字段，会填入相应列。电子邮件字段始终映射到电子邮件列，每一列只能映射一个字段。
• 自定义字段。 没有映射的字段会以其标签作为名称，将答案保存为联系人自定义字段。例如，“Company size”（公司规模）这一问题会生成 Company size 自定义字段，可用于分群和邮件个性化。

表单必须收到电子邮件地址才能创建联系人。没有电子邮件字段的表单仍可收集提交内容，只是不会影响联系人列表。

设计标签页用于设置表单样式，画布会实时更新。默认样式是简洁、中性的卡片，适合大多数网站；保留默认设置也完全可以。

• 主题。 一键应用预设样式，包括浅色、深色、渐变、衬线字体等，同时设置颜色和字体。主题不会改动布局、分页或按钮文本，应用后每种颜色仍可编辑。
• 布局。 卡片是经典的居中方框。宽版去掉外框，让字段直接显示在页面背景上。分栏在表单旁增加侧面板，展示封面图片或页面背景。
• 模式。 经典模式一次显示当前页的全部字段。专注模式每屏只问一个问题，按回车继续，类似全屏问卷工具。
• 颜色与文字。 可调整所有颜色，包括页面、卡片、输入框、标签、占位文本、强调色和按钮；还可选择八种字体，调整圆角、间距、宽度和对齐方式。每个颜色选项都会打开完整的颜色选择器：拖动明暗区域、选择色相、粘贴十六进制值，或使用预设颜色。基于 Chromium 的浏览器还提供吸管，可从屏幕任意位置取色。页面背景可以使用双色渐变。
• 顶部栏。 可选的顶部栏用于展示徽标和标题。横跨页面使其铺满页面宽度并位于所有内容上方；随表单显示将其放在表单内部、字段上方，下方有分隔线，视觉上属于卡片，而非卡片外的界面栏。内容可以左对齐、居中或分置两侧（一侧徽标，另一侧标题），在单独设置之前沿用表单本身的对齐方式；居中时，徽标会叠放在标题上方，以适合居中的组合布局。全页宽度的顶部栏可以设置独立背景色，并在表单滚动时固定在屏幕上；嵌在表单内部的顶部栏不适用这两项，因此不会提供相应选项。默认情况下，顶部栏会容纳徽标；关闭该选项后，徽标保留在自己的位置，顶部栏只显示标题。既没有徽标也没有标题的顶部栏不会在正式页面中显示。
• 侧面板。 在分栏布局中，可以在封面图片上添加标题和一段文字。文字使用白色并带柔和阴影，以便在各种照片上保持清晰。
• 品牌与背景。 可以上传徽标（PNG 或 JPG，最大 1 MB）、分栏布局的封面图片，以及整页背后的背景图片（后两者最大均为 4 MB）。徽标可按小、中、大尺寸展示；在卡片布局中，可放在卡片上，也可放在卡片上方的页面背景上。移到卡片外时请检查对比度，因为深色页面可能让深色徽标难以辨认。背景图片可以填充、适应或平铺；遮罩滑块控制页面颜色覆盖图片的程度：复杂照片使文字难以阅读时，可以调高遮罩。

设置标签页控制提交后执行的操作：

• 成功消息在提交后显示；也可以设置跳转 URL，将访客带到你自己的感谢页面。
• 添加标签为每个提交的联系人应用所选标签，例如“网站潜在客户”。
• 加入营销活动将新联系人作为潜在客户加入所选营销活动。发送仍然遵循该活动自身的计划、限额和时间窗口；表单绝不会导致即时发信。选择营销活动会开启该活动的持续运行以接收新潜在客户设置，使其在两次提交之间等待，而不是结束。已经结束的活动会在新潜在客户到来时，通过常规启动检查后重新启动；如果重启被拒绝，活动日志会记录原因，潜在客户继续等待。
• 垃圾内容防护和允许嵌入的域名见下文。

发布将表单上线；取消发布再次下线，页面会开始返回“未找到”。归档会保留数据，同时也会使页面下线。已发布表单的修改在保存时立即生效。

分享标签页提供四种使用已发布表单的方式：

• 托管链接。 表单自己的页面，可分享到电子邮件签名或社交平台，无需自建网站。
• JavaScript 嵌入（推荐）。一段 script 标签，加上一个 div，并为其设置 data-warmbly-form 属性。表单在指定位置渲染，并根据内容自动调整尺寸，避免底部截断或留出多余空白。
• 弹窗。 使用相同脚本，再为任意元素添加 data-warmbly-popup 属性。点击该元素会在浮层中打开表单；按 Escape、点击遮罩，或成功提交后稍等片刻，弹窗都会关闭。
• 普通 iframe。 适用于会移除脚本的网站构建器。高度固定，因此需要设置 height 属性以适配表单。

这些方式可用于 WordPress、Elementor、Webflow、Shopify、Framer，以及任何允许自定义 HTML 的地方。表单本身始终在 Warmbly 的源站上运行，因此宿主页面的 CSS 不会破坏表单，访客数据也不会经过宿主页面。每次成功提交后，脚本还会在宿主页面触发 warmbly:submitted DOM 事件，供你执行自己的跟踪逻辑。

个性化链接

个性化链接是在表单 URL 中加入专属于联系人的票据（?t=...）。打开后会预填该联系人已映射的字段；即使访客输入了不同的电子邮件地址，访问和提交仍会归属于原联系人。没有单独的电子邮件验证步骤；持有链接即代表身份，与退订链接的工作方式相同。

有两种获取方式：

• 在营销活动邮件中。 使用编辑器工具栏的表单按钮，或输入 {{，再在表单下选择目标表单。两种方式都会插入一个可点击的标签，之后可用它更换表单。发送时，每位收件人都会获得自己的链接，且与其他链接一样接受点击跟踪。
• 为单个联系人生成。 分享标签页提供联系人搜索；点击“复制链接”会生成该联系人的 URL，可用于任意位置。

个性化链接也让分析数据精确到个人：表单的分析标签页会显示哪些联系人打开了表单、填写到了哪一步，以及是否完成。

自定义域名

默认情况下，表单链接使用共享主机，因此其信誉和外观体现的是所有使用者的共同情况。将发件域名下的一个子域名指向该主机，可以让所有表单链接使用你自己的域名，包括托管页面、嵌入表单，以及营销活动邮件中的个性化链接。

这一点比表面看起来更重要。点击跟踪已经会将邮件 HTML 部分中的链接改写到你的跟踪域名，但纯文本版本绝不会改写。因此，如果没有自定义表单域名，每封包含表单链接的邮件中仍然会出现共享主机。

在任意表单分享标签页的自定义域名中输入子域名，在 DNS 服务商处添加界面给出的 CNAME，然后点击保存并验证。这是工作区级设置，会同时覆盖所有表单，需要管理设置权限。

验证会报告与跟踪域名相同的结果：已验证、尚无记录、指向其他位置，或当前安装没有表单主机，因此无可指向的目标。在验证通过之前，链接继续使用共享主机，未验证的域名不会导致表单失效。Warmbly 每小时重新检查一次，DNS 记录传播完成后会自动开始使用该域名；若之后不再指向这里，也会停止使用，避免继续默默提供来自已无法响应的主机的链接。

访客直接打开域名、路径中没有指定表单时，会看到一个简短页面，说明该地址用于提供表单，每个表单都有自己的链接。此页面不列出任何表单，也不包含可识别工作区的信息，因此客户出于好奇输入域名时，会看到有意设计的页面，而不是错误。

验证证明的是 DNS 配置，而非 HTTPS。Warmbly Cloud 和使用随附 Caddy 安装的自托管实例，都会在首次加载该域名下的页面时自行申请证书。如果部署在运维人员自己的代理后面，则由该代理负责证书；若这里显示域名验证通过，但访问时出现证书警告，请联系运维人员处理。

已经发送的链接仍会在生成时使用的主机上解析。只有新链接会采用变更后的域名。

营销活动中的表单

营销活动引用表单后，其概览页面会增加表单面板，列出引用的每个表单，并分别显示：多少收件人获得了个性化链接、多少人打开、多少人开始填写、多少人提交，以及由此计算的提交率。只要将表单写入某个步骤，它就会以零数据出现在该面板，便于启动前确认关联正确。

每位收件人的链接都是唯一的，因此这些数字按联系人统计，而非按点击统计：同一人打开两次只计一次，每次提交也会标明将其引导过来的营销活动。表单自身的分析标签页提供对应的营销活动来源分布，每条提交记录也显示其营销活动。

提交记录标签页按最新活动优先排列所有参与者，并实时更新：任何打开该表单的团队成员都能看到新提交，无需刷新。除已完成的回答外，还会列出打开个性化链接但尚未完成的人，标记为进行中并显示到达的页面，让停滞的潜在客户清晰可见。搜索和状态筛选可以缩小列表；点击某条记录可查看全部回答；垃圾桶按钮会删除该记录，但保留由其创建的联系人；选择多行后可以批量删除。

每个提交的联系人都以 form 作为首次接触来源，在活动时间线上获得一条“提交了表单”记录，并可在分群中按来源筛选。表单的页面浏览量、提交数量和转化率显示在表单列表中。

提交也会触发表单已提交自动化触发器和 form.submitted Webhook 事件，携带表单、联系人以及按键名组织的所有回答。因此，流程可以在提交到达时立即为联系人添加标签、创建任务或向 Slack 发消息。

提交还会触发 form.submitted Webhook，携带回答和联系人 ID，便于将潜在客户转发到任何外部系统。

分析标签页展示最近 7、30 或 90 天的转化漏斗：

• 总量与趋势。 浏览量、开始填写次数（首次互动）、提交量和完成率，以及每日趋势图。
• 页面漏斗。 对于多页表单，显示到达每一页的访客数，以及其中最终完成的人数，便于准确找出流失位置。
• 访客来源。 主要来源域名、国家和设备类型。位置仅解析到国家级别，绝不存储访客的 IP 地址。
• 已识别的访客。 通过个性化链接打开表单的联系人，以及其最近出现时间、到达的最远页面和是否完成。

漏斗事件保留 180 天；表单列表中的累计浏览量和提交计数永久保留。

每个已发布表单都提供多层防护，无需配置：

• 蜜罐字段：对人不可见，但简单机器人会填写它
• 最短填写时间：丢弃快于正常人工输入速度的提交
• 提交端点按来源地址实施频率限制
• 每次提交的大小上限
• 渲染令牌：表单数据端点和提交端点只响应携带令牌的请求，该令牌在页面加载时签发。因此，脚本不能不加载页面就抓取表单定义或批量发送提交。标签页打开超过 12 小时后，会提示刷新，而不会默默失败

另外三项控制由你决定：

• 验证码挑战为表单添加 Cloudflare Turnstile 检查。运维人员为实例配置 Turnstile 后，才会显示此开关。

• 分类筛选将每次提交分为买家（潜在客户或询问你的产品与服务的人）、供应商（向你推销的人）、求职者、其他或垃圾内容（垃圾信息、无意义文本、测试内容或未经请求的推销）。判定结果以标签显示在提交列表中，并可用于筛选。垃圾内容会被存储并标记，但不会创建联系人，也不会加入营销活动，因此机器人不能将自己加入你的客户触达流程。其他类别的处理方式保持不变。每个表单默认关闭分类筛选，需要自行开启；运维人员为实例配置 TYPESAFE_API_KEY 后才会出现该开关。只有访客填写的回答会发送到 TypeSafe 供其判断，不包含任何连接信息；调用缓慢或失败时，提交会保持未分类状态，不会让访客等待。

• 允许嵌入的域名限制哪些网站可以嵌入表单。列出域名后，浏览器会拒绝在其他网站中通过框架嵌入该页面；一个域名也覆盖其子域名。留空表示允许所有网站。无论如何设置，托管链接都继续可用。

  即使只在一个网站嵌入，也建议列出自己的域名。若表单允许任何来源，别人就可能在其页面下方通过不可见框架嵌入表单，用来收集看似来自你的潜在客户；只有浏览器能阻止这种行为。

表单、设计、徽标和封面图片、提交记录、个性化链接票据以及漏斗事件，都属于工作区归档的联系人数据组。公开表单 ID 会随归档迁移，因此迁移到另一个实例后，网站上已有的嵌入代码仍可使用，只需将嵌入目标改为新主机。链接票据会原样迁移，因此已发送邮件中的个性化链接仍能识别对应联系人。如果导入时未包含营销活动，表单与活动的关联会被移除。