好友操作

好友操作用于管理微信实例的联系人关系，包括搜索用户、添加好友、通过好友申请、修改备注、设置权限、删除好友以及同步通讯录。

使用前提

• 已完成微信实例登录，并拿到可用的 wId。
• 涉及添加好友、删除好友、权限设置等动作时，请按真实业务触发，不建议高频批量调用。
• 查询类接口可用于业务系统同步联系人状态，写操作接口建议记录请求日志，便于后续排查。

接口范围

场景	说明
好友查询	查询用户信息、手机号列表、通讯录等
好友添加	搜索用户、发起添加、通过好友申请
好友管理	修改备注、删除好友、置顶、免打扰、权限设置
资料维护	获取自己的二维码、设置头像、隐私配置

使用建议

好友关系属于微信实例的重要资产。业务系统应以 wcId、v1 等稳定标识作为关联依据，不要只依赖昵称、备注或手机号做身份判断。