> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ServiceTitan

接待员可以在 ServiceTitan 中查询来电者，将新工作作为预约发送给电话受理员审核，并告知现有客户下次预约时间。ServiceTitan 的 API 会使用客户端 ID 和密钥换取短期令牌，还需要应用密钥，而 webhook 工具无法实现这一流程，因此 Reception 通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 连接。

## 开始前

ServiceTitan 的 Zapier 集成处于公开测试阶段，ServiceTitan 按现状提供该集成。连接步骤如下：

1. ServiceTitan 管理员提交 ServiceTitan 的 Zapier 注册表单。ServiceTitan 会联系你说明后续步骤。
2. 在 ServiceTitan 中，前往 **设置** → **集成** → **API 应用访问权限**，选择 **连接新应用**，然后选择 **Zapier 3.0.X**。
3. 查看权限范围，选择一个 **预约提供方** 选项，然后选择 **允许访问**。
4. 生成客户端密钥并复制它，同时复制客户端 ID 和租户 ID。

> **Warning**
>
> 客户端密钥可访问 ServiceTitan 数据。请妥善保管，切勿分享。

## 设置

### 连接 Zapier

如果尚未连接，请在 Reception.ai 中连接 [Zapier](/docs/zh/reception-ai/integrations/zapier)。

### 添加 ServiceTitan 操作

在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，从 **ServiceTitan (3.0.X)** 应用添加[以下操作](#actions)。连接时，输入租户 ID、客户端 ID 和客户端密钥，并选择生产环境。按下方说明，为每个字段设置固定值，或让 AI 填写。

### 分配工具

在 Reception.ai 中，打开 Zapier 集成的 **工具** 标签页，选择 **刷新工具**，然后将每项操作分配给 **客户**（接待员）。

### 测试

以需要维修的新来电者身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)。预约将显示在 ServiceTitan 中供团队审核。

## 操作

### 查找来电者

| 字段               | 值                      |
| ---------------- | ---------------------- |
| **Zapier 操作**    | **搜索客户**               |
| **在 Zapier 中设置** | 无。                     |
| **让 AI 填写**      | **电话**（来电者号码）或 **姓名**。 |
| **分配给**          | **客户**                 |

### 发送预约

预约是发送新工作的最安全方式。电话受理员会在 ServiceTitan 中审核，并将其转为工作任务，因此接待员不会直接占用调度面板。

| 字段               | 值                                                                             |
| ---------------- | ----------------------------------------------------------------------------- |
| **Zapier 操作**    | **创建预约**                                                                      |
| **在 Zapier 中设置** | **预约提供方**、**来源**（例如 `Reception`），以及可选的 **业务部门**、**工作类型**和 **营销活动**。           |
| **让 AI 填写**      | **姓名**、**摘要**（问题、来电者电话号码及可服务时间）、**是否首次客户**、服务地址、**开始时间**（来电者首选时间）和 **外部 ID**。 |
| **分配给**          | **客户**                                                                        |

每个预约的 **外部 ID** 必须唯一。添加一项[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，告知接待员使用来电者电话号码加上当前日期和时间。

### 查询客户预约

| 字段               | 值                        |
| ---------------- | ------------------------ |
| **Zapier 操作**    | **搜索预约**                 |
| **在 Zapier 中设置** | 无。                       |
| **让 AI 填写**      | 来自 **搜索客户** 的 **客户 ID**。 |
| **分配给**          | **客户**                   |

## 限制

* Zapier 的 ServiceTitan 应用无法查询容量或技术人员空闲情况，因此预约中的时间只是来电者偏好，并非确认时段。
* **创建工作任务** 和 **创建预约** 需要地点、业务部门、工作类型和营销活动的 ID，且会直接写入日程。请交由电话受理员处理。
* 该集成处于公开测试阶段，ServiceTitan 未提供官方支持。
* 接待员运行的每项操作都会消耗 Zapier 套餐任务数。Zapier 目前每次成功调用计为 2 个任务，失败调用不计数。套餐用尽后，操作会暂停，直至额度重置。

## 故障排除

| 问题                                | 检查内容                                            |
| --------------------------------- | ----------------------------------------------- |
| Reception.ai 中未显示 ServiceTitan 操作 | 在 Zapier 中添加操作后，选择 Zapier 集成中的 **刷新工具**。        |
| 操作显示 **已更改**，且未被使用                | 你在 Zapier 中编辑了该操作。在 **工具** 标签页中选择 **更新**。       |
| Zapier 无法连接 ServiceTitan          | 检查注册是否已获批准，并确认使用的是 3.0.X 客户端 ID 和密钥，而非旧 API 密钥。 |
| 预约出现 `UniqueConstraint` 错误        | **外部 ID** 与之前的预约重复。请确保其中包含日期和时间。                |
| 未找到已知客户                           | 除电话号码外，也尝试使用来电者姓名。                              |