跳到导航

Attio

在通话期间通过 Attio 识别来电者、添加新联系人并记录通话备注。

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

  • Webhook 工具 直接调用 Attio 的 API,无需 Zapier 账户,也不消耗 Zapier 任务数。
  • Zapier 操作会代你登录 Attio,但每项操作都会消耗 Zapier 套餐中的任务数。

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

选项 1:Webhook 工具(推荐)

1

创建访问令牌

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

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

2

创建 Webhook 工具

对于以下每个工具,依次进入 集成,选择 添加集成,然后选择 Webhook Tool。每个工具都发送相同的请求头:Authorization(Secret),设为 Bearer 后接令牌。

3

添加规则

添加一条规则,告知接待员只能使用 Attio 识别来电者,绝不能向来电者读出记录或备注。

查找来电者

字段值
名称find_attio_person
描述”按电话号码在 Attio 的人员中查找来电者。请在通话开始时使用。将该人员的 record_id 传给备注工具。“
方法POST
URLhttps://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
URLhttps://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
URLhttps://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 发送其他值,备注也始终会添加到人员记录中。

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

在每个工具上选择 启用,然后使用已保存到 Attio 人员记录的号码来电,以及时以请求回电的新来电者身份测试接待员。新人员和一条备注将显示在 Attio 中。

选项 2:Zapier

1

连接 Zapier

如果尚未连接,请在 Reception.ai 中连接 Zapier。

2

添加 Attio 操作

在 mcp.zapier.com 的 Zapier MCP 服务器中,从 Attio 应用添加以下操作,并连接 Attio 工作区。对于每个字段,请按列表所示设置固定值或让 AI 填写。

3

分配工具

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

4

添加规则

添加一条规则,告知接待员只能使用 Attio 识别来电者,绝不能向来电者读出记录或备注。

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

5

测试

使用已保存到 Attio 人员记录的号码来电,以及时以请求回电的新来电者身份测试接待员。新人员和一条备注将显示在 Attio 中。

Zapier 操作

查找来电者

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

添加来电者

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

记录备注

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

无论使用哪种方式,都请添加一条流程, 确保接待员先搜索来电者,仅在未找到匹配项时创建人员记录, 然后再记录备注。

限制

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

故障排除

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