跳到导航

Copper

通话期间在 Copper 中查找来电者、添加潜在客户,并记录备注和跟进任务。

接待员可以识别已存在于 Copper 中的来电者,将新来电者添加为潜在客户,记录每位来电者的需求,并为团队创建后续任务。查找来电者和创建任务使用 Webhook 工具。添加潜在客户和备注有两种连接方式:

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

除非更希望在 Zapier 中设置潜在客户和备注操作,否则请使用 Webhook 工具。

开始前

1

生成 API 密钥

在 Copper 中,打开 系统设置 → API 密钥,然后选择 生成 API 密钥。为其添加标签,例如 Reception.ai。该密钥代表你的身份,因此可以查看和修改你有权限访问的内容。

以下每个 Webhook 工具都会发送这些请求标头:

标头类型值
X-PW-AccessToken密钥API 密钥
X-PW-Application值developer_api
X-PW-UserEmail值创建密钥用户的邮箱地址

任何拥有 API 密钥和邮箱地址的人都可以读取和修改 Copper 数据。请勿将密钥 放在共享文档中;如果泄露,请在 Copper 中删除它。

2

查找新潜在客户和任务对应的用户 ID

新潜在客户和任务可以分配给一个固定用户。在终端中运行以下命令,替换 YOUR_API_KEY 和 YOUR_EMAIL,并记下处理回电的用户的 id:

curl -X POST https://api.copper.com/developer_api/v1/users/search \
-H "X-PW-AccessToken: YOUR_API_KEY" \
-H "X-PW-Application: developer_api" \
-H "X-PW-UserEmail: YOUR_EMAIL" \
-H "Content-Type: application/json" \
-d '{}'

创建 Webhook 工具

对于每个工具,前往 集成,选择 添加集成,选择 Webhook 工具,然后将 分配给智能体 设为 接待员。Copper 的搜索端点使用 POST,搜索条件放在请求正文中。

查找联系人

字段值
名称find_copper_person
说明”按电话号码在联系人中查找来电者。请在通话开始时使用,以确认对方是否为客户。将此人的 id 传给其他工具。“
方法POST
URLhttps://api.copper.com/developer_api/v1/people/search
请求标头开始前 中的标头
正文参数phone_number(字符串,必填):“来电者的电话号码。“

查找潜在客户

字段值
名称find_copper_lead
说明”按电话号码在潜在客户中查找来电者。当来电者不是联系人时使用。将潜在客户的 id 传给其他工具。“
方法POST
URLhttps://api.copper.com/developer_api/v1/leads/search
请求标头开始前 中的标头
正文参数phone_number(字符串,必填):“来电者的电话号码。“

创建后续任务

字段值
名称create_copper_task
说明”每当你承诺回电给来电者时,为团队创建任务。将其关联到找到或创建的联系人或潜在客户。“
方法POST
URLhttps://api.copper.com/developer_api/v1/tasks
请求标头开始前 中的标头
正文参数name(字符串,必填):“例如:就厨房报价回电给 Jane Doe。”
details(字符串,必填):“来电者的姓名、电话号码及需求。”
related_resource(对象),包含以下字段
assignee_id(整数,固定值):如需将任务分配给同一人,填写记下的用户 ID

在 related_resource 中,针对以下每项选择 添加字段:

  • id(整数,必填,来自对话):“通过查找工具或 create_copper_lead 获取的联系人或潜在客户 id。”
  • type(字符串,必填,来自对话):“如果 id 来自 find_copper_person,则为 person;如果来自 find_copper_lead 或 create_copper_lead,则为 lead。”

不要将 related_resource 设为 必填,这样接待员仍可为不在 Copper 中的来电者创建任务。

在每个工具中选择 启用。

查找工具会返回匹配联系人或潜在客户中保存的所有内容。添加一条 规则,要求接待员仅使用这些工具 识别来电者,绝不向对方复述记录内容。

选项 1:Webhook 工具(推荐)

使用另外两个 Webhook 工具添加潜在客户和备注,创建方式与上述工具相同。

将来电者添加为潜在客户

字段值
名称create_copper_lead
说明”仅当 find_copper_person 和 find_copper_lead 都未找到来电者时,才将其添加为潜在客户。将新潜在客户的 id 传给其他工具。“
方法POST
URLhttps://api.copper.com/developer_api/v1/leads
请求标头开始前 中的标头
正文参数见下文
  • name(字符串,必填,来自对话):“来电者的名字和姓氏。”
  • phone_numbers(数组,必填,来自对话):“仅包含 1 项,即来电者的电话号码。“在 每个项目 下,选择 object 并添加两个字段:
    • number(字符串,必填,来自对话):“来电者的电话号码。”
    • category(字符串,固定值):mobile
  • email(对象,来自对话),包含两个字段。不要将其设为 必填,这样只有来电者提供邮箱地址时才会发送:
    • email(字符串,必填,来自对话):“来电者的邮箱地址。”
    • category(字符串,固定值):work
  • details(字符串,来自对话):“用几句话说明来电者的需求。”
  • assignee_id(整数,固定值):如需将新潜在客户分配给同一人,填写记下的用户 ID

记录备注

字段值
名称add_copper_note
说明”在通话结束前,在来电者的联系人或潜在客户记录中注明其需求。“
方法POST
URLhttps://api.copper.com/developer_api/v1/activities
请求标头开始前 中的标头
正文参数见下文
  • parent(对象,必填),包含两个字段:
    • id(整数,必填,来自对话):“通过查找工具或 create_copper_lead 获取的联系人或潜在客户 id。”
    • type(字符串,必填,来自对话):“如果 id 来自 find_copper_person,则为 person;如果来自 find_copper_lead 或 create_copper_lead,则为 lead。”
  • type(对象,必填),包含两个将活动设为备注的字段:
    • category(字符串,固定值):user
    • id(整数,固定值):0
  • details(字符串,必填,来自对话):“用几句话说明来电者的需求。”

类别、备注类型和负责人均为固定值,因此即使 AI 发送其他值,它们也会保持不变。

在每个工具中选择 启用,然后通过已保存为 Copper 联系人的号码来电进行测试接待员,再使用请求回电的新号码测试。新来电者会显示为带有备注的潜在客户,任务也会显示在 Copper 中并关联到该潜在客户。

选项 2:Zapier

改用 Zapier 操作添加潜在客户和备注。

1

连接 Zapier

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

2

添加 Copper 操作

在 mcp.zapier.com 的 Zapier MCP 服务器中,连接 Copper 账户并添加以下操作:

  • 创建潜在客户:将负责人和潜在客户来源设为固定值,让 AI 填写来电者姓名、电话号码、邮箱地址和需求。
  • 创建活动:将活动类型设为备注,让 AI 填写搜索工具找到的联系人或潜在客户,以及来电者的需求。
3

分配工具

在 Reception.ai 中,打开 Zapier 集成的 工具 标签页,选择 刷新工具,并将两个 Copper 操作都分配给 客户(接待员)。

4

测试

通过已保存为 Copper 联系人的号码来电进行测试接待员,再使用请求回电的新号码测试。新来电者会显示为潜在客户,任务也会显示在 Copper 中。

添加一个流程,让接待员 先搜索联系人和潜在客户,仅当两次搜索都找不到来电者时才创建潜在客户。

限制

  • Copper 使用 Unix 时间戳表示截止日期,AI 无法可靠地计算,因此 create_copper_task 会将截止日期留空。
  • 如需设置截止日期,请通过 Zapier 使用 Copper 的 创建任务 操作,而不是 Webhook 工具。
  • 使用 Zapier 时,接待员运行的每项操作都会消耗 Zapier 套餐中的任务数。套餐额度用完后,操作会停止,直到额度重置。

故障排除

问题检查项
Copper 返回 401 或 403检查全部 3 个标头。X-PW-UserEmail 必须是生成密钥用户的邮箱。
找不到已知来电者Copper 按存储的电话号码匹配。请统一号码格式,并确认来电者是联系人或潜在客户,而不是公司。
接待员创建了重复的潜在客户在搜索工具说明中告知它,仅当未找到来电者时才创建潜在客户。
备注或任务未关联到来电者接待员需要从查找工具或 create_copper_lead 获取 id,且 type 必须为 person 或 lead,以匹配其来源。
关联潜在客户的任务失败Copper 文档仅列出了部分可用于任务关联的记录类型。对于潜在客户,请将 related_resource 留空,或改为将任务关联到联系人。
未显示 Copper 操作在 Zapier 中添加操作后,在 Zapier 集成中选择 刷新工具。
操作显示 已更改 且未被使用你在 Zapier 中编辑了该操作。请在 工具 标签页中选择 更新。