> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Attio

接待员可以识别已存在于 Attio 中的来电者，将新来电者按姓名和电话号码添加为人员，并记录他们的诉求，方便团队跟进。有两种连接方式：

* **[Webhook 工具](#option-1-webhook-tools-recommended)** 直接调用 Attio 的 API，无需 Zapier 账户，也不消耗 Zapier 任务数。
* **[Zapier](#option-2-zapier)** 操作会代你登录 Attio，但每项操作都会消耗 Zapier 套餐中的任务数。

除非无法让 Attio 管理员创建访问令牌，否则请使用 Webhook 工具。

## 选项 1：Webhook 工具（推荐）

### 创建访问令牌

你需要是 Attio 管理员。选择工作区名称旁的下拉菜单，打开 **工作区设置**，进入 **开发者** 标签页，然后选择 **新建访问令牌**。为它命名，例如 `Reception.ai`，并仅授予这些工具所需的权限范围：读取对象配置（`object_configuration:read`）、读写记录（`record_permission:read-write`）和读写备注（`note:read-write`）。Attio 中的标签名称可能与这些名称略有不同。

令牌不会过期，并且可以查看工作区中的所有人员。如果令牌泄露，请在 Attio 中删除它。

### 创建 Webhook 工具

对于以下每个[工具](#find-the-caller)，依次进入 **集成**，选择 **添加集成**，然后选择 **Webhook Tool**。每个工具都发送相同的请求头：`Authorization`（Secret），设为 `Bearer ` 后接令牌。

### 添加规则

添加一条[规则](/docs/zh/reception-ai/receptionist/rules-and-procedures)，告知接待员只能使用 Attio 识别来电者，绝不能向来电者读出记录或备注。

### 查找来电者

| 字段         | 值                                                          |
| ---------- | ---------------------------------------------------------- |
| **名称**     | `find_attio_person`                                        |
| **描述**     | "按电话号码在 Attio 的人员中查找来电者。请在通话开始时使用。将该人员的 record_id 传给备注工具。" |
| **方法**     | POST                                                       |
| **URL**    | `https://api.attio.com/v2/objects/people/records/query`    |
| **请求头**    | `Authorization`（Secret）：`Bearer ` 后接令牌                     |
| **请求体参数**  | `filter`（对象，必填），包含以下字段  `limit`（整数，固定值）：`5`                |
| **分配给智能体** | **Receptionist**                                           |

在 `filter` 上选择 **添加字段**，然后添加：

* `phone_numbers`（字符串，必填，来自对话）：“采用国际格式的来电者电话号码，例如 +14155550123。”

Attio 仅返回已保存号码完全匹配的人员，因此请使用带国家/地区代码的号码。

### 添加来电者

| 字段         | 值                                                                 |
| ---------- | ----------------------------------------------------------------- |
| **名称**     | `create_attio_person`                                             |
| **描述**     | "仅当 `find_attio_person` 未找到来电者时，才将其添加为人员。将新人员的 record_id 传给备注工具。" |
| **方法**     | POST                                                              |
| **URL**    | `https://api.attio.com/v2/objects/people/records`                 |
| **请求头**    | `Authorization`（Secret）：`Bearer ` 后接令牌                            |
| **请求体参数**  | `data`（对象，必填），包含以下字段                                              |
| **分配给智能体** | **Receptionist**                                                  |

在 `data` 上选择 **添加字段**，并添加 `values`（对象，必填）。在 `values` 中添加：

* `name`（对象，必填），包含 3 个字段：
  * `first_name`（字符串，必填，来自对话）：“来电者的名字。”
  * `last_name`（字符串，必填，来自对话）：“来电者的姓氏；若未提供，则为空字符串。”
  * `full_name`（字符串，必填，来自对话）：“来电者的名字和姓氏。”
* `phone_numbers`（数组，必填，来自对话）：“仅包含 1 个项目，即来电者的电话号码。”在 **每个项目** 下选择 `string`，描述为“采用国际格式的来电者电话号码，例如 +14155550123。”
* `email_addresses`（数组，来自对话）：“仅包含 1 个项目，即来电者的邮箱地址。若未提供，请省略。”在 **每个项目** 下选择 `string`，描述为“来电者的邮箱地址。”

### 记录备注

| 字段         | 值                                      |
| ---------- | -------------------------------------- |
| **名称**     | `add_attio_note`                       |
| **描述**     | "在通话结束前，在该人员记录中备注来电者的诉求。"              |
| **方法**     | POST                                   |
| **URL**    | `https://api.attio.com/v2/notes`       |
| **请求头**    | `Authorization`（Secret）：`Bearer ` 后接令牌 |
| **请求体参数**  | `data`（对象，必填），包含以下字段                   |
| **分配给智能体** | **Receptionist**                       |

在 `data` 上为以下每一项选择 **添加字段**：

* `parent_object`（字符串，固定值）：`people`
* `parent_record_id`（字符串，必填，来自对话）：“来自 `find_attio_person` 或 `create_attio_person` 的人员 record_id。”
* `title`（字符串，必填，来自对话）：“简短标题，例如：Jane Doe 来电咨询报价。”
* `format`（字符串，固定值）：`plaintext`
* `content`（字符串，必填，来自对话）：“用几句话说明来电者的诉求。”

父对象和格式均为固定值，因此即使 AI 发送其他值，备注也始终会添加到人员记录中。

> **Warning**
>
> `find_attio_person` 会返回该人员记录中保存的所有内容。请保留此规则，确保
> 接待员仅使用 Attio 识别来电者，且来电者绝不会听到其他人员的
> 详细信息。

在每个工具上选择 **启用**，然后使用已保存到 Attio 人员记录的号码来电，以及时以请求回电的新来电者身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新人员和一条备注将显示在 Attio 中。

## 选项 2：Zapier

### 连接 Zapier

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

### 添加 Attio 操作

在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，从 **Attio** 应用添加以下[操作](#zapier-actions)，并连接 Attio 工作区。对于每个字段，请按列表所示设置固定值或让 AI 填写。

### 分配工具

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

### 添加规则

添加一条[规则](/docs/zh/reception-ai/receptionist/rules-and-procedures)，告知接待员只能使用 Attio 识别来电者，绝不能向来电者读出记录或备注。

> **Warning**
>
> Zapier 将以连接工作区的 Attio 用户身份操作，并可查看该用户能查看的所有内容。
> 请使用访问权限仅限于接待员所需记录的成员账户进行连接，并保留此
> 规则，确保来电者绝不会听到其他人员的详细信息。

### 测试

使用已保存到 Attio 人员记录的号码来电，以及时以请求回电的新来电者身份[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新人员和一条备注将显示在 Attio 中。

### Zapier 操作

#### 查找来电者

| 字段               | 值                |
| ---------------- | ---------------- |
| **Zapier 操作**    | **查找记录**         |
| **在 Zapier 中设置** | 对象：人员。搜索属性：电话号码。 |
| **让 AI 填写**      | 要搜索的值：来电者的电话号码。  |
| **分配给**          | **Client**       |

#### 添加来电者

| 字段               | 值                        |
| ---------------- | ------------------------ |
| **Zapier 操作**    | **创建记录**                 |
| **在 Zapier 中设置** | 对象：人员。如果使用，任何应始终保持相同的属性。 |
| **让 AI 填写**      | 名字、姓氏、电话号码和邮箱地址。         |
| **分配给**          | **Client**               |

#### 记录备注

| 字段               | 值                                  |
| ---------------- | ---------------------------------- |
| **Zapier 操作**    | **创建备注**                           |
| **在 Zapier 中设置** | 父对象：人员。                            |
| **让 AI 填写**      | 父记录 ID（来自之前的操作）、标题，以及包含来电者诉求的备注文本。 |
| **分配给**          | **Client**                         |

> **Tip**
>
> 无论使用哪种方式，都请添加一条[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)，
> 确保接待员先搜索来电者，仅在未找到匹配项时创建人员记录，
> 然后再记录备注。

## 限制

* Attio 会检查电话号码是否有效。请在工具或操作描述中告知接待员，使用国际格式发送号码，例如 `+14155550123`。
* 若其他人员已拥有相同的唯一值（例如邮箱地址），创建人员记录将失败。接待员应先搜索。
* 通过 Zapier 创建的任务无法关联到 Attio 记录，因此请使用备注记录通话详情。
* 使用 Zapier 时，接待员执行的每项操作都会消耗 Zapier 套餐中的任务数。Zapier 目前每次成功通话计为 2 个任务；失败通话不计入。套餐额度用尽后，操作会停止，直到额度重置。

## 故障排除

| 问题                          | 检查项                                                           |
| --------------------------- | ------------------------------------------------------------- |
| Attio 返回 401 或 403          | 确保请求头值以 `Bearer ` 和一个空格开头，并检查令牌是否具有上述权限范围且未被删除。               |
| Attio 操作未显示在 Reception.ai 中 | 在 Zapier 中添加操作后，在 Zapier 集成中选择 **刷新工具**。                      |
| 操作显示为 **已更改** 且未被使用         | 你在 Zapier 中编辑了它。在 **工具** 标签页中选择 **更新**。                       |
| 未找到已知来电者                    | 检查号码是否带有国家/地区代码。使用 Zapier 时，检查 **查找记录** 是否按电话号码搜索人员对象。        |
| 创建人员记录失败                    | 电话号码可能不是国际格式，或者来电者的邮箱地址已被保存。                                  |
| 备注未关联到来电者                   | 接待员需要来自查找或创建工具的记录 ID，或来自 Zapier 中 **查找记录** 或 **创建记录** 的记录 ID。 |