Youzan Wecom

---
name: youzan-wecom
version: 1.1.37
description: "企助员工、部门、接待统计、企微群、活码、客户关系、社群统计和朋友圈任务结果的原始数据查询与导出；不提供朋友圈任务、活码或其他企微对象的远端数据变更能力，不做导购任务分析、员工绩效结论、客户画像或推荐。"
---

# 企微与社群

使用本 skill 前，确认当前授权范围和店铺上下文。明确限定为导购任务体系的朋友圈数据使用 `youzan-guide`，素材信息使用 `youzan-material`。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 查询企助员工列表、部门详情和直接子部门。
- 查询员工接待统计，包括单聊聊天数、发送消息数、同日回复占比和平均首次回复时长。
- 查询企微朋友圈任务列表及单条任务的员工发送明细，读取任务状态、发送范围、失败原因、页面浏览量、独立访客数和互动指标。
- 查询企微群分组、群聊和指定群成员，支持成员状态以及加群、退群时间筛选。
- 查询个人活码、去重活码及其分组信息。
- 查询去重活码扫码客户明细。
- 按客户、员工、部门、标签、群聊、渠道和状态搜索或导出客户关系。
- 查询企微群和社群的群维度、日期维度、员工维度统计，并导出已支持的原始明细。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单条朋友圈任务明细时必须提供朋友圈任务标识。
- 查询部门子部门时必须提供父部门标识；查询单个部门时必须提供部门标识或名称关键词。
- 查询指定群成员时必须提供群标识。
- 查询去重活码扫码客户时必须提供去重活码标识和扫码日期；需要进一步缩小范围时可补充其他筛选条件。
- 查询指定员工接待统计时必须提供员工标识、开始日期和结束日期。
- 查询群统计时必须提供开始日期和结束日期；员工维度统计还必须提供员工标识或部门标识。

### 非必填信息

- 员工、部门、群聊、活码和客户关系列表的关键词、状态、部门、标签、渠道和时间条件可选；分页参数必须按“查询数量限制”传入。
- 群成员查询可补充在群状态、加群时间和退群时间。
- 朋友圈任务列表的任务名称和状态条件可选；分页参数必须按“查询数量限制”传入。
- 导出任务可补充输出格式、文件路径和筛选条件。

## 使用案例

- 用户说“查某部门的直接子部门”时，必须提供父部门标识；查询部门名称时先用部门搜索确认唯一部门。
- 用户说“查某员工近 7 天的接待统计”时，补齐员工标识、开始日期和结束日期，不把员工姓名直接当作员工标识。
- 用户说“查某企微群成员”时，必须提供群标识；“查群统计”则使用统计能力并补齐时间范围。
- 用户说“发送朋友圈、创建活码、调整群成员或修改客户关系”时，说明本 skill 只支持读取和导出。

## 边界

- 企微朋友圈任务创建、发送、编辑、员工范围调整、活码维护和其他远端数据变更不在本入口范围内。
- 导购朋友圈任务定义、导购执行、客户维护效果、订单归因和互动聚合使用 `youzan-guide`。
- 员工绩效、考勤和客户关系画像不在本入口范围内。
- 群统计中的成交或支付字段只作为原始数据返回，不直接生成经营结论。