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

# Copper

接待员可以识别已在 Copper 中的来电者，将新来电者添加为潜在客户，记录每位来电者的需求，并为团队创建后续任务。查找来电者和创建任务使用 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)。添加潜在客户和备注则通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 完成，因为 Copper 将电话号码和备注链接存储为 webhook 工具无法发送的嵌套数据。

## 开始前

在 Copper 中，打开 **系统设置** → **API 密钥**，然后选择 **生成 API 密钥**。例如，可将其标记为 `Reception.ai`。该密钥会以你的身份操作，因此可查看和更改你有权限查看和更改的内容。

下方每个 webhook 工具都会发送以下请求标头：

| 标头                 | 值               |
| ------------------ | --------------- |
| `X-PW-AccessToken` | API 密钥          |
| `X-PW-Application` | `developer_api` |
| `X-PW-UserEmail`   | 创建该密钥的用户邮箱地址    |

> **Warning**
>
> 持有 API 密钥和邮箱地址的任何人都可以读取和更改 Copper 数据。不要将密钥
> 放在共享文档中；如果泄露，请在 Copper 中将其删除。

## 创建 webhook 工具

对于每个工具，前往 **集成**，选择 **添加集成**，选择 **Webhook 工具**，并将 **分配给智能体** 设为 **接待员**。Copper 的搜索端点使用 POST，搜索条件放在请求正文中。

### 查找联系人

| 字段       | 值                                                       |
| -------- | ------------------------------------------------------- |
| **名称**   | `find_copper_person`                                    |
| **描述**   | "按电话号码在联系人中查找来电者。请在通话开始时使用，以确认对方是否为客户。"                 |
| **方法**   | POST                                                    |
| **URL**  | `https://api.copper.com/developer_api/v1/people/search` |
| **请求标头** | [开始前](#before-you-start)中的标头                            |
| **正文参数** | `phone_number`（字符串，必填）：“来电者的电话号码。”                      |

### 查找潜在客户

| 字段       | 值                                                      |
| -------- | ------------------------------------------------------ |
| **名称**   | `find_copper_lead`                                     |
| **描述**   | "按电话号码在潜在客户中查找来电者。来电者不是联系人时使用。"                        |
| **方法**   | POST                                                   |
| **URL**  | `https://api.copper.com/developer_api/v1/leads/search` |
| **请求标头** | [开始前](#before-you-start)中的标头                           |
| **正文参数** | `phone_number`（字符串，必填）：“来电者的电话号码。”                     |

### 创建后续任务

| 字段       | 值                                                                            |
| -------- | ---------------------------------------------------------------------------- |
| **名称**   | `create_copper_task`                                                         |
| **描述**   | "每当你承诺给来电者回电时，都为团队创建一个任务。"                                                   |
| **方法**   | POST                                                                         |
| **URL**  | `https://api.copper.com/developer_api/v1/tasks`                              |
| **请求标头** | [开始前](#before-you-start)中的标头                                                 |
| **正文参数** | `name`（字符串，必填）：“例如：就厨房报价回电给 Jane Doe。”  `details`（字符串，必填）：“来电者的姓名、电话号码及其需求。” |

在每个工具上选择 **启用**。

## 添加潜在客户和备注

### 连接 Zapier

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

### 添加 Copper 操作

在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，连接 Copper 账户并添加以下操作：

* **创建潜在客户**：将所有者和潜在客户来源设为固定值，并让 AI 填写来电者姓名、电话号码、邮箱地址及其需求。
* **创建活动**：将活动类型设为备注，并让 AI 填写搜索工具找到的人员或潜在客户，以及来电者的需求。

### 分配工具

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

### 测试

使用保存到 Copper 联系人的号码拨打电话，然后使用请求回电的新号码[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新来电者将显示为潜在客户，任务将显示在 Copper 中。

> **Tip**
>
> 添加一个[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，让接待员
> 先搜索联系人和潜在客户，仅当两项搜索都未找到来电者时创建潜在客户。

## 限制

* webhook 工具发送扁平值，而 Copper 使用嵌套值将任务关联到人员或潜在客户。因此，来自 `create_copper_task` 的任务不会关联到来电者记录；任务详情会保留来电者姓名和号码。
* Copper 使用 Unix 时间戳作为截止日期，AI 无法可靠计算，因此 `create_copper_task` 会将截止日期留空。
* 若要将任务关联到来电者或设置截止日期，请通过 Zapier 使用 Copper 的 **创建任务** 操作，而不是 webhook 工具。
* 接待员运行的每项 Zapier 操作都会消耗 Zapier 套餐中的任务额度。套餐额度用完后，操作会暂停，直至额度重置。

## 故障排除

| 问题                  | 检查内容                                                  |
| ------------------- | ----------------------------------------------------- |
| Copper 返回 401 或 403 | 检查全部 3 个标头。`X-PW-UserEmail` 必须是生成密钥的用户邮箱。             |
| 未找到已知来电者            | Copper 会按存储的格式匹配电话号码。请使用统一格式保存号码，并确认来电者是人员或潜在客户，而非公司。 |
| 接待员创建了重复潜在客户        | 在搜索工具的描述中说明，仅在未找到来电者时创建潜在客户。                          |
| 未显示 Copper 操作       | 在 Zapier 中添加操作后，在 Zapier 集成中选择 **刷新工具**。              |
| 操作显示 **已更改** 且未被使用  | 你已在 Zapier 中编辑该操作。请在 **工具** 标签页中选择 **更新**。            |