微信个人号开发API-VideosApi.com-微信机器人开发
  1. 开发说明
  • 开发说明
    • 对接须知
    • 对接步骤
    • 消息回调
    • 消息回调接口说明
    • 接入Api相关问答
  • 项目案例(部分)
    • 视频号智能化
    • 客户管理系统/SCRM
    • 群活码
    • 个性业务开发案例
  • 开发API
    • 登录模块
      • (步骤1)获取登录二维码
        POST
      • (步骤2)执行登录
        POST
      • 弹框登录
        POST
      • 退出
        POST
      • 检查是否在线
        POST
      • 异常断线重连
        POST
    • 联系人相关接口
      • 获取通讯录列表(包含群聊)
      • 获取通讯录列表(包含群聊)缓存
      • 搜索好友
      • 添加好友/同意好友
      • 删除好友
      • 获取群/好友简要信息
      • 获取群/好友详细信息
      • 设置好友仅聊天
      • 检测好友关系
      • 设置好友备注
      • 获取手机通讯录
      • 上传手机通讯录
      • 同步企微好友
      • 获取企微好友详情
    • 群管理接口
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 设置群公告
      • 获取群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
    • 消息模块
      • 下载
        • 下载图片
        • 下载语音
        • 下载视频
        • 下载emoji
        • cdn下载
      • 发送文字消息
      • 发送文件消息
      • 发送图片消息
      • 发送语音消息
      • 发送视频消息
      • 发送链接消息
      • 发送名片消息
      • 发送emoji消息
      • 发送appmsg消息
      • 发送小程序消息
      • 转发文件
      • 转发图片
      • 转发视频
      • 转发链接
      • 转发小程序
      • 撤回消息
    • 朋友圈模块
      • 点赞/取消点赞
      • 删除朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 某条朋友圈详情
      • 评论/删除评论
    • 标签模块
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 个人模块
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 收藏夹模块
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号模块
      • 搜索视频号
      • 获取视频号信息
      • 创建视频号
      • 发私信文本消息
      • 发私信图片消息
      • 获取私信人详情
      • 获取私信SessionId
      • 扫码登录视频号助手
      • 视频-直接发布视频
      • 关注/取消关注
      • 获取用户主页
      • 获取自己赞和收藏
      • 视频-分享给好友
      • 视频-分享到朋友圈
      • 视频-评论列表
      • 视频-点赞
      • 视频-小红心
      • 视频-评论
      • 修改视频号资料
      • 视频-浏览
      • 关注列表
      • 获取消息列表
      • 我的二维码
      • 扫码关注
      • 扫码获取视频详情
      • 扫码点小红心
      • 扫码大拇指
      • 扫码浏览
      • 扫码评论
      • 同步私信消息(临时停用)
      • 视频-直接发布视频
      • 视频-CDN上传视频(1)
      • 视频-CDN异步上传视频
      • 视频-CDN异步查询
      • 视频-CDN发布视频(2)
  1. 开发说明

接入Api相关问答

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

一、排查掉线问题情况#

目前新用户首次登录VideosApi平台,在24小时内会100%掉线。若发生掉线,掉线后传appId调用获取二维码接口即可扫码登录,可实现3月内不掉线。目前已知掉线情况如下:
1.微信登录地点是异省,会导致掉线,解决方法是使用本省代理登录。如果使用本省代理方式登录后,依然在60秒内掉线,或者再次传递appId获取二维码扫码登录依然掉线,则可能进入新设备风控状态。在这种情况下,第二天8点后可以再次尝试正常登录。
2.微信登录iPad真机或者手机退出微信或者换了手机登录微信,也可能导致掉线。
3.新用户登录的微信账号可能会被认为是处于非安全环境下,会触发各类异常风控。因此,建议在登录后的1~2天内避免频繁操作,如群发同质化内容、添加好友、自动同意好友、创建群聊等。
4.在首次掉线后,务必**传递正确的appId获取二维码重新扫码登录,确保登录上一次的设备。**否则,可能会陷入循环掉线的情况,甚至导致封号。
5.判断是否陷入循环掉线可通过手机微信的设置功能中的“账号与安全”-“登录过的设备”查看,如果存在多个以iPad开头的设备,则代表可能陷入错误的循环掉线情况。
以上是针对可能导致微信掉线情况的分析和解决方法。根据具体情况,建议与相关技术支持团队或平台进行沟通,以获取更准确的解决方案。

二、消息发送规范#

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

三、消息接收问题排查#

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

四、好友相关问题#

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

五、群相关问题#

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

六、朋友圈问题#

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

七、下载问题#

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

八、其他问题#

微信号显示问题
在调用获取通讯录信息接口中,微信原始id有时候返回是手机上的微信号,也有的是没有微信号,仅有wxid开头的,导致开发者有点混乱,其实这是微信的内部规则,微信原始id就是获取通讯录接口返回的,alisname为空,则代表该微信没有微信号,仅有wxid,具体理解下如图即可。
image.png
风控问题
敏感类接口: 添加好友、同意好友、获取群二维码、创建群聊为敏感接口,建议非异地登录且安全环境下再做操作,否则会有一定几率风控,目前部分敏感接口已需强制在线几天,方可操作接口
安全环境: 登录未满48小时属于非安全环境,一般新用户微信登录24小时内会掉线一次,传wxid取码登录后再隔一天就属于安全环境。
异地登录: 扫码登录显示其他城市,可使用本地代理登录解决/私有化部署本地服务。
严格按照本调用规范手册则可避免99.99%技术风控,但部分敏感行为操作仍会导致使用规范风控,常见敏感行为:(异地环境下/非安全设备环境下添加好友和自动同意好友,群发内容、拉群及图片违法违规,接口使用间隔频率像机器人等)
目前部分敏感接口已需要强制在线几天方可使用,规则如下:
获取群二维码接口3天 (官方限制)
发送朋友圈类接口1天 (官方限制)
获取群二维码接口3天(官方限制)

产品可行性及API相关问题咨询

上一页
消息回调接口说明
下一页
视频号智能化
Built with