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

# Gorgias

> 用于通过已连接账户管理客户支持、工单、客户、团队和自动化的帮助台与实时聊天应用。

# Gorgias

当你需要在另一步中管理支持工单、客户记录或团队工作流时，可以使用 Gorgias。只要你已经有工单 ID 或客户详情，就可以选择 **List Tickets**、**Get Ticket**、**Send Ticket Message** 或 **Add Ticket Tags** 等操作。

## 配置

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

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

## Arguments form

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

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

## Common actions

| Action | Description |
| - | - |
| **List Tickets** | 列出 Gorgias 中的工单，并提供各种筛选选项。 |
| **Get Ticket** | 从 Gorgias 获取特定工单。 |
| **Create Ticket** | 在 Gorgias 中创建一个新工单。 |
| **Update Ticket** | 更新 Gorgias 中现有的工单。 |
| **List Messages** | 列出 Gorgias 中的消息，可按工单筛选。 |
| **Send Ticket Message** | 在现有的 Gorgias 工单上发送一条外部投递的消息。 |
| **List Customers** | 列出 Gorgias 中的客户，并提供各种筛选选项。 |
| **Get Customer** | 从 Gorgias 获取特定客户。 |
| **Create Customer** | 在 Gorgias 中创建一个新客户。 |
| **Update Customer** | 更新现有客户。 |
| **List Teams** | 列出 Gorgias 中的团队。 |
| **Get Team** | 从 Gorgias 获取特定团队。 |
| **List Views** | 列出已保存的工单视图，可按类别筛选。 |

破坏性操作，例如删除记录，不会出现在工作流操作选择器中。

## 输出

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

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

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

## 示例

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

## Use cases

### 回复一个打开的工单

1. List Tickets
2. Get Ticket
3. Send Ticket Message

### 给客户问题添加标签

1. List Tickets
2. Get Ticket
3. List Tags
4. Add Ticket Tags

### 创建并分配客户

1. Create Customer
2. Create Ticket
3. List Teams
4. Update Ticket

## Notes

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

## 作为代理工具使用 Gorgias

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

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