新注册账号、未实名账号、曾有被封记录的账号属于低 质量账号，极易触发腾讯底层风控。请务必确保接入账号已完成实名认证，且在正常物理设备上有过一段时期的真实活跃使用，方可接入本平台！
🔌 一、 节点掉线排查与设备风控机制#
新用户首次登录 WechatApi 节点，在首个 24 小时内有极大概率触发安全保护导致掉线。这是正常的风控沙盒期，请务必掌握正确的重连与排查姿势：1. 致命错误：陷入“循环掉线”#
排查方法：打开手机微信 -> 【我】->【设置】->【账号与安全】->【登录过的设备】。如果您看到列表里存在大量以iPad/Mac开头的设备，说明您已陷入循环掉线。
正确重连方案：在首次掉线后，必须传递上一次登录的 appId 调用【获取二维码接口】重新扫码。这样能确保覆盖登录上一个虚拟设备，否则生成新设备必定封号。
2. 异地风控与设备互顶#
异地登录：若微信登录地为异省，极易被强制下线。解决方法是使用本省代理 IP 登录。若使用代理后依然在 60 秒内掉线，说明账号已进入“新设备严格风控状态”，请停止尝试，次日早上 8 点后再次尝试正常登录。
设备冲突：微信节点登录期间，严禁在实体 iPad/Mac 真机上登录该账号、严禁手机端主动点击“退出微信”、严禁随意更换主设备手机，这些操作均会导致节点立刻掉线。
3. 沙盒期静默#
新登录的账号在 1~2 天内处于非安全环境的观察期。此阶段绝对禁止频繁群发同质化内容、批量添加/同意好友、批量创建群聊。静默挂机度过观察期后，即可实现长达数月的稳定在线。
✉️ 二、 消息收发规范与“云发单”高并发提速#
1. 基础发送频率与防屏蔽#
频率建议：控制在 35-45 条/分钟。切换不同用户发送时建议间隔 2-4 秒；连续向不同群聊发送时，必须加入 2-4 秒的随机延迟。所有消息必须走单线程的队列消费模式。
降权屏蔽：发送过多营销类、同质化内容，会触发腾讯内部规则，导致消息有效到达率被降权（你看着发成功了，但部分群员手机上根本没收到）。
资源限额：小程序卡片每日有发送条数上限；图片/视频发送慢通常是因为资源所在的外部服务器下行带宽不足。
2. 🚀 高阶场景：群发/云发单的“几十倍提速”三大绝招#
如果在做社群机器人，需要给 1000 个微信号群发同样的图片/视频，严禁直接循环调用【发送图片接口】（会导致 1000 次重复的下载和上传，瞬间耗尽服务器网速）。请使用以下三种零上传、极速转发方案：方案 A（素材群中转法）：配置一个“素材机器人”和一个“接收机器人”建一个空群。素材机器号向群内发送文件，接收机器号通过消息回调拿到该文件的 XML 结构。其余所有发单机器人，直接拿这段 XML 调用【转发接口】进行极速分发。
方案 B（私人号回调法）：先把文件发给一个指定的备用私人微信号，通过回调捕获该文件消息的 XML，随后使用【转发接口】群发。
方案 C（异步 CDN 上传法）：随便挑一个微信号，单次调用【CDN 图片/视频上传接口】拿到返回的秘钥 XML。其他所有微信无需上传，直接动态组装该 XML 调用【转发接口】即可发送。
3. 消息接收不到/延迟排查#
Webhook 阻塞：微信消息回调是 POST JSON 请求。如果您的业务接口出现了多线程死锁、同步查库导致耗时过长，网关会判定超时不发。请使用 Postman 自测接口响应速度。
被踢掉线：调用【发送文本消息】或【检查是否在线】接口测试节点是否存活。（注意：通过 API 接口主动发出去的消息，平台不会下发回调）。
👥 三、 社交加粉与社群管理红线#
⚠️ 敏感操作声明： 添加/同意好友、获取群二维码、建群均为高危敏感接口，新用户需在线挂机数天后方可调用！
1. 联系人操作极值限制#
被动同意好友：日上限建议 ≤ 50 人。过多扫码添加有封号风险，且瞬间涌入大量请求会导致微信底层丢包，您将收不到对方的验证消息。
主动添加好友：24 小时内总计只能加 5-10 人。每 2 小时内严禁超过 5 人。每次添加必须加入长随机间隔，否则即使接口返回成功，对方手机也收不到申请。(新登录节点需在线 3 天后方可调用此接口)。
搜索好友：每日 10-20 次，且每次搜索必须设置间隔。
2. 群聊管理规范#
历史群获取为空：接口仅获取通讯录内保存的群。对于未保存的群，只有当群内有人发消息触发回调时，系统才会更新 UI 并将其写入缓存，此时您再调用获取群详情接口即可拿到。
创建群聊：日上限 10 个，两次建群动作间隔必须在 10 分钟以上。
获取群二维码：新登录节点需在线 3 天后方可调用，否则扫码会提示已过期。
非好友微信号：受微信新规限制，群内接口无法查看非好友的明文微信号。
⭕ 四、 朋友圈与媒体下载排雷指南#
1. 朋友圈风控规则#
接口权限：新登录节点需在线 2 天后方可正常发送朋友圈。
频率限制：获取动态建议最低间隔 10 秒/次（日限 100 次）；点赞评论建议随机间隔 5-10 秒/次（日限 200 条）。
被“幽灵屏蔽”（仅自己可见）：若朋友圈发得太频繁，或包含淘客行业、营销等被腾讯拦截的敏感关键字/违规图片，会被选择性推送（别人看不到）。需开发者自行使用谐音字、特殊符号替换规避。
2. 媒体文件安全下载机制#
核心禁忌：绝对不要一收到回调就触发下载逻辑！ 频繁瞬间下载语音、图片、视频极易导致请求失败甚至被踢下线。
队列与僵尸号：必须建立下载队列，任务之间设定 3-10 秒的随机延时，且每条资源只下载一次。若业务确实需要海量下载，建议准备专门的“僵尸微信号”，将资源转发给它们后，由它们承担下载任务，保护主业务号的安全。
文件下载失败排查：收到文件通常会触发两条回调，开发者必须过滤掉第一条提示音，**拦截第二条（包含完整文件大小等信息）**的回调才能成功下载。
🏷️ 附：通讯录 wxid 标识说明#
在调用通讯录接口时，开发者常对“微信原始 ID”产生疑惑：内部规则：若接口返回的 alisname 为空，说明该微信用户从未在手机端设置过自定义微信号。此时，他对外暴露的唯一标识就是 wxid_ 开头的原始字符串。这是正常的微信底层数据结构，请直接将 wxid 作为该用户的唯一主键进行业务处理。
