好友操作

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

使用前提

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

接口范围

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

使用建议

好友关系属于微信实例的重要资产。业务系统应以 wcId、v1 等稳定标识作为关联依据，不要只依赖昵称、备注或手机号做身份判断。检测好友状态时，应把 0 视为正常关系，把 1、2、3 作为关系异常或拉黑状态处理，把 4、5、6、7、99 作为异常或未知状态处理。