一、身份信息——这个号是谁身份信息是最基础的查询微信号wxid、昵称、头像。这三个字段标识了这个号是谁。身份信息的典型用途多实例管理时区分哪个号是哪个号用昵称和头像辨识生成电子名片展示给客户同步到网站客服系统展示当前接待人信息。身份信息变化频率极低查一次缓存即可。二、状态信息——这个号在不在状态信息回答在线吗实例在线状态、Token 是否有效、最近心跳时间。这组信息不是一次查出来的而是通过状态接口 Token 鉴权结果 心跳记录综合判断。状态信息是生产环境的基础——程序启动时查一次确认在线运行中靠回调持续感知。具体实现536篇讲过这里不重复。三、关系信息——这个号有哪些好友和群关系信息通过联系人接口和群接口查询好友列表数量、每人的wxid和备注、群列表数量、每群的ID和名称。这组信息是这个号连接了谁。关系信息数据量大全量拉取后落库做本地管理。关系信息变化频率中等好友增减、群变动靠事件回调做增量。四、内容信息——这个号有什么素材内容信息是这个号产生和收到了什么聊天记录通过消息记录接口拉取、收到的图片和文件通过消息回调里的素材引用下载、朋友圈动态如果接口支持。内容信息是业务价值最高的信息层——聊天记录可以分析客户需求收到的文件可以进业务系统。但也是处理最复杂的涉及下载、解析、存储。四层信息对照信息层查什么数据量变化频率业务价值身份信息昵称、头像、微信号小极低标识区分状态信息在线、Token、心跳小高生产基础关系信息好友列表、群列表大中运营基础内容信息聊天记录、素材、动态最大高业务价值四层信息查询示例def inspect_account(wid): 完整检查一个微信号的所有可查信息 report {wId: wid} # 第一层身份 ident api(getSelfInfo, {wId: wid}) report[identity] { nickname: ident[data][nickname], wxid: ident[data][wxid], avatar: ident[data][avatar] } # 第二层状态 status api(getInstanceStatus, {wId: wid}) report[status] online if status[code] 1000 else offline # 第三层关系 contacts api(getContactList, {wId: wid, page: 1}) groups api(getGroupList, {wId: wid, page: 1}) report[relations] { contact_count: contacts[data][total], group_count: groups[data][total] } # 第四层内容摘要 report[content] { today_messages: db.count(messages, wIdwid, datetoday()), media_files: db.count(media, wIdwid) } return report落地建议四层信息从浅到深查询难度和价值递增。身份和状态先做5分钟搞定关系信息做全量同步有数据基础内容信息按需做聊天记录和素材处理最复杂但价值最高。建议做一个 inspect 函数把四层信息一次查出来生成报告方便日常运维巡检。接口参数和字段说明参考 Eyun 开发文档平台开通见 Eyun 官网。