Nutshell | ElevenLabs Documentation

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

查找来电者

创建 API 密钥

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

构建授权标头

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

printf 'YOUR_EMAIL:YOUR_API_KEY' | base64

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

请勿将 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。

添加 Nutshell 操作

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

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

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

分配工具

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

测试

使用保存在 Nutshell 联系人中的号码测试接待员，然后再以想要报价的新来电者身份测试。新联系人及其潜在客户会显示在 Nutshell 中。

限制

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

故障排除

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