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

# Zendesk

> 用于通过已连接账户管理工单、用户、组织和附件的客户支持软件。

# Zendesk

当你需要在工作流中处理 Zendesk 工单、用户或组织时，可以使用这个应用。你可以从已连接的账户中列出、搜索、创建和更新记录。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Zendesk 账户。 |
| Action | 是 | 要执行的 Zendesk 操作（例如 List Tickets、Search Zendesk、Create Ticket、List Ticket Audits）。 |
| Arguments | 是 | 根据操作的 schema 生成的每个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## 参数表单

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

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

## 常见操作

| 操作 | 说明 |
| - | - |
| **List Tickets** | 按筛选和分页列出工单。 |
| **Search Zendesk** | 使用查询语法搜索工单、用户、组织和群组。 |
| **Create Ticket** | 创建一个带有主题和描述的新工单。 |
| **List Ticket Audits** | 列出工单的变更历史。 |
| **Get Ticket Metrics** | 获取特定工单的指标。 |
| **Create Side Conversation** | 在工单上创建一个私密的侧边会话。 |
| **Download Attachment** | 下载工单附件的文件字节。 |
| **Get Attachment** | 获取工单附件的详细信息。 |
| **List Users** | 按分页列出用户。 |
| **Get User** | 通过数字 ID 获取单个用户。 |
| **List Organizations** | 列出账户中的所有组织。 |
| **Reply to Zendesk Ticket** | 通过添加评论回复 Zendesk 工单。 |

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

## 输出

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

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

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

## 示例

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

## 使用场景

### 从表单创建工单

1. Create Ticket
2. List Tickets
3. Search Zendesk

### 跟进工单

1. List Ticket Audits
2. Get Ticket Metrics
3. Make Comment Private

### 管理客户记录

1. List Users
2. Get User
3. Create Or Update Organization

## 注意事项

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

## 将 Zendesk 作为 Agent 工具使用

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

另见：[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.