---
title: Typeform
description: 与 Typeform 互动
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="typeform"
  color="#262627"
/>

{/* MANUAL-CONTENT-START:intro */}
[Typeform](https://www.typeform.com/) 是一个用户友好的平台，用于创建注重用户体验的对话式表单、调查和测验。

使用 Typeform，您可以：

- **创建互动表单**：设计美观的对话式表单，通过独特的一次一问界面吸引受访者
- **自定义您的体验**：使用条件逻辑、隐藏字段和自定义主题，创建个性化的用户旅程
- **与其他工具集成**：通过原生集成和 API 连接 1000 多个应用程序
- **分析响应数据**：通过全面的分析和报告工具获取可操作的洞察

在 Sim 中，Typeform 集成使您的代理能够以编程方式将 Typeform 数据纳入其工作流程。代理可以检索表单响应、处理提交数据，并将用户反馈直接纳入决策过程。此集成在潜在客户资格审查、客户反馈分析和数据驱动的个性化场景中特别有价值。通过将 Sim 与 Typeform 连接，您可以创建智能自动化工作流程，将表单响应转化为可操作的洞察——分析情绪、分类反馈、生成摘要，甚至根据特定的响应模式触发后续操作。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Typeform 集成到工作流程中。可以检索响应、下载文件并获取表单洞察。可以在触发模式下使用，当提交表单时触发工作流程。需要 API 密钥。

## 工具

### `typeform_responses`

从 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_files`

下载 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_insights`

获取 Typeform 表单的洞察和分析

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | 是 | Typeform 表单 ID |
| `apiKey` | string | 是 | Typeform 个人访问令牌 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `fields` | 数组 | 在此字段中流失的用户数量 |

### `typeform_list_forms`

检索 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 的表单对象数组 |

### `typeform_get_form`

检索特定表单的完整详细信息和结构

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `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 | 感谢页数组 |
| `created_at` | string | 表单创建时间戳（ISO 8601 格式） |
| `last_updated_at` | string | 表单最后更新时间戳（ISO 8601 格式） |
| `published_at` | string | 表单发布时间戳（ISO 8601 格式） |
| `_links` | object | 相关资源链接，包括公开表单 URL |

### `typeform_create_form`

创建一个包含字段和设置的新表单

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `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 | 表单类型 |
| `settings` | object | 表单设置对象 |
| `theme` | object | 主题引用 |
| `workspace` | object | 工作区引用 |
| `fields` | array | 已创建表单字段数组（如未添加则为空） |
| `welcome_screens` | array | 欢迎页数组（如未配置则为空） |
| `thankyou_screens` | array | 感谢页数组 |
| `_links` | object | 相关资源链接，包括公开表单 URL |

### `typeform_update_form`

使用 JSON Patch 操作更新现有表单

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Typeform 个人访问令牌 |
| `formId` | string | 是 | 要更新的表单唯一标识符 |
| `operations` | json | 是 | JSON Patch 操作数组 \(RFC 6902\)。每个操作需要：op \(add/remove/replace\)、path 和 value \(用于 add/replace\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功确认消息 |

### `typeform_delete_form`

永久删除表单及其所有响应

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Typeform 个人访问令牌 |
| `formId` | string | 是 | 要删除的表单唯一标识符 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `deleted` | boolean | 表单是否成功删除 |
| `message` | string | 删除确认消息 |
