blueif16/cn-skills/wecom-customer

Claude Code and agent skill by blueif16/cn-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

当用户提到'客户'、'外部联系人'、'客户标签'、'跟进'、'销售'、'CRM'、'客户群'、'联系我'、'渠道活码'，或需要管理企业微信中的客户关系时使用此技能。查询客户详情、管理客户标签、跟踪跟进记录、管理客户群。

Install

npx vskill@latest install blueif16/cn-skills/wecom-customer

SKILL.md

企业微信客户联系技能

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

前置条件

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

获取 Access Token

bash
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. 获取客户详情
bash
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. 获取员工的客户列表
bash
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. 批量获取客户详情
bash
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. 修改客户备注/标签
bash
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. 管理企业标签

创建标签组：

bash
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": "低意向"}
    ]
  }'

给客户打标签：

bash
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. 获取客户群列表
bash
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. 创建「联系我」二维码
bash
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 只返回应用可见范围内的成员

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/blueif16/cn-skills/wecom-customer/badge)](https://verified-skill.com/skills/blueif16/cn-skills/wecom-customer)

Something wrong with this skill or its page? Tell us.