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

# ServiceM8

借助以下 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，当来电者需要服务时，接待员可以在 ServiceM8 中创建报价或工作任务，并将新来电者添加为客户。

## 开始前

在 ServiceM8 中，打开 **设置** → **API 密钥** 并创建密钥。以下每个工具都会在 `X-Api-Key` 请求标头中发送该密钥。持有密钥的人可以读取和更改 ServiceM8 数据，因此请勿将其放入共享文档。

## 创建工具

对于每个工具，前往 **集成**，选择 **添加集成**，选择 **Webhook 工具**，并将 **分配给智能体** 设为 **接待员**。

### 创建工作任务

| 字段       | 值                                                                                                                                        |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**   | `create_servicem8_job`                                                                                                                   |
| **描述**   | "当来电者需要服务或想要报价时，创建工作任务。"                                                                                                                 |
| **方法**   | POST                                                                                                                                     |
| **URL**  | `https://api.servicem8.com/api_1.0/job.json`                                                                                             |
| **请求标头** | `X-Api-Key`：API 密钥                                                                                                                       |
| **正文参数** | `status`（字符串，必填）：“始终使用精确值 `Quote`。”  `job_address`（字符串，必填）：“需要服务地点的完整地址，包括邮编。”  `job_description`（字符串，必填）：“来电者姓名和电话号码，以及所需服务和提供的任何详细信息。” |

如果应直接将来电安排为已排期工作，请使用 `Work Order` 而非 `Quote`。

### 添加新客户

| 字段       | 值                                                         |
| -------- | --------------------------------------------------------- |
| **名称**   | `create_servicem8_client`                                 |
| **描述**   | "当来电者表示之前未使用过我们的服务时，将其添加为新客户。"                            |
| **方法**   | POST                                                      |
| **URL**  | `https://api.servicem8.com/api_1.0/company.json`          |
| **请求标头** | `X-Api-Key`：API 密钥                                        |
| **正文参数** | `name`（字符串，必填）：“来电者全名或企业名称。”  `address`（字符串）：“客户地址，包括邮编。” |

为每个工具选择 **启用**，然后通过咨询报价来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新报价会显示在 ServiceM8 中。

## 限制

* ServiceM8 对两个工具都仅返回 `OK`。新记录的 ID 位于接待员无法读取的响应标头中，因此无法将工作任务关联到客户。团队需要在 ServiceM8 中完成关联。
* ServiceM8 将电话号码和电子邮件保存在客户联系人中，这是一条独立记录，客户工具无法创建。因此，来电者号码会保留在工作任务描述中。
* 搜索现有客户需要 `$filter` 参数，而 webhook 工具参数名称不能包含 `$`，因此接待员无法查询来电者。

如需创建关联的客户和工作任务，请通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 使用 ServiceM8 的 **创建客户** 和 **创建工作任务** 操作。

## 故障排除

| 问题               | 检查内容                                                              |
| ---------------- | ----------------------------------------------------------------- |
| ServiceM8 返回 401 | 标头名称必须是 `X-Api-Key`，且包含有效密钥。                                      |
| 状态相关的 400 错误     | `status` 必须精确为 `Quote`、`Work Order`、`Unsuccessful` 或 `Completed`。 |
| 工作任务没有地址         | 确保描述要求接待员在创建工作任务前询问完整地址。                                          |
| ServiceM8 返回 429 | 已达到 ServiceM8 的请求限制。等待 1 分钟后重试。                                   |