文档
测试

push - 群消息实时推送

POST

请求头

参数名
类型
描述
必填
Content-Type
String
application/json
必填

请求参数

参数名
类型
描述
必填
Data
Object
数据
必填
vcMsgSerialNo
String
消息编号
必填
vcMsgId
String
消息ID
必填
vcChatRoomSerialNo
String
群编号
必填
vcChatRoomId
String
群ID
必填
vcFromWxUserSerialNo
String
发消息人的编号
必填
vcFromWxUserWxId
String
发消息人的微信ID
必填
vcToWxUserSerialNo
String
接收消息人的编号
必填
vcToWxUserWxId
String
接收消息人的微信ID
必填
nMsgType
String
消息类型:1000 系统消息 2001 文字 2002 图片 2003 语音 2004 视频 2005 链接 2006 名片 2007 表情图片 2010 文件 2013 小程序 2017 视频号消息 2019 视频号直播间 2020 视频号名片
必填
vcContent
String
消息内容:系统消息(明文);文字(base64编码);图片(缩略图);语音(amr格式);视频图片;分享图片;名片的XML;表情图片;小程序的XML(base64编码);视频号内容消息(base64编码); 视频号直播间(base64编码);视频号名片(base64编码)
必填
nVoiceTime
Integer
语音时长
必填
vcShareTitle
String
分享标题(base64编码)
必填
vcShareDesc
String
分享描述(base64编码)
必填
vcShareUrl
String
视频链接;分享链接
必填
dtMsgTime
String
发送时间
必填
nIsHit
Integer
是否艾特所有人 (0 艾特群内所有人 1 艾特单个人或者不艾特人)
必填
nPlatformMsgType
Integer
区别用户发言还是机器人发言,10:普通人 12:机器人
必填
vcRelaSerialNo
String
商家业务编号(当机器人发送消息时带了业务编号则该参数有值回调,若没有则为空,群成员发消息回调时该值也为空)
必填
nMsgNum
Integer
发送消息编号(当值为-1时,消息为群成员发送,其他值为机器人发消息时传的消息编号值)
必填
vcDownFileSerialNo
String
下载文件编号(当消息内容为图片和视频文件时,回调下载文件编号,商家通过下载文件编号调用下载文件接口获取文件)当消息类型为小程序时,下载小程序封面图片也是通过此编号进行下载。
必填
vcQuoteMsgId
String
引用消息id,当机器人接受的文本消息为引用消息时,被引用的消息id通过此参数展示
必填
vcQuoteNickName
String
被引用消息人的昵称
必填
vcQuoteWxId
String
被引用消息人的微信ID
必填
nType
Integer
推送类型
必填
nResult
Integer
状态码
必填
vcMerchantNo
String
商家编号
必填
vcResult
String
消息内容
必填
vcRobotSerialNo
String
机器人编号
必填
vcRobotWxId
String
机器人wxid
必填
vcSerialNo
String
推送码
必填

推送示例

``` { "data":{ "dtMsgTime":1619775916, "nIsHit":1, "nMsgNum":-1, "nMsgType":2001, "nPlatformMsgType":10, "vcChatRoomId":"19837869704@chatroom", "vcChatRoomSerialNo":"19837869704@chatroom", "vcContent":"d3hpZF8xNXM0OGR2dzlmN3MyMjoKMQ==", "vcDownFileSerialNo":"1726031288", "vcFromWxUserSerialNo":"wxid_15s48dvw9f7s22", "vcFromWxUserWxId":"wxid_15s48dvw9f7s22", "vcMsgId":"1726031288", "vcMsgSerialNo":"1726031288", "vcToWxUserSerialNo":"wxid_n1zz6y2ksgod22", "vcToWxUserWxId":"wxid_n1zz6y2ksgod22" }, "nResult":1, "nType":5003, "vcMerchantNo":"174bb4fd3bf4f1362f924d045a68a408", "vcResult":"SUCCESS", "vcRobotSerialNo":"wxid_n1zz6y2ksgod22", "vcRobotWxId":"wxid_n1zz6y2ksgod22", "vcSerialNo":"" } ```