Typeform 是一个用户友好的平台，用于创建注重用户体验的对话式表单、调查和测验。
使用 Typeform，您可以：
- 创建互动表单：设计美观的对话式表单，通过独特的一次一问界面吸引受访者
- 自定义您的体验：使用条件逻辑、隐藏字段和自定义主题，创建个性化的用户旅程
- 与其他工具集成：通过原生集成和 API 连接 1000 多个应用程序
- 分析响应数据：通过全面的分析和报告工具获取可操作的洞察
在 Sim 中，Typeform 集成使您的代理能够以编程方式将 Typeform 数据纳入其工作流程。代理可以检索表单响应、处理提交数据，并将用户反馈直接纳入决策过程。此集成在潜在客户资格审查、客户反馈分析和数据驱动的个性化场景中特别有价值。通过将 Sim 与 Typeform 连接，您可以创建智能自动化工作流程，将表单响应转化为可操作的洞察——分析情绪、分类反馈、生成摘要，甚至根据特定的响应模式触发后续操作。
将 Typeform 集成到工作流程中。可以检索响应、下载文件并获取表单洞察。可以在触发模式下使用，当提交表单时触发工作流程。需要 API 密钥。
从 Typeform 检索表单响应
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Typeform 表单 ID |
apiKey | string | 是 | Typeform 个人访问令牌 |
pageSize | number | 否 | 要检索的响应数量 (默认值：25) |
since | string | 否 | 检索此日期之后提交的响应 (ISO 8601 格式) |
until | string | 否 | 检索此日期之前提交的响应 (ISO 8601 格式) |
completed | string | 否 | 按完成状态过滤 (true/false) |
| 参数 | 类型 | 描述 |
|---|
total_items | number | 响应的总数 |
page_count | number | 可用页面的总数 |
items | array | 包含 response_id、submitted_at、answers 和 metadata 的响应对象数组 |
下载 Typeform 响应中上传的文件
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Typeform 表单 ID |
responseId | string | 是 | 包含文件的响应 ID |
fieldId | string | 是 | 文件上传字段的唯一 ID |
filename | string | 是 | 上传文件的文件名 |
inline | boolean | 否 | 是否以内联 Content-Disposition 请求文件 |
apiKey | string | 是 | Typeform 个人访问令牌 |
| 参数 | 类型 | 描述 |
|---|
fileUrl | string | 上传文件的直接下载 URL |
contentType | string | 上传文件的 MIME 类型 |
filename | string | 上传文件的原始文件名 |
获取 Typeform 表单的洞察和分析
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Typeform 表单 ID |
apiKey | string | 是 | Typeform 个人访问令牌 |
| 参数 | 类型 | 描述 |
|---|
fields | 数组 | 在此字段中流失的用户数量 |
检索 Typeform 帐户中所有表单的列表
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | Typeform 个人访问令牌 |
search | string | 否 | 按标题过滤表单的搜索查询 |
page | number | 否 | 页码 (默认值：1) |
pageSize | number | 否 | 每页表单数量 (默认值：10，最大值：200) |
workspaceId | string | 否 | 按工作区 ID 过滤表单 |
| 参数 | 类型 | 描述 |
|---|
total_items | number | 账户中的表单总数 |
page_count | number | 可用页面的总数 |
items | array | 包含 id、title、created_at、last_updated_at、settings、theme 和 _links 的表单对象数组 |
检索特定表单的完整详细信息和结构
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | Typeform 个人访问令牌 |
formId | string | 是 | 表单唯一标识符 |
| 参数 | 类型 | 描述 |
|---|
id | string | 表单唯一标识符 |
title | string | 表单标题 |
type | string | 表单类型 (form, quiz 等) |
settings | object | 表单设置，包括语言、进度条等 |
theme | object | 主题引用 |
workspace | object | 工作区引用 |
fields | array | 表单字段/问题数组 |
welcome_screens | array | 欢迎页面数组 |
thankyou_screens | array | 感谢页面数组 |
_links | object | 包括公共表单 URL 在内的相关资源链接 |
创建一个包含字段和设置的新表单
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | Typeform 个人访问令牌 |
title | string | 是 | 表单标题 |
type | string | 否 | 表单类型 (默认值："form")。选项："form"，"quiz" |
workspaceId | string | 否 | 创建表单的工作区 ID |
fields | json | 否 | 定义表单结构的字段对象数组。每个字段需要：类型、标题和可选属性/验证 |
settings | json | 否 | 表单设置对象 (语言、进度条等) |
themeId | string | 否 | 应用于表单的主题 ID |
| 参数 | 类型 | 描述 |
|---|
id | string | 创建的表单唯一标识符 |
title | string | 表单标题 |
type | string | 表单类型 |
fields | array | 创建的表单字段数组 |
_links | object | 包括公共表单 URL 在内的相关资源链接 |
使用 JSON Patch 操作更新现有表单
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | Typeform 个人访问令牌 |
formId | string | 是 | 要更新的表单唯一标识符 |
operations | json | 是 | JSON Patch 操作数组 (RFC 6902)。每个操作需要：op (add/remove/replace)、path 和 value (用于 add/replace) |
| 参数 | 类型 | 描述 |
|---|
id | string | 更新的表单唯一标识符 |
title | string | 表单标题 |
type | string | 表单类型 |
settings | object | 表单设置 |
theme | object | 主题引用 |
workspace | object | 工作区引用 |
fields | array | 表单字段数组 |
welcome_screens | array | 欢迎屏幕数组 |
thankyou_screens | array | 感谢屏幕数组 |
_links | object | 相关资源链接 |
永久删除表单及其所有响应
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | Typeform 个人访问令牌 |
formId | string | 是 | 要删除的表单唯一标识符 |
| 参数 | 类型 | 描述 |
|---|
deleted | boolean | 表单是否成功删除 |
message | string | 删除确认消息 |
