weimi
  1. 消息推送
weimi
  • wmi_api
    • 开发指南
      • 开发前必读
      • 配置文件说明
    • 账号接口
      • 获取二维码
      • 切换账号获取二维码
      • 获取设备登录过的账号
      • 检测扫码结果
      • 恢复登录
      • 获取账号登录状态
      • 获取账号列表
      • 获取单个账号信息
      • 退出账号
    • 消息接口
      • 发送文本消息
      • 发送图片消息
      • 发送名片
      • 发送动态表情
      • 发送位置
      • 发送引用消息
      • 转发小程序
      • 撤回消息
      • 下载消息中的文件
      • 解析消息中的下载信息
    • 好友接口
      • 同步好友信息
      • 搜索好友
      • 添加好友
      • 验证好友请求
      • 获取好友列表、本地缓存
      • 获取好友信息、本地缓存
      • 获取好友信息,非本地
      • 设置好友标签
      • 设置好友备注
      • 删除好友
      • 检测好友关系
    • 标签接口
      • 同步标签信息
      • 获取标签信息,本地缓存
      • 添加标签
      • 删除标签
    • 群接口
      • 设置群昵称
      • 设置群公告
      • 获取群公告
      • 取消/保存通讯录
      • 同步群成员信息
      • 获取群成员信息,实时
      • 获取群成员信息,本地缓存
      • 获取群详情,实时
      • 获取群详情,本地缓存
      • 添加群成员
      • 邀请群成员
      • 删除群成员
      • 添加群管理员
      • 删除群管理员
      • 转让群
      • 退出群聊
      • 创建群
    • 朋友圈接口
      • 发布图文朋友圈
      • 转发朋友圈
      • 删除朋友圈
      • 获取朋友圈列表
      • 获取好友朋友圈
      • 获取指定ID朋友圈
      • 朋友圈点赞
      • 朋友圈评论
      • 朋友圈取消点赞
      • 删除朋友圈评论
      • 下载朋友圈中的图片/视频
    • 消息推送
      • 消息推送说明
      • 所有消息推送
        POST
      • 账号上下线通知
        POST
      • 新好友请求通知推送
        POST
      • 加入新好友通知推送
        POST
      • 成员入群通知推送
        POST
      • 加入群聊通知推送
        POST
      • 联系人信息修改通知推送
        POST
      • 联系人删除通知推送
        POST
      • 消息文件下载进度推送
        POST
  1. 消息推送

所有消息推送

开发中
POST
新消息推送
接受到任何消息,系统都会将消息推送到此接口。包括(新好友请求,加入新好友,入群...)消息。需要自行解析处理
重点讲解几个字段关系。一般通过contactid,sendusername,isself 3个字段能处理大部分业务逻辑
ownerwxid,contactid 两个字段能组成一个会话
sendusername(群里用处大一点,知道是哪个成员发送的)
ownerwxid 归属人,(好理解,消息属于哪个号的)
contactid 联系人,
fromusername 消息来源,
tousername,消息去处
sendusername 消息发送者
聊天场景
1.你跟好友张三私聊, 你发送一条消息给张三
contactid:张三ID
fromusername 你ID
tousername 张三ID
sendusername 你ID
2.张三回了你一条消息
contactid:张三ID
fromusername 张三ID
tousername 你ID
sendusername 张三ID
3.你在群聊里聊天, 你发送一条消息在群里
contactid:群聊ID
fromusername 你ID
tousername 群聊ID
sendusername 你ID
4.群里有人回了一条消息
contactid:群聊ID
fromusername 群聊ID
tousername 你的ID
sendusername 群成员ID

请求参数

Body 参数application/json
chattype
string 
会话类型
必需
user 好友,room 群聊,gh 公众号
clientid
string 
暂无用途
必需
contactid
string 
联系人ID
必需
好友ID,群聊ID,gh ID
contactalias
string  | null 
联系人wx号
可选
自己有修改的号,如果自己未修改过,采用contactid
contactinfo
object 
联系人基本信息
必需
contacttype
integer 
必需
displayname
string 
必需
headurl
string 
必需
nickname
string 
必需
sex
integer 
必需
wxid
string 
必需
content
string 
消息内容
必需
createtime
integer 
消息发送时间
必需
fileinfo
object 
暂无用途
必需
fileext
string 
必需
filelen
string 
必需
filename
string 
必需
filesize
string 
必需
filetitle
string 
必需
fileurl
string 
必需
newmsgid
string 
必需
wxid
string 
必需
fromcontactinfo
object 
消息来源人
必需
contacttype
integer 
必需
displayname
string 
必需
headurl
string 
必需
nickname
string 
必需
sex
integer 
必需
wxid
string 
必需
fromusername
string 
消息来源人基本信息
必需
imgbuf
string 
图片消息缩略图
必需
不一定会有
imgstatus
integer 
暂无用途
必需
isself
boolean 
是否自己发送
必需
msgid
integer 
必需
msgsource
string 
必需
msgtype
integer 
消息类型
必需
1文本,3图片消息,34语音消息,37好友请求, 42名片,43视频消息,47动态表情,48位置信息,48位置信息,
49app消息(这里面通过解析消息内容中的XML,不同的XML代表不同的信息),
appmsg部分介绍:(5 链接分享,19聊天记录分享,33,36 小程序,50视频通话,53接龙,57引用或者文件,2000转账,2001红包。其他请自行通过发送不同的消息进行分析)
51打开会话,(10000,10002) 系统消息
newmsgid
string 
消息ID
必需
唯一id
ownerinfo
object 
归属人基本信息
必需
contacttype
integer 
必需
displayname
string 
必需
headurl
string 
必需
nickname
string 
必需
sex
integer 
必需
wxid
string 
必需
ownerwxid
string 
归属人ID
必需
pushcontent
string 
常用在会话显示内容
必需
sendcontactinfo
object 
信息发送者基本信息
必需
contacttype
integer 
必需
displayname
string 
必需
headurl
string 
必需
nickname
string 
必需
sex
integer 
必需
wxid
string 
必需
alias
string 
必需
sendusername
string 
信息发送者ID
必需
私聊的话,发送者要么是自己,要么是好友。 群聊的话(要么是自己,要么是群成员)
status
integer 
暂无用途
必需
tocontactinfo
object 
必需
contacttype
integer 
必需
displayname
string 
必需
headurl
string 
必需
nickname
string 
必需
sex
integer 
必需
wxid
string 
必需
tousername
string 
必需
uuid
string 
设备ID
必需
示例
{
  "chattype": "user",
  "clientid": "",
  "contactid": "",
  "contactinfo": {
    "contacttype": 0,
    "displayname": "",
    "headurl": "",
    "nickname": "",
    "sex": 0,
    "wxid": ""
  },
  "content": "",
  "createtime": 0,
  "fileinfo": {
    "fileext": "",
    "filelen": "",
    "filename": "",
    "filesize": "",
    "filetitle": "",
    "fileurl": "",
    "newmsgid": "",
    "wxid": ""
  },
  "fromcontactinfo": {
    "contacttype": 0,
    "displayname": "",
    "headurl": "",
    "nickname": "",
    "sex": 0,
    "wxid": ""
  },
  "fromusername": "",
  "imgbuf": "",
  "imgstatus": 1,
  "isself": true,
  "msgid": 0,
  "msgsource": "",
  "msgtype": 51,
  "newmsgid": "",
  "ownerinfo": {
    "contacttype": 0,
    "displayname": "",
    "headurl": "",
    "nickname": "",
    "sex": 0,
    "wxid": ""
  },
  "ownerwxid": "",
  "pushcontent": "",
  "sendcontactinfo": {
    "contacttype": 0,
    "displayname": "",
    "headurl": "",
    "nickname": "",
    "sex": 0,
    "wxid": ""
  },
  "sendusername": "",
  "status": 3,
  "tocontactinfo": {
    "contacttype": 0,
    "displayname": "",
    "headurl": "",
    "nickname": "",
    "sex": 0,
    "wxid": ""
  },
  "tousername": "",
  "uuid": ""
}

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
消息推送说明
下一页
账号上下线通知
Built with