v1.75:保存并稍后完成、UTM 字段和国家/地区规则
v1.75.0 让多步骤表单可在 7 天内继续填写,一键添加 UTM 隐藏字段,为每条提交显示提交者所在国家/地区并支持允许与屏蔽规则,还让管理接口令牌可以更新提交。本文逐项说明,并指出各自的边界。
本文由机器翻译。 阅读英文原文

2026 年 10 月 27 日发布的 FormFlow v1.75.0 共有四个条目,全部是新增功能。本文逐项说明各自的范围与界限;该版本的正式记录仍是更新日志中的 v1.75.0。v1.75.1 和 v1.75.2 是单独的补丁版本,各有自己的更新日志条目,本文不涉及。
让人们保存多步骤表单并稍后完成
在表单的“字段”标签页中打开“在步骤之间保存答案”。只有表单有多个步骤时才会显示该开关,所有付费方案都可用。
它适用于 FormFlow 托管的页面,或启用“实时渲染”的嵌入表单。每次有人在步骤之间切换时,到目前为止填写的答案都会被保存。
这个人可以在 7 天内从同一台设备回来,从上次停下的地方继续,也可以选择“重新开始”。
文件从不会被保存。一条提示会告诉人们他们的答案被保留:“您的答案会随填写自动保存,以便您稍后继续完成。”,语言与表单呈现给提交者的语言一致。
保存的答案以加密形式存储,旁边不保存 IP 地址、位置或浏览器信息。
一小时没有保存后,该条目会出现在面板的“未完成”下,并在你的摘要中以“开始填写表单但未完成的人”的形式出现。
未完成的条目从不计入你的用量,也不会被投递或导出。表单完成时、最多 30 天后,或按表单的保留期更早时,它们会被删除;v1.18 说明了保留期。
在你的表单上捕获 UTM 参数
在构建器中选择“添加 UTM 字段”,为 utm_source、utm_medium、utm_campaign、utm_term 和 utm_content 添加隐藏字段。嵌入表单以及 React、Vue、HTML 和 Blade 组件会用页面地址填充任何为空的隐藏字段,因此每条提交都能显示是哪个活动带来的。所有方案都可用。
它只添加表单里还没有的键;如果五个都已经在了,它会告知这一点并且不做任何改动。
这是对字段列表的普通编辑:在你点击“保存”之前,什么都不会被保存。
在多步骤表单中,隐藏字段放在第一步,因为隐藏字段必须位于那里。
隐藏值也可以来自你自己写的链接;参见用链接预填表单并带上活动来源。
查看每位提交者的国家/地区,并允许或屏蔽国家/地区
现在每条提交都会在收件箱、导出和管理接口中显示提交者的国家/地区。FormFlow 在自己的服务器上根据 IP 地址得出,只保留两位字母的国家/地区代码,绝不保留地址。查询读取的是 FormFlow 服务器上的一份国家/地区数据库文件,每月更新一次;不会向其发布者 DB-IP 发送任何提交者数据。
表单的“安全”设置中还有一项“国家/地区规则”:默认为“接受所有国家/地区”,也可以是“仅允许我选择的国家/地区”,或“屏蔽我选择的国家/地区”。所有方案都可用。
被拒绝的提交会保留在“被拒绝的提交”中,以便你恢复它。
无法判断国家/地区的提交总是会通过。
通过管理接口更新提交
API 令牌现在可以把提交标记为已处理或未处理、垃圾或不是垃圾,并重试其失败的投递,就像你在面板中所做的那样。它需要“submissions:write”权限,所有付费方案都可用。
更新:PATCH /api/v1/manage/submissions/{uuid},带布尔值 read、handled 和 spam。提交已经具有的值不会带来任何改变。
“已读”只能单向。发送 read: false 会被以 HTTP 422 和错误 read_cannot_be_unset 拒绝。
重试:POST /api/v1/manage/submissions/{uuid}/deliveries/retry,和面板使用的是同一个重试,每次请求最多 500 条投递。
令牌还可以通过 POST /api/v1/manage/hooks 注册自己的 Webhook(REST hooks),每个表单最多 10 个。创建一个需要“hooks:write”和“submissions:read”权限,因为钩子会把答案发送出去。令牌被撤销或过期时,钩子会被移除,而且没有列出它们的接口。
如果想先用令牌读取,参见用受限的管理接口令牌读取提交。
这次发布不做什么
继续填写是按设备、按多步骤表单计的,且限付费方案。它不携带文件,也不会跟随一个人到另一台设备。
未完成的条目不是提交:它从不被投递、导出或计数,所以在表单完成之前,不会有任何内容到达你的 Webhook 或导出。你的摘要只把它提到为开始了但没有完成的人。
“添加 UTM 字段”只添加五个标准键,此外没有别的,而页面地址只填充仍为空的字段。
国家/地区规则是根据提交者的 IP 地址判断的。当无法得出国家/地区时,不会记录任何内容,提交会被接受。
管理接口不能把提交标记为未读,且令牌只有在你授予相应权限时才能做这些事。
每个条目的完整措辞见更新日志中 v1.75.0 的条目。