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

# Capsule CRM

接待员可以识别已在 Capsule 中的来电者，将新来电者添加为联系人，记录每位来电者的需求，并为团队创建后续任务。查找来电者使用 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)。添加联系人、备注和任务则通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 完成，因为 Capsule 的 API 需要嵌套请求正文，而 webhook 工具无法发送。

## 查找来电者

### 创建 API 令牌

在 Capsule 中，打开 **我的偏好设置** → **API 身份验证令牌**，然后生成一个新令牌。例如，可将其命名为 `Reception.ai`。该令牌会以你的身份操作，因此可查看和更改你有权限查看和更改的内容。

> **Warning**
>
> 持有该令牌的任何人都可以读取和更改 Capsule 数据。不要将其放在共享文档中；如果泄露，请在 Capsule 中将其删除。

### 创建 webhook 工具

前往 **集成**，选择 **添加集成**，然后选择 **Webhook 工具**。

| 字段         | 值                                                  |
| ---------- | -------------------------------------------------- |
| **名称**     | `find_capsule_contact`                             |
| **描述**     | "按电话号码、姓名或邮箱在 CRM 中查找来电者。请在通话开始时使用，以确认对方是否为现有客户。"  |
| **方法**     | GET                                                |
| **URL**    | `https://api.capsulecrm.com/api/v2/parties/search` |
| **请求标头**   | `Authorization`：`Bearer ` 后加令牌                     |
| **查询参数**   | `q`（字符串，必填）：“来电者的电话号码、全名或邮箱地址。”                    |
| **分配给智能体** | **接待员**                                            |

选择 **启用**。搜索将返回与 Capsule 自带搜索栏相同的结果。

## 添加联系人、备注和任务

### 连接 Zapier

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

### 添加 Capsule 操作

在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，连接 Capsule CRM 账户并添加[以下操作](#actions)。对于每个字段，按下方说明设置固定值，或让 AI 填写。

### 分配工具

在 Reception.ai 中，打开 Zapier 集成的 **工具** 标签页，选择 **刷新工具**，然后按下方说明分配每项操作。

### 测试

使用保存到 Capsule 联系人的号码拨打电话，然后以请求回电的新来电者身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新联系人、备注和任务将显示在 Capsule 中。

## 操作

### 添加来电者

| 字段               | 值                |
| ---------------- | ---------------- |
| **Zapier 操作**    | **创建联系人**        |
| **在 Zapier 中设置** | 类型（人员）、所有者和任意标签。 |
| **让 AI 填写**      | 名、姓、电话号码和邮箱地址。   |
| **分配给**          | **客户**           |

### 记录备注

| 字段               | 值                                                 |
| ---------------- | ------------------------------------------------- |
| **Zapier 操作**    | **向实体添加备注**                                       |
| **在 Zapier 中设置** | 要添加备注的记录类型：联系人。                                   |
| **让 AI 填写**      | 联系人 ID（来自 `find_capsule_contact` 或 **创建联系人**）和备注。 |
| **分配给**          | **客户**                                            |

### 创建后续任务

| 字段               | 值                  |
| ---------------- | ------------------ |
| **Zapier 操作**    | **创建任务**           |
| **在 Zapier 中设置** | 负责回电的团队成员。         |
| **让 AI 填写**      | 描述、截止日期以及任务对应的联系人。 |
| **分配给**          | **客户**             |

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

## 限制

* Zapier 的 Capsule 应用无法查看任何人的空闲时间，因此接待员无法在 Capsule 中预约会议。请改用后续任务，或使用 Reception 自带的 [Google 日历](/docs/zh/reception-ai/integrations/google-calendar) 预约功能。
* 接待员运行的每项 Zapier 操作都会消耗 Zapier 套餐中的任务额度。Zapier 目前每次成功调用计为 2 个任务；失败调用不计数。套餐额度用完后，操作会暂停，直至额度重置。

## 故障排除

| 问题                           | 检查内容                                         |
| ---------------------------- | -------------------------------------------- |
| Capsule 返回 401               | 标头值应以 `Bearer ` 和一个空格开头，并确认令牌未被删除。           |
| 未找到已知来电者                     | Capsule 会按存储的格式匹配电话号码。请使用统一格式保存号码，或按姓名或邮箱搜索。 |
| 接待员创建了重复联系人                  | 在查找工具的描述中说明，仅在未找到来电者时添加联系人。                  |
| Reception.ai 中未显示 Capsule 操作 | 在 Zapier 中添加操作后，在 Zapier 集成中选择 **刷新工具**。     |
| 操作显示 **已更改** 且未被使用           | 你已在 Zapier 中编辑该操作。请在 **工具** 标签页中选择 **更新**。   |