QiWe开放平台 · 开发者名片
API驱动企微自动化，让开发更高效
核心能力：为开发者提供标准化接口、快速集成工具，助力产品高效拓展功能场景
团队定位：专注企微API生态的技术服务团队
对接通道：搜「QiWe 开放平台」联系客服
核心理念：合规赋能，让企微开发更简单、更高效
1. 内部成员管理（组织架构）
要实现主动推送，系统必须首先同步企业的内部通讯录，以确定哪些员工拥有推送权限。
-
获取部门列表：递归获取企业的部门树。
-
获取部门成员 ：通过
department_id获取成员的基础信息（UserID、姓名、激活状态）。 -
核心用途：
-
权限校验：判断员工是否在应用的可见范围内。
-
任务下发：根据部门（如：华东销售部）批量指派推送任务。
-
2. 外部联系人管理（客户资产）
这是主动推送中最活跃的部分。联系人模块需要通过 API 持续同步客户数据。
核心操作流程
-
获取客户列表 ：通过
userid拿到该员工名下的所有客户external_userid。 -
拉取客户详情 ：获取头像、昵称、企业备注 、客户标签。
-
变更监听：配置回调，实时处理"添加客户"、"删除客户"、"客户信息变更"事件。
3. 联系人模块的数据库设计建议
为了支撑高频的主动推送，你的本地用户模块建议包含以下核心字段：
| 字段名 | 说明 | 推送时的作用 |
|---|---|---|
external_userid |
客户唯一标识 | 必填参数，消息下发的终点。 |
userid |
归属成员 ID | 确定由哪个员工的身份发起推送。 |
tags |
客户标签列表 | 精准筛选，如只发给"已付费"标签的客户。 |
remark |
备注名 | 混合文本推送中用于个性化称呼（如：陈先生）。 |
status |
好友状态 | 过滤掉已删除/拉黑的客户，节省 API 额度。 |
4. 接入提醒：权限与安全
-
客户联系授权：确保在后台"客户联系"选项中，应用已获得操作权限。
-
离职继承逻辑：联系人模块必须包含"离职成员处理"。当员工离职时，需通过 API 将其名下的客户和外部群转移给在职成员，并更新本地数据库的关系映射，否则推送任务会因 UserID 失效而中断。
-
隐私脱敏：API 返回的客户头像和敏感信息应在本地进行加密存储或脱敏处理，符合合规要求。
总结
联系人模块是主动推送的**"底座"**。只有做好了内部成员与外部客户的实时同步，后续的"群发助手"或"自动建群"才能找到准确的目标。