wecom-customer

name	wecom-customer
description	当用户提到'客户'、'外部联系人'、'客户标签'、'跟进'、'销售'、'CRM'、'客户群'、'联系我'、'渠道活码'，或需要管理企业微信中的客户关系时使用此技能。查询客户详情、管理客户标签、跟踪跟进记录、管理客户群。
version	0.1.0
metadata	{"openclaw":{"emoji":"👥","requires":{"env":["WECOM_CORP_ID","WECOM_CUSTOMER_SECRET"],"bins":["curl","jq"]},"primaryEnv":"WECOM_CORP_ID"}}

企业微信客户联系技能

通过企业微信客户联系 API，管理外部客户关系——查询客户信息、打标签、管理客户群、创建联系我二维码。

前置条件

1. 使用"客户联系"应用的 Secret（非通用 Secret）
2. 应用需具有"企业客户权限 → 客户基础信息"权限
3. 成员需配置了客户联系功能

获取 Access Token

ACCESS_TOKEN=$(curl -s "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${WECOM_CORP_ID}&corpsecret=${WECOM_CUSTOMER_SECRET}" | jq -r '.access_token')

核心操作

1. 获取客户详情

curl -s -X GET "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get?access_token=${ACCESS_TOKEN}&external_userid=<external_userid>" | jq '.'

返回值关键字段：

• external_contact.name: 客户昵称
• external_contact.type: 1=微信用户, 2=企业微信用户
• external_contact.corp_name: 客户所在企业（仅企微用户）
• follow_user[]: 跟进人列表，每个包含 userid、tags、remark、add_way、oper_userid

2. 获取员工的客户列表

curl -s -X GET "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=${ACCESS_TOKEN}&userid=<员工userid>" | jq '.external_userid'

返回该员工所有客户的 external_userid 数组。

3. 批量获取客户详情

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/batch/get_by_user?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "userid_list": ["<员工userid1>", "<员工userid2>"],
    "cursor": "",
    "limit": 100
  }' | jq '.external_contact_list'

4. 修改客户备注/标签

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/remark?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "userid": "<员工userid>",
    "external_userid": "<external_userid>",
    "remark": "张总-预算3000",
    "description": "3月5日已发报价单，等待回复",
    "remark_company": "XX科技有限公司",
    "remark_mobiles": ["13800138000"]
  }'

5. 管理企业标签

创建标签组：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "group_name": "客户意向",
    "tag": [
      {"name": "高意向"},
      {"name": "中意向"},
      {"name": "低意向"}
    ]
  }'

给客户打标签：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "userid": "<员工userid>",
    "external_userid": "<external_userid>",
    "add_tag": ["<tag_id1>"],
    "remove_tag": []
  }'

6. 获取客户群列表

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/list?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "status_filter": 0,
    "owner_filter": {"userid_list": ["<群主userid>"]},
    "cursor": "",
    "limit": 100
  }' | jq '.group_chat_list'

7. 创建「联系我」二维码

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token=${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": 2,
    "scene": 2,
    "remark": "官网咨询入口",
    "skip_verify": true,
    "user": ["<接待员工userid>"],
    "state": "website_contact"
  }' | jq '.config_id, .qr_code'

state 字段用于区分客户来源渠道（最多 30 字符）。

销售跟进自动化工作流

1. 每日跟进提醒：遍历销售团队 userId → 获取每人客户列表 → 检查标签/备注中的"上次跟进时间" → 超过阈值的生成提醒
2. 跟进记录更新：销售说"记录：客户张总已发报价单" → 解析后调用 remark 更新备注 + mark_tag 更新标签
3. 周报生成：聚合所有销售的客户跟进数据 → 按标签分组统计 → 生成团队客户跟进周报

注意事项

• external_userid 不同调用方（企业/第三方）获取到的值不同，不可跨主体使用
• 客户联系 API 需使用客户联系专用 Secret，非通用应用 Secret
• 每个联系方式最多配置 100 个使用成员
• 从 2023 年 12 月起，不再支持通过系统应用 Secret 调用客户联系接口
• follow_user 只返回应用可见范围内的成员