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

# Nutshell

接待员可以识别已存在于 Nutshell 中的来电者，也可以将新来电者添加为联系人和潜在客户，供团队跟进。查找来电者需使用 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)。添加联系人和潜在客户则通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 完成，因为 Nutshell 的 API 创建记录时需要列表和嵌套值，而 webhook 工具无法发送这些内容。

## 查找来电者

### 创建 API 密钥

在 Nutshell 中，选择左下角的 **Settings**，然后在 **Connections** 下选择 **API keys**。选择 **Add API key**，并选择 Zapier 也需要的 **API + user impersonation**。复制密钥。

### 构建授权标头

Nutshell 的 API 将 Nutshell 邮箱地址用作用户名，将 API 密钥用作密码。在终端中对它们进行编码：替换两个值，并保留其间的冒号：

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

标头值为 `Basic ` 后接输出结果。

> **Warning**
>
> 请勿将 API 密钥粘贴到在线编码器中。任何拥有该密钥或已编码标头的人都能读取和修改 Nutshell 数据。

### 创建 webhook 工具

前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

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

选择 **Enable**。

## 添加联系人和潜在客户

### 连接 Zapier

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

### 添加 Nutshell 操作

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

* **Create Person**：让 AI 填写来电者的姓名、电话号码和邮箱地址。
* **Create Lead**：将来源、管道和负责人设为固定值，并让 AI 填写来电者需求描述及对应联系人。

> **Tip**
>
> 若要在联系人的时间线上记录通话，还可添加 **Log Activity**，并让 AI 填写简短摘要。

### 分配工具

在 Reception.ai 中，打开 Zapier 集成的 **Tools** 标签页，选择 **Refresh tools**，然后将 Nutshell 操作分配给 **Client**（接待员）。

### 测试

使用保存在 Nutshell 联系人中的号码 [测试接待员](/docs/zh/reception-ai/receptionist/testing)，然后再以想要报价的新来电者身份测试。新联系人及其潜在客户会显示在 Nutshell 中。

## 限制

* Zapier 的 Nutshell 应用没有创建后续任务的操作。潜在客户负责人会在 Nutshell 中看到新的潜在客户。
* Zapier 的 Nutshell 应用无法检查任何人的可用时间，因此接待员无法在 Nutshell 中预约会议。请使用 Reception 自带的预约功能和 [Google Calendar](/docs/zh/reception-ai/integrations/google-calendar)。
* 接待员每运行一次 Zapier 操作，都会消耗 Zapier 套餐中的任务数。Zapier 当前每次成功通话计为 2 个任务；失败的通话不计入。套餐额度用完后，操作会停止，直到额度重置。

## 故障排除

| 问题                            | 检查内容                                              |
| ----------------------------- | ------------------------------------------------- |
| Nutshell 返回 401               | 对 Nutshell 邮箱地址、冒号和密钥进行编码，并以 `Basic ` 开头填写标头值。    |
| 未找到已知来电者                      | 尝试使用保存在 Nutshell 联系人中的号码进行测试通话，或改为询问来电者姓名。        |
| 接待员创建重复联系人                    | 在查找工具的描述中告知它：仅当未找到来电者时才添加联系人。                     |
| Reception.ai 中未显示 Nutshell 操作 | 在 Zapier 中添加操作后，在 Zapier 集成中选择 **Refresh tools**。 |
| Zapier 无法连接 Nutshell          | 使用具有 **API + user impersonation** 的 API 密钥。       |