> ## 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.

# Zoho

> Zoho CRM 可通过你连接的账号帮助你管理销售和客户数据。

# Zoho

当你的工作流需要读取或更新客户记录、销售机会、线索、事件或备注时，请使用 Zoho CRM。如果你已经从上一步获取了记录 ID，可选择像 Get contact 或 Update deal 这样的操作。

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | 工作流画布中该步骤的标签。 |
| Authentication | Yes | 此步骤要使用的已连接 Zoho 账号。 |
| Action | Yes | 要执行的 Zoho 操作（例如 List accounts、Get account、Update account、List contacts）。 |
| Arguments | Yes | 由该操作的 schema 生成的按操作区分的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | No | 控制当此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

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

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

## Common actions

| Action | Description |
| - | - |
| **List accounts** | 列出 Zoho CRM 中的账号记录。 |
| **Get account** | 通过 ID 获取单个账号记录。 |
| **Update account** | 更新现有账号上的字段。 |
| **List contacts** | 列出 Zoho CRM 中的联系人记录。 |
| **Get contact** | 通过 ID 获取单个联系人记录。 |
| **Create contact** | 创建新的联系人记录。 |
| **Update record** | 更新任何受支持模块中的现有记录。 |
| **List deals** | 列出 Zoho CRM 中的交易记录。 |
| **Get record** | 按模块和 ID 获取单个 CRM 记录。 |
| **Create deal** | 创建新的交易记录。 |
| **Update deal** | 更新现有交易上的字段。 |
| **List leads** | 列出 Zoho CRM 中的线索记录。 |
| **Create lead** | 创建新的线索记录。 |
| **Convert lead** | 将线索转换为相关的 CRM 记录。 |
| **List events** | 列出 Zoho CRM 中的事件记录。 |

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

## Output

此步骤会将 Zoho 响应存储为步骤输出。响应的形状取决于操作。

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

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

## Example

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

## Use cases

### Create a contact from form data

1. Create contact
2. Get contact
3. Update record

### Follow up on a new deal

1. Create deal
2. Create event
3. Create note

### Work a new lead

1. Create lead
2. Convert lead
3. Update deal

## Notes

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

## Using Zoho as an Agent Tool

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

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [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.