从 Typeform 导入

NueForm 内置了 Typeform 导入器，可将您现有的 Typeform 表单转换为 NueForm 表单。本指南介绍迁移流程、自动转换的内容以及可能需要手动调整的部分。

功能对比

功能	Typeform	NueForm
问题类型	20+	25+
逻辑跳转/分支	是	是
计算变量	是	是
隐藏字段	是	是（作为变量）
欢迎页面	是	是
感谢页面	是	是（支持多个结束页面）
进度条	是	是
媒体附件	图片、视频	图片、视频、YouTube 嵌入
测验评分	是	是（3 种模式：知识、线索评估、匹配）
自定义 CSS	主题构建器	完整 CSS 访问（Pro+）
Webhooks	是	是（Pro+）
支付	Stripe	Stripe
文件上传	是	是
团队	是	是
API	是	是
React 导出	否	是（Pro+）
实时活动（Fuse）	否	是

迁移方法

方法 1：粘贴 Typeform JSON（推荐）

最快的方法是使用 Typeform 的 API 导出：

从 Typeform API 获取表单定义：

bash

curl -X GET https://api.typeform.com/forms/YOUR_FORM_ID \
  -H "Authorization: Bearer YOUR_TYPEFORM_TOKEN"

复制完整的 JSON 响应。
在 NueForm 中，进入表单页面并点击导入表单。
选择从 Typeform 导入并粘贴 JSON。
点击导入。NueForm 将转换表单并在构建器中打开。
检查导入的表单，进行必要调整，准备好后发布。

您可以从 Typeform 开发者门户获取 Typeform 个人访问令牌。进入账户设置并生成个人访问令牌。

方法 2：手动重建

对于简单的表单或想借此机会重构表单时：

并排打开 Typeform 表单和 NueForm 构建器。
使用 NueForm 构建器重建每个问题。
重新设置逻辑跳转和变量。
复制粘贴问题文本和选项。

问题类型映射

NueForm 导入器会自动将 Typeform 问题类型转换为对应的 NueForm 类型：

Typeform 类型	NueForm 类型	备注
`short_text`	`short_text`	直接对应
`long_text`	`long_text`	直接对应
`email`	`email`	直接对应
`phone_number`	`phone`	直接对应
`number`	`number`	直接对应
`url` / `website`	`url` / `website`	直接对应
`multiple_choice`	`multiple_choice`	选项、多选、随机排列和"其他"选项均保留
`dropdown`	`dropdown`	选项和字母排序保留
`picture_choice`	`picture_choice`	选项标签和图片 URL 保留
`yes_no`	`yes_no`	直接对应
`rating`	`rating`	步数和形状（星星、爱心、拇指、皇冠、闪电）保留
`opinion_scale`	`opinion_scale`	量表范围、从一开始和标签保留
`nps`	`nps`	0--10 范围和标签保留
`date`	`date`	直接对应
`file_upload`	`file_upload`	直接对应
`legal`	`legal`	直接对应
`statement`	`statement`	按钮文本保留
`ranking`	`ranking`	选项保留
`matrix`	`matrix`	行和列保留
`signature`	`signature`	直接对应
`payment`	`payment`	货币和价格保留
`group`	`question_group`	子字段递归转换
`inline_group`	`multi_question_page`	子字段递归转换
`contact_info`	`contact_info`	子字段映射到已知键
`address`	`address`	子字段映射到已知键

未列出的问题类型（例如 CAPTCHA）在导入过程中会被跳过。请检查导入的表单是否有缺失的问题。

自动转换的内容

问题和属性

问题标题、描述和必填状态
所有带标签的选项
评分步数和图标形状
量表范围和端点标签
分组/复合子字段
验证设置（最小/最大值、最大长度）

逻辑跳转

导入器将 Typeform 的逻辑规则转换为 NueForm 的逻辑跳转格式：

跳转操作 --- "跳转到问题 X"和"跳转到结尾"完全支持。
条件 --- 单一条件（is、is_not、greater_than 等）和复合条件（and、or）均保留。
变量操作 --- 计算变量的 add 和 set 操作已转换。
始终条件 --- 无条件跳转保留。

运算符映射：

Typeform 运算符	NueForm 运算符
`is` / `equal`	`equals`
`is_not` / `not_equal`	`not_equals`
`greater_than`	`greater_than`
`lower_than`	`less_than`
`greater_equal_than`	`greater_than_or_equals`
`lower_equal_than`	`less_than_or_equals`
`contains`	`contains`
`not_contains`	`not_contains`

空值比较会自动转换为语义化的 is_answered / is_not_answered 运算符。

变量和隐藏字段

Typeform 计算变量（数字和文本）作为带有默认值的 NueForm 变量导入。
Typeform 隐藏字段作为默认值为空的字符串变量导入。它们在运行时会自动从 URL 参数填充，与在 Typeform 中的工作方式相同。

媒体附件

问题和选项上的图片和视频附件在导入时会被检测到。导入器将它们记录为引用原始 Typeform URL 的待处理媒体项。NueForm 会在导入过程中将这些媒体文件重新上传到自己的存储。

欢迎和感谢页面

第一个 Typeform 欢迎页面的标题、描述和按钮文本会被导入。
第一个 Typeform 感谢页面的标题和描述会被导入。

设置

进度条显示设置保留。

需要手动调整的内容

主题和样式

Typeform 主题不会自动转换。导入后：

在 NueForm 构建器中打开表单。
进入主题面板。
设置颜色、字体和样式以匹配您的品牌。

参阅主题与样式了解详情。

多个感谢页面

Typeform 支持多个感谢页面，但只有第一个会作为默认结束页面导入。如果您的 Typeform 使用条件感谢页面，您需要：

在 NueForm 中添加额外的 end_screen 问题。
设置分数范围或逻辑跳转，将填写者路由到适当的结束页面。

集成

第三方集成（例如 Zapier、Slack、Google Sheets）不会转移。您需要使用以下方式重新配置：

NueForm Webhooks 将数据推送到外部服务。
NueForm API 拉取响应数据。

支付配置

虽然支付问题的属性（货币、价格）会被导入，但您需要在 NueForm 中单独重新连接 Stripe 账户。

导入后检查清单

从 Typeform 导入表单后，请按此清单逐项检查：

[ ] 检查所有问题的类型和内容是否正确。
[ ] 使用不同答案提交表单来测试逻辑跳转。
[ ] 验证变量和隐藏字段是否正常工作。
[ ] 应用品牌主题（颜色、字体、Logo）。
[ ] 检查媒体附件是否正确加载。
[ ] 重新配置任何第三方集成。
[ ] 如需要，设置 Webhooks。
[ ] 如使用支付问题，重新连接 Stripe。
[ ] 端到端测试完整表单。
[ ] 满意后发布表单。

故障排除

问题	解决方案
部分问题缺失	该问题类型可能不受支持。请查看上方的类型映射表。
逻辑跳转不工作	确认目标问题存在。复杂的嵌套条件可能需要手动检查。
媒体图片损坏	导入器从 Typeform 下载媒体。如果 Typeform URL 已过期，您需要手动重新上传媒体。
变量未被填充	检查 URL 参数是否与变量名称完全匹配。
表单外观与 Typeform 不同	主题不会转移。请在 NueForm 构建器中手动设置样式。