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

接入排查参考

说明: 新注册账号/未实名账号/被封过的账号属于低质量账号,请勿在本平台使用!先确保账号已实名且正常使用方可接入平台

一、掉线问题排查#

目前新用户登录API平台,24小时内首夜会100%掉线,掉线后传appId调用获取二维码接口再次扫码登录即可实现3月内不掉线,目前已知会导致微信掉线的情况有:
可能性1: 微信登录地点是异省,则必然出现秒掉,且每次登陆都会掉线(需使用本省代理),若使用本省代理方式登录,且登录也出现60秒内掉线,且传appId再次取码登录依然秒掉,则进入新设备风控,第二天8点后必然可以正常登录使用。
可能性2: 微信登录IPad真机或者手机退出微信或者换了手机登录微信,导致挤掉线
可能性3: 登录本平台未满2天的微信属于非安全环境,非安全环境下禁止频繁触发敏感行为(群发同质化内容、添加好友,自动同意好友、创建群聊,入群)等,容易触发各类异常风控,建议在线1~2天后在做频繁操作。
可能性4: 首夜掉线后一定记得传appId获取二维码扫码登录,这样才会登录上次登录的设备,否则就会循环陷入掉线的情况(严重者则封号),判断是否陷入循环掉线,可在手机微信 设置-账号与安全-登录过的设备 查看,如果存在多个ipad开头的即代表是错误的

二、消息发送规范#

核心: 尽量像人为在操作。
1.
消息发送频率建议
1min建议40条左右,每个不同用户切换间隔1S,不同群发送间隔随机2-5S,消息需走队列形式。
2.
为什么消息发送失败
可能性1: 小程序消息每日会有条数限制(WeChat规范限制)
可能性2: 发送对象不存在/群被踢出/好友被删除等
可能性3: 消息发送过快导致,手机会显示发送频率过快请稍后重试
可能性4: 消息发送不能存在并发,必须走消息队列消费发送(一个调用发送成功后,在调用下一个事件消费)
3.
为什么群消息有的人看不见
在腾讯内部规则中,发送同质化内容过多,或者疑似营销内容以及发送量快会导致此问题,会降权此条消息内容有效到达数,随机性推送可看到的用户,可用手机测试
4.
为什么图片/视频/文件消息发送慢
图片/视频/文件的服务器的速度会导致此问题,发送图片/视频/文件接口的原理是我们将资源的url下载我们服务器中然后在转换成认可的资源发送,可以多通过网络图片测试对比是否是是图片服务器慢的问题。
5.
很多个微信发送同样内容或单个微信同样内容发送给很多好友的优化方式?
说明: 本场景多适用于云发单及社群机器人,如若1000个微信需要发单,不要直接调用发送图片/视频/文件接口(直接发送会每张微信都上传图片/视频/文件,重复消耗流量,占用网速),如下所示,有以下3种解决优化方案:
第一种方案: 找2个机器人创建个素材群(素材机器人+素材接收机器人),把图片/视频/文件让素材机器人发送接口发到素材群,素材接收机器人会收到图片/视频/文件的XML,后续直接让发单机器人根据xml调用转发图片/视频消息接口即可(转发接口无上传操作,效率提升几十倍),不限制发单机器人是否在群内,有xml就可以发。
第二种方案: 先把文件/图片/视频发送至额外的机器人,通过消息回调获取文件消息的 xml 后,使用转发文件/图片/视频接口发送(转发接口无上传操作,效率提升几十倍)
第三种方案: 发送相同的图片的话,随便找1个微信直接调用CDN图片/视频上传接口,拿到返回秘钥,其他微信就不调用上传接口,而是直接调用转发接口(上传图片的微信和直接使用转发接口的微信可以毫无关系)动态组装下转发接口xml就可发送(转发接口无上传操作,效率提升几十倍)

三、消息接收问题排查#

1.消息接收慢
可能性一: 用户接口的死锁,堵塞,多线程处理错乱,接口业务处理消息时间过长会导致此问题,具体开发者可以自行使用postman测试下自己接口或者登录后台系统查看回调是否正常
可能性二: 在腾讯内部规则中,发送同质化内容过多,群过多,群消息过多,或者疑似营销内容以及发送量快会导致此问题,会降权此条消息内容有效到达数,随机性推送可看到的用户,可用手机测试是否正常。或者以多个机器人微信作为协助。
2.消息接收不到
排查一: 首先开发者需确认提供的服务器接口是可以通的,微信的消息回调会以post请求 json参数的格式请求开发者服务器接口。开发者也可以使用postman测试下自己接口是否正常
排查二: 开发者需确认微信没被踢掉线,确认是否在线是 以调用发送文本消息接口或者查询微信是否在线接口成功为准,注意:通过接口发送的消息不会有回调

四、好友相关问题#

1.添加好友接口调用规则
24 小时只能加 5-15 位好友,每 2 小时不要超过 8 人,每个好友添加间隔要做随机间隔,否则添加了对方,显示发送验证成功,对方也收不到你的验证信息。(新登录平台的微信需在线3天调用本接口)
2.同意好友接口调用规则
根据微信号权重,微信每天被动通过好友数不要超过 200 人,过多扫二维码添加也有封 号风险,并且一天太多人添加,你的微信将收不到别人的验证消息。
3.搜索好友调用规则
搜索好友数量每日大概在10-20之间,具体可手机,调用需做好间隔。

五、群相关问题#

1.如何获取群内非好友的微信号
微信新规,无法查看微信号
2.为什么接口返回的群少了或者没有
接口一次性是获取不是全部的群,仅会获取保存到通讯录的群,当有未获取的群有人在群内发消息的话会有消息回调, 开发者此刻调用获取群详情接口 再保存到自己数据库中就取到了,比如说手机上三年前不说话的群,侧滑删除了,然后你换了手机也不会取到的 ,有人说了话他才会置顶,原理就是各个终端(Android、IOS、桌面版微信)取得了消息回调,又去获取群了详情 本地数据库缓存了下来 更新的ui,让用户感知的。
3.创建群聊规范
每天只能添加10个群,频率间隔在10分钟以上。如果建群数量超出, 或者频率过快,就会返回失败,具体可根据微信号适当增减。
4.获取群二维码接口扫描显示已过期
新登录API平台的微信用户需在线3天后调用获取群二维码,此时群二维码才可以正常使用。

六、朋友圈问题#

1.朋友圈接口调用规则
获取动态接口建议最低间隔5S/次,一天不要超过200次
点赞评论接口建议间隔随机3-10s/次,一天不要超过500条
2.发送朋友圈为什么返回失败
新登录API平台的微信用户需在线1天后才可正常发送朋友圈
3.发送朋友圈/评论自己看得到,别人看不到
可能一: 朋友圈或者评论发多了或导致此问题,腾讯选择性推送
可能二: 某些屏蔽的关键字也会导致此问题(比如淘客行业的评论文字,原文字会被拦截屏蔽,需开发者修改下部分文字去适配)
可能三: 图片内容或者文字违法违规

七、下载问题#

1.下载接口调用规则
下载必须要设置下载队列,每条消息的下载要与上条间隔3-10S(随机time)
一条消息只下载一次
2.下载接口为什么返回失败
无论是下载图片、语音、链接、视频、假如频繁下载皆有可能导致此问题,我们对于这类建议如下:适配调用规则,千万别收到消息就下载!!!,否则容易失败甚至被踢掉线,一定要做下载队列,假如觉得下载时间太长业务不满足,可以多放几个僵尸微信/转发图片到其他机器人再做下载使用
文件下载失败: 除了上述频率问题,还有可能是因为回调有两条,开发者应选择第二条下载
图片下载失败: 除了上述频率问题,图片下载失败有可能不存在普清/高清,需重试几次其他种类

八、其他问题#

1.微信号显示问题
在调用获取通讯录信息接口中,微信原始id有时候返回是手机上的微信号,也有的是没有微信号,仅有wxid开头的,导致开发者有点混乱,其实这是微信的内部规则,微信原始id就是获取通讯录接口返回的,alisname为空,则代表该微信没有微信号,仅有wxid,具体理解下如图即可。
序号微信原始id微信号接口wxid返回描述
1wxid_7092880929211空wxid_7092880929211该帐号注册时用了微信默认提供的微信号,目前还没有自定义wx_alias,因此该账号每年都有1次自定义wx_alias的机会
2wxid_hrtv4z7etgvc22fangqing0827wxid_hrtv4z7etgvc22该帐号注册时用了微信系统默认提供的微信号,后来又自定义wx_alias为fangqing0827
3qq526552198空qq526552198帐号注册时用了自定义的微信号,所以没有机会自定义wx_alias了,因此wx_alias一直为空
4fangqing_hustheiheizwxfangqing_hust该帐号最初是用QQ注册的(现在已经不允许这种方式注册了),后来自定义了wx_alias为heiheizwx
5gh_7ec28ec1ef37jueduixiao888gh_7ec28ec1ef37普通的公众号wxid以gh开头
6Tencent-Games空Tencent-Games腾讯自家的公众号wxid不以gh_开头
2.风控问题?
敏感类接口: 添加好友、同意好友、获取群二维码、创建群聊为敏感接口,建议非异地登录且安全环境下再做操作,否则会有一定几率风控,目前部分敏感接口已需强制在线几天,方可操作接口
安全环境: 登录未满48小时属于非安全环境,一般新用户微信登录24小时内会掉线一次,传wxid取码登录后再隔一天就属于安全环境。
异地登录: 扫码登录显示其他城市,可使用本地代理登录解决/私有化部署本地服务。
严格按照本调用规范手册则可避免99.99%技术风控,但部分敏感行为操作仍会导致使用规范风控,常见敏感行为:(异地环境下/非安全设备环境下添加好友和自动同意好友,群发内容、拉群及图片违法违规,接口使用间隔频率像机器人等)
目前部分敏感接口已需要强制在线几天方可使用,规则如下:
获取群二维码接口3天 (官方限制)
发送朋友圈类接口1天 (官方限制)
获取群二维码接口3天(官方限制)
上一页
消息订阅
下一页
常见问题
Built with