Skip to content

账户管理 ​

账户管理接口用于查看和维护微信实例的在线状态,包括查询在线微信列表、查询实例登录状态、断线重连和批量下线。

使用前提 ​

  • 已完成微信实例接入,并保存 wId 与业务账号的绑定关系。
  • 断线重连前先查询在线状态,避免重复触发无效操作。
  • 批量下线属于影响面较大的操作,应由后台管理端或运维流程触发。

接口范围 ​

场景说明
状态查询查询在线微信列表、查询实例登录状态
状态恢复断线重连:平台离线、手机仍在线时恢复连接
状态下线批量下线

使用建议 ​

业务系统应把在线状态作为可变状态处理,不建议长期缓存。关键发送任务执行前,先确认微信实例处于在线状态。

如果手机端微信在线但平台显示离线,可以先调用 断线重连微信实例 尝试恢复;如果仍未恢复,再带原 wcId 重新扫码登录。