> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Typeform

> 通过已连接的账户在 Typeform 中构建和管理表单、主题、工作区、图片和响应。

# Typeform

当你的工作流需要创建表单、更新表单，或查看传入的响应时，请使用 Typeform。你也可以管理工作区并自定义主题和图片。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 Typeform 账户。 |
| 操作 | 是 | 要执行的 Typeform 操作（例如 Get account details, List forms, Get form, Create form）。 |
| 参数 | 是 | 由操作的架构生成的每个操作对应的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| 当步骤失败时 | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在你配置此步骤之前，请通过登录流程在工作区的 **Integrations** 中连接 Typeform。如果没有可用的活动连接，步骤会显示一个警告，并带有指向 **Integrations** 的链接，而不是账户选择器。

## 参数表单

当你选择某个操作时，**Arguments** 部分会渲染一个由该操作输入架构驱动的表单。引用现有记录的字段包含下拉选择器。

当你更喜欢手动编写完整的参数对象时，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常用操作

| 操作 | 描述 |
| - | - |
| **Get account details** | 获取已连接的 Typeform 账户详情。 |
| **List forms** | 列出你 Typeform 账户中的表单。 |
| **Get form** | 获取某个表单的完整配置。 |
| **Create form** | 创建一个新的 Typeform 表单。 |
| **Patch form** | 使用 JSON Patch 操作部分更新表单。 |
| **Update form** | 替换表单的配置。 |
| **Get form responses** | 获取某个表单的响应。 |
| **Update form messages** | 更新表单的自定义 UI 消息。 |
| **List workspaces** | 列出你账户中的工作区。 |
| **Get workspace** | 获取某个工作区的详情。 |
| **List themes** | 列出你 Typeform 账户中的主题。 |
| **Get theme** | 获取某个主题的配置。 |
| **Create theme** | 创建一个新的自定义主题。 |

删除记录等破坏性操作不在工作流操作选择器中提供。

## 输出

此步骤会将 Typeform 响应存储为步骤输出。响应的结构取决于该操作。

在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做，请先连接 Typeform。
2. 向你的工作流添加一个 **Typeform** 步骤。
3. 在 **Authentication** 中选择一个已连接的账户。
4. 在 **Action** 中选择 **Get account details**。
5. 填写必填字段。对任何字段值，使用 **Insert Variable** 引用前一步的输出。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效载荷。

## 使用场景

### 创建潜在客户表单

1. Create form
2. Patch form
3. Update form messages

### 查看调查回复

1. List forms
2. Get form
3. Get form responses

### 设置新工作区

1. Create workspace
2. Update workspace
3. List workspaces

## 备注

* 此步骤依赖于你工作区中已连接的 Typeform 集成。
* 工作流操作选择器只会显示一组精选操作。拥有 Typeform 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Typeform 作为代理工具使用

你也可以在 **Agent Editor** 中将 Typeform 作为工具添加。打开代理，点击 **Add tool**，然后选择 **Typeform**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 Typeform 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.