| 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，管理外部客户关系——查询客户信息、打标签、管理客户群、创建联系我二维码。
前置条件
- 使用"客户联系"应用的 Secret（非通用 Secret）
- 应用需具有"企业客户权限 → 客户基础信息"权限
- 成员需配置了客户联系功能
获取 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 字符）。
销售跟进自动化工作流
- 每日跟进提醒：遍历销售团队 userId → 获取每人客户列表 → 检查标签/备注中的"上次跟进时间" → 超过阈值的生成提醒
- 跟进记录更新：销售说"记录：客户张总已发报价单" → 解析后调用
remark 更新备注 + mark_tag 更新标签
- 周报生成：聚合所有销售的客户跟进数据 → 按标签分组统计 → 生成团队客户跟进周报
注意事项
external_userid 不同调用方（企业/第三方）获取到的值不同，不可跨主体使用- 客户联系 API 需使用客户联系专用 Secret，非通用应用 Secret
- 每个联系方式最多配置 100 个使用成员
- 从 2023 年 12 月起，不再支持通过系统应用 Secret 调用客户联系接口
follow_user 只返回应用可见范围内的成员
