回调消息接口

POSThttp://yourcallbackurl/

回调消息的请求示例。文档中地址仅为演示。机器人收到消息后会将消息返回到用户配置的地址上。

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

integer

消息唯一id

必需

integer

时间戳

必需

type

integer

必需

消息类型；1文字，57引用消息，10000系统消息

subType

integer

可选

消息子类型；消息类型为49时会细分

sender

string

发送者wxid

必需

groupId

integer

群Id

可选

groupCode

string

群编码

可选

content

string

消息内容

必需

isAt

boolean

是否@机器人

必需

isSelf

boolean

必需

是否机器人发送的消息

isGroup

boolean

是否群消息

必需

atUser

array[string]

可选

被@的群用户wxid

referMsgId

integer

引用的消息id

必需

location

object

可选

位置信息；消息类型为48时出现

latitude

string

经度

必需

longitude

string

维度

必需

address

string

具体地址

必需

label

string

地点

必需

wcPayInfo

object

可选

转账信息；消息类型为49，子消息类型为2000时出现

beginTransferTime

string

转账时间

必需

invalidTime

string

转账失效时间

必需

receiverWxid

string

收款人wxid

必需

transcationId

string

交易id

必需

transferId

string

转账id

必需

paySubType

integer

必需

转账类型；1发起转账，3接收转账，4退回

fee

string

转账金额；单位元

必需

link

object

可选

链接或公众号消息；消息类型为49，子消息类型为5时出现

title

string

消息标题

必需

des

string

消息内容

可选

url

string

链接地址

可选

thumburl

string

封面图片地址

可选

mpName

string

公众号名称

必需

file

object

可选

文件详情；消息类型为49，子消息类型为6时出现

title

string

文件标题

必需

size

string

文件大小

必需

md5

string

文件md5值

必需

card

object

可选

卡片消息；消息类型为49，子消息类型为16时出现

title

string

消息标题

必需

des

string

消息详情

必需

cardName

string

卡片名称

必需

cardType

integer

卡片类型

必需

cardTypeName

string

卡片类型名称

必需

{
  "id": 7169067274223235000,
  "ts": 1698190646000,
  "type": 1,
  "subType": 5,
  "sender": "pcstx1",
  "groupId": 1,
  "groupCode": "#9f34e6a90122489cb4d6092ee49a2d0a",
  "content": "@机器人 @好友 你好",
  "atUser": [
    "wxid_0k***x12",
    "wxid_34***22"
  ],
  "isAt": true,
  "isSelf": false,
  "isGroup": true,
  "wcPayInfo": {
    "beginTransferTime": "2024-10-11 20:24:06",
    "invalidTime": "2024-10-12 20:24:06",
    "receiverWxid": "wxid_0klid01d53ox12",
    "transcationId": "53010001026210202410110894356390",
    "transferId": "1000050001202410110121498997777",
    "paySubType": 1,
    "fee": "0.01"
  },
  "link": {
    "title": "设备提醒",
    "des": "设备：这是消息的标题\n内容：这是消息的内容",
    "url": "https://www.pushplus.plus/shortMessage/e3f9ee97cbd04e009652cf08a5d48b03",
    "thumburl": "",
    "mpName": "pushplus 推送加"
  },
  "file": {
    "title": "微加机器人.pdf",
    "size": "125.2 KB",
    "md5": "13f420ff42aada3745f7d6f683bfeae8"
  },
  "location": {
    "latitude": "31.281913",
    "longitude": "120.598372",
    "address": "上海市南京路1号",
    "label": "上海南京路"
  },
  "card": {
    "title": "赠送了一张发票",
    "des": "宜家家居",
    "cardName": "增值税电子普通发票",
    "cardType": 30,
    "cardTypeName": "发票"
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

响应编码

必需

msg

string

响应说明

必需

{
  "code": 200,
  "msg": "成功"
}

最后修改时间： 1 个月前