引用消息发送说明#
在回复特定消息时,可通过 reply 参数实现引用回复,让对话上下文更清晰。前置条件:发送前请确认对方为正常好友关系,否则消息将发送失败。
功能说明
可引用类型:0 文本、14 图片、15 文件、16 语音、23 视频、29 表情。
参数规则:reply.msgData 结构随 reply.type 变化,详见 回调结构说明 中对应消息体的 msgData 结构。 {
"method": "/msg/sendText",
"params": {
"guid": "{{guid}}",
"content": "你好,这是你第一条企业微信消息",
"toId": "168****768657",
"isNoNeedRead": true,
"reply": {
"type": 15,
"msgServerId": 1003054,
"userId": "168********23231",
"showName": "非必需,可选",
"timeStamp": 1625957403,
"msgUniqueIdentifier": "CAQQFdfkdYY1+C/qomAgAMg5+7DyQE=",
"msgData": {
"fileId": "306902010204623060020100020**********342d6164326131353032653862300201000203018bd00410367086416687ce5b51963e0ffd98ddf70201050201000400",
"fileSize": 101317,
"fileMd5": "3670864166****63e0ffd98ddf7",
"filename": "JPEG 图像.jpeg",
"filenameExt": "jpeg",
"fileAesKey": "d8af09b058*****f3fcfd9169d723"
}
}
}
}
{
"method": "/msg/sendHyperText",
"params": {
"guid": "{{guid}}",
"content": [
{
"subtype": 2,
"text": "[微笑][憨笑]"
},
{
"subtype": 1,
"text": ""
},
{
"subtype": 0,
"text": " 我是mac.stone"
}
],
"toId": "7881302602370971",
"reply": {
"type": 0,
"userId": "788*******450",
"showName": "",
"timeStamp": 1625951302,
"msgUniqueIdentifier": "3504********323",
"msgData": {
"content": "我是第一百个为妖刀应援的阴阳"
}
}
}
}
引用参数填写正确后,发送的消息将附带被引用消息的上下文展示。
使用注意
1. reply.type 须与被引用消息类型一致,否则可能发送失败。
2. 建议从 Webhook 事件 推送的原始消息中提取 msgData 字段,避免手动拼装错误。