企业微信号二次开发 & wecomapi.com
个人微信接口官网地址管理后台
个人微信接口官网地址管理后台
  1. 03 消息收发与会话
  • API文档目录
    • 接入指南与说明
      • 👉 接入须知
      • 🛡️ Webhook调试指南
      • 🔄 消息推送(回调)服务
      • 📖 常见业务与技术 FAQ
      • ⚠️开发常见问题
    • 开放接口
      • 01 登录与设备
        • 配置消息回调地址
        • ① 创建设备并获取 guid
        • ② 获取登录二维码
        • ③ 校验登录验证码(按需)
        • ④ 查询扫码登录状态
        • 免扫码二次登录
        • 恢复设备在线状态
        • 停止并释放设备
        • 查询账号在线状态
        • 退出当前设备
      • 02 联系人管理
        • 外部联系人与好友申请列表
        • 内部联系人列表
        • 批量获取联系人详情
        • 搜索联系人
        • 通过二维码查询联系人
        • 添加个微联系人
        • 添加企微联系人
        • 添加群成员为好友
        • 添加企微名片联系人
        • 重新添加单删联系人
        • 同意好友申请
        • 修改个微联系人备注
        • 修改企微联系人信息
        • 删除联系人
        • OpenID 转 UserID
        • UserID 转 OpenID
      • 03 消息收发与会话
        • 发送引用消息
        • 发送文本消息
          POST
        • 发送富文本消息
          POST
        • 发送图片消息
          POST
        • 发送 GIF 表情
          POST
        • 发送视频消息
          POST
        • 发送文件消息
          POST
        • 发送语音消息
          POST
        • 发送链接消息
          POST
        • 发送小程序消息
          POST
        • 发送名片消息
          POST
        • 发送视频号消息
          POST
        • 发送位置消息
          POST
        • 语音转文字:提交任务
          POST
        • 语音转文字:查询结果
          POST
        • 收藏 GIF 表情
          POST
        • 同步个人收藏消息
          POST
        • 撤回消息
          POST
        • 修改消息状态
          POST
        • 查询群消息置顶列表
          POST
        • 设置群消息置顶
          POST
        • 移除群消息置顶
          POST
        • 发起群发消息
          POST
        • 查询群发状态
          POST
        • 查询群发规则
          POST
        • 同步历史消息分页
          POST
        • 查询会话列表分页
          POST
        • 编辑会话分组
          POST
        • 查询会话分组
          POST
      • 04 文件上传与下载
        • SDK 临时云存储上传
        • 企微文件异步上传
        • 企微大文件异步上传
        • 个微文件异步下载
        • 企微文件异步下载
        • 企微大文件异步下载
        • CDN 文件转临时 URL
        • 本地文件上传
        • URL 文件上传
        • 个微文件下载
        • 企微文件下载
      • 05 外部群与群组管理
        • 查询群组列表分页
        • 批量获取群详情
        • 群成员变动查询
        • 获取群二维码
        • 创建外部群组
        • 修改群名称
        • 修改群备注
        • 修改群内昵称
        • 修改群公告
        • 开启或关闭群改名权限
        • 禁止群成员修改群名称
        • 邀请或添加群成员
        • 管理员确认群成员邀请
        • 移除群成员
        • 禁止群成员互相添加
        • 添加群管理员
        • 取消群管理员
        • 开启入群确认
        • 通过链接接受入群邀请
        • 退出群组
        • 转让群主
        • 解散群组
        • OpenID 转 RoomID
        • RoomID 转 OpenID
      • 06 账号资料
        • 生成个人二维码
        • 获取账号资料
        • 更新账号资料
        • 查询企业资料
      • 07 客户标签管理
        • 查询标签列表分页
        • 客户标签增删
        • 个人标签增删改
      • 08 朋友圈能力
        • 朋友圈素材上传
        • 发布朋友圈
        • 删除朋友圈
        • 朋友圈点赞或取消点赞
        • 朋友圈评论或追评
        • 查询朋友圈互动列表
        • 批量获取朋友圈详情
        • 删除朋友圈评论
  1. 03 消息收发与会话

同步个人收藏消息

POST
http://manager.wecomapi.com/wecom/finder/api
接口提示
1.
同步个人收藏消息列表。
2.
涉及异步或分页同步时,建议保存返回的任务标识、版本号或分页游标,用于后续查询和补偿。
3.
结果含表情收藏列表和消息收藏列表。

请求参数

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/syncCollectionMsg",
  "params": {
    "guid": "",
    "msgSeq": 0,
    "limit": 1
  }
}'
响应示例响应示例
{
  "code": 0,
  "msg": "成功",
  "data": {
    "lastSeq": 675677,
    "list": [
      {
        "seq": 675677,
        "type": 2,
        "state": 4,
        "uniqueId": "10002_1000320",
        "coverUrl": "https://wework.qpic.cn/3az/652562_6265/0",
        "timestamp": 1753416266,
        "syncMsgList": [
          {
            "fromRoomId": "109471182932817",
            "isRoomNotice": 0,
            "msgData": {
              "extras": {
                "base64RawData": "qr4BUgog33aK4V1EDYLAVHj4x77N4HpxVYNkNrkGxExe44P7+=",
                "signedMsg": {
                  "infoBuffer": "CMzth8QGEAIaEzEyMzOTkiAhAAMKC53MIADOAE=",
                  "originalContentType": 101,
                  "signature": "df768ae15d440d82c05478f8c5ee383fbf810"
                }
              },
              "fileAesKey": "8e5d59c05798d086fac3e335e64eb0c5",
              "fileAuthKey": "v1_fa482fd545938ef910077243c7cf93ffcdec7a02165e06d8228a4c6b43e770c85019f883345449b8fd809f8a66a70840139d685323de8b41bc7b4587e05671aa05de4b288bccb795e2fc9a0fe6b99ba8",
              "fileBigHttpUrl": "https://imunion.weixin.qq.com/cgi-bin/mmae-bin/?param=",
              "fileBigSize": 400647,
              "fileMd5": "37c3e66f816092bed20624ff7d02f607",
              "fileMiddleHeight": 120,
              "fileMiddleHttpUrl": "https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=",
              "fileMiddleSize": 400647,
              "fileMiddleWidth": 67,
              "fileThumbHeight": 120,
              "fileThumbHttpUrl": "https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=",
              "fileThumbSize": 3701,
              "fileThumbWidth": 67,
              "filename": "",
              "height": 120,
              "imageHasHd": false,
              "width": 67
            },
            "msgServerId": 1000320,
            "msgType": 101,
            "msgUniqueIdentifier": "",
            "receiverId": "16888577872696",
            "senderId": "78813031798577",
            "senderName": "wecomapi",
            "seq": 676811,
            "timestamp": 1753347786,
            "base64RawData": "base64RawData",
            "asId": "0",
            "msgFlag": 0,
            "referId": "0",
            "isRevoked": false,
            "IsWWWXOutRoom": false
          }
        ]
      }
    ]
  }
}
修改于 2026-07-03 10:03:16
上一页
收藏 GIF 表情
下一页
撤回消息
Built with