核心标识符

标识符	表示什么	生命周期	常见用途
wId	当前登录实例	每次登录可能变化	调用消息、联系人、群聊等业务接口
wcId	微信账号或接收目标	同一微信账号相对稳定	掉线重登、发送目标、联系人和群聊
aid	Aid 本地代理编号	对应一台本地节点	登录时选择本地网络出口
messageType	Webhook 事件类型	随每条事件产生	分发不同消息和通知
newMsgId	微信消息唯一标识之一	对应一条消息	Webhook 幂等和消息追踪

最容易混淆的规则

• 业务接口通常使用当前有效的 wId。
• 掉线后重新登录必须传原 wcId，避免创建新的设备记录。
• 群聊 ID 通常以 @chatroom 结尾。
• filehelper 是文件传输助手，适合首次发送验证。
• Webhook 可能重复投递，业务系统应按 newMsgId 或业务唯一键排重。