WTAPI开发文档
    • 平台简介
    • 快速入门
    • 接入开发规范
    • 消息订阅收发
    • 综合问题排查
    • 回调信息速览
    • 回调消息详解
    • 更新日志
    • API模块
      • 登录接口
        • ①获取登录二维码
        • ②执行登录
        • 弹窗登录
        • ③设置回调地址
        • 检查是否在线
        • 退出
        • 断线重连
      • 联系人接口
        • 获取通讯录列表
        • 获取通讯录列表缓存
        • 获取群/好友简要信息
        • 获取群/好友详细信息
        • 搜索好友
        • 添加联系人/同意添加好友
        • 删除好友
        • 设置好友仅聊天
        • 设置好友备注
        • 获取手机通讯录
        • 上传手机通讯录
        • 搜索企微
        • 添加企微好友
        • 同步企微好友
        • 获取企微好友详情
      • 消息接口
        • 下载
          • 下载文件
          • 下载图片
          • 下载语音
          • 下载视频
          • 下载emoji和表情包
        • 发送文字消息
        • 发送文件消息
        • 发送图片消息
        • 发送语音消息
        • 发送视频消息
        • 发送链接消息
        • 发送名片消息
        • 发送emoji消息
        • 发送appmsg消息
        • 发送小程序消息
        • 转发文件
        • 转发图片
        • 转发视频
        • 转发链接
        • 转发小程序
        • 撤回消息
      • 个人接口
        • 获取个人资料
        • 获取自己的二维码
        • 获取设备记录
        • 隐私设置
        • 修改个人信息
        • 修改头像
      • 标签接口
        • 添加标签
        • 删除标签
        • 标签列表
        • 修改好友标签
      • 群聊接口
        • 创建微信群
        • 修改群名称
        • 修改群备注
        • 修改我在群内的昵称
        • 邀请/添加 进群
        • 删除群成员
        • 退出群聊
        • 解散群聊
        • 获取群信息
        • 获取群成员列表
        • 获取群成员详情
        • 设置群公告
        • 获取群公告
        • 同意进群
        • 添加群成员为好友
        • 获取群二维码
        • 群保存到通讯录
        • 管理员操作
        • 聊天置顶
        • 设置消息免打扰
        • 扫码进群
        • 确认进群申请
      • 朋友圈接口
        • 自己的朋友圈列表
        • 联系人的朋友圈列表
        • 点赞/取消点赞
        • 删除自己朋友圈
        • 设置朋友圈可见范围
        • 是否允许陌生人查看朋友圈
        • 设置某条朋友圈为隐私/公开
        • 下载朋友圈视频
        • 发送文字朋友圈
        • 发送图片朋友圈
        • 发送视频朋友圈
        • 发送链接朋友圈
        • 上传朋友圈图片
        • 上传朋友圈视频
        • 转发朋友圈
        • 某条朋友圈详情
        • 评论/删除评论
      • 收藏夹接口
        • 同步收藏夹
        • 获取收藏夹内容
        • 删除收藏夹
      • 视频号接口
        • 获取我的视频号信息
        • 修改我的视频号信息
        • 用户主页
        • 关注
        • 评论
        • 浏览
        • 发布视频-新
        • 关注列表
        • 消息列表
        • 评论列表
        • 获取赞与收藏的视频列表
        • 搜索视频号
        • 创建视频号
        • 同步私信消息
        • 根据id点赞
        • 根据id点小红心
        • 发送视频号消息
        • 发送视频号朋友圈
        • 获取私信人信息
        • 发私信文本消息
        • 发私信图片消息
        • 扫码关注
        • 搜索并关注
        • 扫码浏览
        • 扫码评论
        • 扫码点赞
        • 扫码点小红心
        • 延迟点赞、小红心
        • 扫码登录视频号助手
        • 扫码获取视频详情
        • 我的视频号二维码
        • 上传CDN视频
        • 发布CDN视频

    接入开发规范

    📘 WTAPI 全场景运维与风控规范
    节点运维 · 消息管控 · 账号养防 · 解封指引
    🔌

    一、节点运维与设备风控#

    • 新账号首次登录的“24小时观察期” — 24小时内大概率触发安全防护掉线,属于正常风控观察周期,正确重连即可恢复。
    • 循环掉线故障排查 — 若登录过的设备中存在大量iPad/Mac虚拟设备记录,需携带上一轮appId重新扫码登录,覆盖原有记录,
      切勿直接新建设备登录。
    • 异地登录与设备互顶 — 优先切换归属地纯净代理IP;若60秒内依旧掉线,停止操作次日8点重试。节点在线期间禁止在真机登录同账号,勿手动退出手机端。
    • 沙盒观察期(1-2天) — 期间禁止高频群发、批量处理好友申请、大批量建群。平稳挂机后可达数月稳定在线。
    ✉️

    二、消息收发规范与云发单优化#

    基础频次:每分钟35-45条,切换对象间隔2-4秒,跨群间隔2-4秒随机停顿。采用单线程队列,
    严禁多线程并发。
    云发单高效方案(避免重复上传):
    方案A 素材群中转
    素材号发专属群,抓取XML后批量转发
    方案B 私号回调抓取
    备用个人号捕获XML后批量分发
    方案C CDN异步上传
    单账号上传获取XML,其余账号复用
    主从账号分工的思路:
    主账号集中处理素材上传和生成,子账号仅执行分发动作,分散单账号的操作压力,同时符合平台 “拟人化操作” 的风控要求,避免单账号高频操作触发限制。
    消息送达异常原因:
    频繁推送营销类、同质化内容,会触发平台降权机制,页面显示发送成功,但实际部分用户无法接收消息;小程序卡片单日存在发送上限,图片视频加载缓慢,一般源于外部服务器带宽资源不足。
    消息接收延迟与离线排查:
    Webhook接口阻塞:消息回调采用POST JSON请求格式,业务接口出现死锁、数据库查询耗时过长,会造成请求超时丢失消息,可借助接口工具自测响应效率。
    节点离线核验:调用文本消息发送、在线状态检测接口判断节点存活;API主动发出的消息,平台不会推送回调数据。
    👥

    三、社交加粉与社群管理红线#

    需适配环境接口
    添加好友、获取群二维码、新建群组需新账号稳定挂机数日后启用。
    • 好友操作:
      【被动同意】 ≤50人/日,超过容易封号,还会造成数据丢包,无法正常接收验证信息;
      【主动添加】 5-10人/24h(每2h≤5人),操作间隙拉长随机间隔,避免出现申请发送成功、对方无法收到的情况,新设备满3天使用;
      【账号搜索】 10-20次/日。
    • 群聊管理:
      接口仅读取已存通讯录的群组,未保存的群需等待群内产生消息触发回调缓存后,才可查询群组详情。;
      【建群拉群】 ≤10个/日,间隔≥10分钟;群二维码需设备稳定在线≥3天。
      【账号信息】:受平台规则约束,无法通过群接口读取非好友账号原始微信号。
    🖼️

    四、朋友圈发布与媒体文件下载#

    朋友圈风控:新节点满2天才能发圈;浏览动态间隔≥10秒(≤100次/日),点赞评论间隔5~10秒(≤200条/日)。避免高频发布含营销词的内容,否则触发“仅本人可见”,可使用谐音、特殊符号替换敏感内容规避拦截。
    多媒体安全下载:禁止收到回调后立刻下载,应搭建专属下载队列,任务间延时3~10秒。文件推送有两次回调,
    过滤首次提示,依据二次回调执行下载。
    📱

    五、账号注册与养号防封(0-15天)#

    卡号选型:避免170/171/165虚拟号段;谨慎购买网络流通号码(多为回收号)。
    设备与环境:一机一号,仅用官方最新版客户端,注册必须用4G/5G流量。单设备单日≤2账号,单IP单日≤5账号,禁止同一IP/地理位置批量注册。
    0-15天高危养号准则(模拟真人):
    • ✅ 完善资料(头像/昵称/签名/实名绑卡),添加3~5个优质老号好友
    • ✅ 日常浏览、聊天、使用表情包,参与公益捐赠或小额理财
    • ✅ 朋友圈发布间隔≥1小时,单日≤5条;禁用摇一摇、附近的人
    • ✅ 固定设备登录,杜绝外挂、多开、一键转发
    • ❌ 前15天绝对禁止:随意换设备、使用引流功能、批量加好友/群发、频繁切换账号
    🚫

    六、核心风控规则与禁止行为#

    💀 高危操作(极易永久封号)
    • 24小时发红包≥100次限制功能,≥200次永久封禁
    • 设备共存抢红包插件、虚拟定位等外挂
    • 注册未满两个月即批量拉群、群发
    ⚠️ 异常行为(易限制社交权限)
    • 机械无间隔发信(每分钟≥15人)→ 增加3~5秒随机停顿
    • 单日添加陌生人超过10人(超出建议范围),同一用户重复申请≥2次
    • 高频重复群发 → 拆分批次,每半小时≤50人
    底层说明:虚拟机、模拟器、分身、魔改系统均无法规避风控。合规使用是唯一长期策略。
    🧩

    七、分身账号使用准则(如有)#

    • ❌ 禁止在分身软件内注册新号(需先在官方客户端养号≥15天)
    • ❌ 禁止在分身内频繁切换登录、进行违规操作
    • ✅ 必备安全操作:扩充真实好友、实名认证、账户小额充值、日常真实交易、搭配移动网络使用
    🚑

    八、账号辅助解封标准流程#

    协助解封硬性条件:账号绑定手机+银行卡,注册≥6个月,近一月未协助他人解封,近一年无封禁记录。
    操作步骤:被封账号进入官方解封页面 → 填写协助好友手机号 → 好友关注【微信团队】公众号 → 自助工具 → 辅助验证 → 完成身份校验。
    📋

    附:常见封号诱因自查清单#

    • 使用非官方客户端
    • 频繁异地登录、虚拟定位
    • 短时间大批量加好友/群发
    • 使用摇一摇/附近的人引流
    • 被投诉举报
    • 账号长期闲置
    • 频繁切换账号、大额转账
    • 聊天含违规敏感词
    • 参与集赞、诱导分享
    • 设备安装外挂、多开
    • 账号历史有封禁记录
    • 新账号未养号直接上线
    • 购入二手/工具生成账号
    • 与异地低频账户频繁红包
    • 设备长期通电待机
    • 设备定位长期固定不变
    修改于 2026-06-09 06:32:29
    上一页
    快速入门
    下一页
    消息订阅收发
    Built with