查询群消息置顶列表

POST

http://manager.wecomapi.com/wecom/finder/api

接口提示

查询指定群聊的置顶消息列表。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/msg/roomTopMessageList",
  "params": {
    "guid": "",
    "roomId": "1088541**********6"
  }
}'

响应示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "senderId": "168******04",
        "senderName": "",
        "sendAvatar": "",
        "msgType": 29,
        "timestamp": 1752825029,
        "isOutRoom": 1,
        "fromRoomId": "1096******579",
        "msgUniqueIdentifier": "CIGABBDD+efDBnICAAyAB",
        "msgData": {
          "fileAesKey": "326137****316637",
          "fileHttpUrl": "https://wework.qpic.cn/wwpic3az/757944_rZr5j_dgQa1_1744700046/0",
          "fileId": "306b020102046430620201000204cf35f7dc******a0204e5fe1d3c02046879fcc4042461373233666563632d346364352d343565372d****0b54596fcb20131b6efa0201010201000400",
          "fileMd5": "c23f9c8917***131b6efa",
          "fileSize": 0,
          "filename": "",
          "height": 600,
          "sourceDesc": "",
          "sourceType": 2,
          "type": 2,
          "width": 800
        },
        "seq": 25,
        "desc": "[表情]"
      },
      {
        "senderId": "168******04",
        "senderName": "",
        "sendAvatar": "",
        "msgType": 4,
        "timestamp": 1752805930,
        "isOutRoom": 1,
        "fromRoomId": "1096******579",
        "msgUniqueIdentifier": "CAQQquTwYY3O/X+gAMghuGtpAM=",
        "msgData": {
          "subMsgDesc": "虚头***和Ice",
          "subMsgFlag": 0,
          "subMsgList": [
            {
              "subMsgData": {
                "atList": [],
                "content": "wehook[OK]"
              },
              "subMsgFromId": "788*****9450",
              "subMsgId": "",
              "subMsgSenderAvatar": "",
              "subMsgSenderId": "788*****9450",
              "subMsgTimestamp": 1752803769,
              "subMsgType": 0
            },
            {
              "subMsgData": {
                "fileAesKey": "23554a2e9****0b67660c86fc",
                "fileId": "306902010204***465662d396662352d343530352d616633302d653137666134663932623462020100020303345004****a6c0201020201000400",
                "fileMd5": "ab3c67c4e******1b02ffca6c",
                "fileSize": 209998,
                "filename": "",
                "imageHasHd": false
              },
              "subMsgFromId": "7881****450",
              "subMsgId": "",
              "subMsgSenderAvatar": "",
              "subMsgSenderId": "788****450",
              "subMsgTimestamp": 1752803791,
              "subMsgType": 14
            }
          ]
        },
        "seq": 27,
        "desc": ""
      }
    ]
  },
  "msg": "成功"
}

修改于 2026-07-03 10:03:16

修改消息状态

设置群消息置顶