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

# FieldPulse

使用以下 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，接待员可以识别已在 FieldPulse 中的来电者，将新来电者添加为潜在客户，并在客户记录中留言说明他们的需求，方便团队跟进。

## 开始前

FieldPulse 按需提供 API 密钥。请通过 [support@fieldpulse.com](mailto:support@fieldpulse.com) 联系 FieldPulse 支持团队，或通过应用内聊天索取 API 密钥。以下每个工具都会在请求标头 `x-api-key` 中发送该密钥。

> **Warning**
>
> API 密钥可读取和更改 FieldPulse 数据。请妥善保存，切勿分享。

## 创建工具

对于每个工具，前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**，并将 **Assign to agents** 设为 **Receptionist**。

### 查找来电者

| 字段       | 值                                                                        |
| -------- | ------------------------------------------------------------------------ |
| **名称**   | `find_fieldpulse_customer`                                               |
| **说明**   | "按姓名或电话号码在客户列表中查找来电者。在有关工作事项的通话开始时使用。"                                   |
| **方法**   | GET                                                                      |
| **URL**  | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers` |
| **请求标头** | `x-api-key`：API 密钥                                                       |
| **查询参数** | `search`（字符串，必填）：“来电者的全名或电话号码。”                                          |

### 添加新客户

| 字段       | 值                                                                                                                                                                                                                                                                                                                                |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**   | `create_fieldpulse_customer`                                                                                                                                                                                                                                                                                                     |
| **说明**   | "当 `find_fieldpulse_customer` 未找到来电者时，将其添加为新客户。"                                                                                                                                                                                                                                                                                 |
| **方法**   | POST                                                                                                                                                                                                                                                                                                                             |
| **URL**  | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                                                                                                                                                                                         |
| **请求标头** | `x-api-key`：API 密钥                                                                                                                                                                                                                                                                                                               |
| **正文参数** | `first_name`（字符串，必填）：“来电者的名字。”  `last_name`（字符串，必填）：“来电者的姓氏。”  `phone`（字符串，必填）：“来电者的电话号码，包含区号。”  `email`（字符串）：“来电者提供的电子邮件地址（如有）。”  `status`（字符串，必填）：“始终使用精确值 `lead`。”  `service_address_1`（字符串）：“需要服务的街道地址。”  `service_address_city`（字符串）：“该地址所在城市。”  `service_address_state`（字符串）：“州。”  `service_address_zip_code`（字符串）：“邮政编码。” |

### 记录通话详情

| 字段       | 值                                                                                                                                                                                      |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**   | `add_fieldpulse_comment`                                                                                                                                                               |
| **说明**   | "在来电者的客户记录中留言说明其需求。获取客户 id 后使用。"                                                                                                                                                       |
| **方法**   | POST                                                                                                                                                                                   |
| **URL**  | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`                                                                                                                |
| **请求标头** | `x-api-key`：API 密钥                                                                                                                                                                     |
| **正文参数** | `commentable_type`（字符串，必填）：“始终使用精确值 `customer`。”  `commentable_id`（数字，必填）：“客户的 id，来自 `find_fieldpulse_customer` 或 `create_fieldpulse_customer`。”  `text`（字符串，必填）：“来电者的需求、可服务时间以及联系方式。” |

在每个工具上选择 **Enable**，然后以需要维修的新来电者身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)。该客户会作为潜在客户出现在 FieldPulse 中，并附有接待员的留言。

> **Tip**
>
> 为新工作添加[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)：查找来电者，
> 未找到则添加，然后记录通话详情。

## 限制

* 工作任务需要 FieldPulse 账户中的任务类型、状态和账单详情，因此接待员不会创建任务。团队可将潜在客户转为任务。
* 接待员无法查看技术人员的可用时间或预约时间。
* Webhook 工具无法发送列表，因此这些工具无法为客户添加标签或自定义字段。

## 故障排除

| 问题                | 检查项                                           |
| ----------------- | --------------------------------------------- |
| FieldPulse 返回 401 | 标头必须命名为 `x-api-key`，且包含有效密钥。                  |
| FieldPulse 返回 400 | 查看响应中的错误列表。`status` 必须精确为 `lead`，且电话号码必须有效。   |
| 找不到已知来电者          | FieldPulse 会按已存储的信息匹配。请尝试来电者姓名和电话号码。          |
| 未添加留言             | `commentable_id` 必须是现有客户的 id。检查是否先运行了查找或创建工具。 |
| FieldPulse 返回 429 | 已达到 FieldPulse 的请求限制。请稍后重试。                   |