Appearance
帮助中心
这里汇总最常见的接入、登录、消息和计费问题。开发联调建议先看 5 分钟上手，上线前再看 API 使用规范。
接入相关
如何获取 Authorization？
注册账号后登录 控制台，进入「我的 API → 开通信息」即可查看。Authorization 生成后长期有效，后续接口调用都需要在请求头中携带。
wId 和 wcId 有什么区别？
| 参数 | 说明 | 特点 |
|---|---|---|
wId | 登录实例标识 | 每次登录可能变化，调用业务接口时使用 |
wcId | 微信 ID | 同一个微信实例保持稳定，掉线重登必须传入 |
首次登录后掉线正常吗？
首次登录后 24 小时内可能掉线一次。掉线后请重新登录，并传入原 wcId，避免创建新的微信设备。
如何快速测试接口？
平台提供 在线测试功能。微信登录成功后，可直接在控制台发起请求测试。
快速排障
| 问题 | 先检查 | 再查看 |
|---|---|---|
| 登录失败 | wcId 是否沿用、Aid 是否保持运行、扫码地区是否匹配 | 获取登录二维码 |
| 发不出消息 | wId 是否在线、目标 wcId 是否正确、是否触发限速 | 发送错误码 |
| 收不到回调 | 回调地址是否公网可访问、是否 6 秒内响应 | 回调字段释义 |
| 频繁掉线 | 是否异地登录、是否未传原 wcId、是否高频调用敏感接口 | API 使用规范 |
消息相关
如何接收微信消息？
没有服务器怎么测试 Webhook？
如果只是想看 Eyun 推送内容，可以先用 Webhook.site 复制一个临时 URL 配置到 httpUrl。如果要调试本地代码，再按 Webhook 本地联调 生成临时公网地址，把本地 http://127.0.0.1:3000/webhook 暴露给 Eyun。联调通过后，再替换成正式业务服务器地址。
消息发送目标可以是群聊吗？
可以。发送接口的 wcId 参数支持个人微信 ID、filehelper 和群聊 ID。群聊 ID 通常以 @chatroom 结尾。
如何在群聊中 @某人？
使用 群聊 @成员，传入群 ID 和被 @ 成员的微信 ID。
发送失败怎么排查？
账号相关
一个开发者账号可以登录多个微信吗？
可以。支持同时管理多个微信实例，具体数量取决于购买套餐和部署方案。
微信掉线了怎么办？
TIP
建议在 Webhook 中监听离线通知，并在业务系统中触发告警或重连流程。
什么情况下需要 Aid 本地代理？
当需要使用本地网络环境登录，或平台线路与账号常用地区不匹配时，可以使用 Aid 本地代理。使用期间 Aid 工具必须保持运行。
计费相关
如何购买套餐？
前往 控制台 → 套餐购买 自助开通。
详细资费标准在哪里？
请参阅 资费说明 页面，或联系技术支持确认企业版、私有化部署方案。