企微手机版
企微协议版微信协议版
企微协议版微信协议版
  1. 消息
  • 文档首页
  • 更新日志
  • 手机版后台保活设置指南
  • Q&A 常见疑问
  • 回调
    • 回调格式
    • 设置回调URL
    • 查询回调URL
    • 删除回调URL
  • 用户
    • 获取用户信息
    • 获取联系人二维码
    • 修改姓名
    • 修改别名
    • 修改头像
    • 修改性别
  • 消息
    • 发送文本消息
      POST
    • 发送消息(协议)
      POST
    • 撤回消息
      POST
    • 发送大视频
      POST
    • 发送视频号
      POST
    • 发送文件
      POST
    • 发送合并转发
      POST
    • 发送表情/GIF
      POST
    • 发送图片
      POST
    • 发送链接
      POST
    • 发送名片
      POST
    • 发送@消息(群聊)
      POST
    • 发送视频
      POST
    • 发送语音
      POST
    • 发送小程序
      POST
    • 查询群发任务目标列表
      POST
    • 确认群发消息
      POST
    • 极速群发
      POST
    • 发送引用消息
      POST
    • 申请语音转文字
      POST
    • 查询语音转文字结果
      POST
    • 确认企微内部消息已读
      POST
    • 标记会话已读
      POST
    • 检查客户或群是否可以群发
      POST
    • 查询待确认群发任务
      POST
    • 同步群发任务发送状态
      POST
    • 获取群发任务详情
      POST
    • 发送H5视频号消息
      POST
    • 发送位置
      POST
  • 客户
    • 同意客户申请
    • 获取企业联系人列表
    • 批量获取客户信息
    • 删除好友
    • 获取客户申请列表
    • 获取客户列表
    • 同步申请联系人
    • 同步联系人
    • 更新联系人
    • 批量删除单向好友
    • 获取缓存联系人列表
    • 获取单向好友列表
    • 获取用户信息(带检查)
    • 查询是否双向好友
    • 获取好友MultiData
    • 搜索微信/企微用户
    • 添加搜索的微信用户
    • 添加名片为联系人
    • 通过二维码名片获取联系人
    • 通过二维码名片添加微信用户
    • 重新添加被删联系人
    • 主动分页同步消息
    • 添加搜索到的企微用户
    • 检查名片联系人
    • 操作联系人黑名单
    • 批量删除单向好友
    • 获取缓存联系人列表
    • 获取单向好友列表
    • 获取用户信息(带检查)
    • 查询是否双向好友
    • 搜索微信/企微用户
    • 添加搜索的微信用户
    • 添加名片为联系人
    • 通过二维码名片获取联系人
    • 通过二维码名片添加微信用户
    • 重新添加被删联系人
    • 添加搜索到的企微用户
    • 检查名片联系人
    • 操作联系人黑名单
  • 会话
    • 获取会话群列表
    • 获取群置顶消息
    • 获取会话列表
    • 设置会话折叠
    • 设置会话免打扰
    • 设置会话置顶
    • 消息置顶/取消置顶
    • 会话操作(旧路径兼容)
    • 独立获取会话配置
    • 同步聊天标签列表
    • 创建聊天标签
    • 修改聊天标签
    • 删除聊天标签
    • 同步会话所属标签
    • 修改会话所属标签
    • 设置群置顶消息(协议)
    • 取消群置顶消息(协议)
  • 群组
    • 接受群邀请
    • 通过群添加联系人
    • 获取群成员列表
    • 批量获取群详情
    • 转让群主
    • 创建客户群
    • 解散群
    • 获取群聊黑名单
    • 获取群二维码
    • 添加群成员
    • 设置群昵称
    • 设置群邀请确认
    • 禁止改群名
    • 修改群名
    • 设置群公告
    • 修改群备注
    • 操作群黑名单
    • 退群
    • 移除群成员
    • 设置群管理员
    • 保存群到通讯录
    • 禁止互加联系人
    • 同步群信息
    • 获取客户群列表(协议)
    • 邀请/添加群成员(协议)
    • 获取入群欢迎语列表
    • 创建文本入群欢迎语
    • 应用已有入群欢迎语
    • 获取群防骚扰规则
    • 设置群关联的防骚扰规则
    • 操作客户群白名单
    • 审批群邀请申请
    • 设置群自动回复
    • 获取群模板
    • 将群模板应用到指定群
    • 创建客户群(空群别名)
    • 获取群置顶消息(别名)
    • 置顶群消息(别名)
    • 取消置顶群消息(别名)
    • 取消群管理员(别名)
  • 朋友圈
    • 设置朋友圈签名
    • 发布朋友圈
    • 获取发布的朋友圈记录
    • 获取指定朋友圈详情
    • 删除朋友圈
    • 评论朋友圈
    • 删除朋友圈评论
    • 点赞/取消点赞
    • 确认发送朋友圈任务
    • 获取朋友圈任务记录
    • 获取朋友圈任务发送状态
    • 设置朋友圈封面
  • 客户标签
    • 批量打标签
    • 创建标签
    • 删除标签
    • 获取企业标签
    • 获取个人标签
    • 修改标签
    • 操作用户标签
    • 获取企业和个人标签
    • 批量追加客户标签
  • 开放平台
    • ChatId转RoomId
    • 获取应用信息
    • 获取附件素材
    • 获取Banner列表
    • 获取个人Banner信息
    • OpenID转VID
    • RoomId转ChatId
    • VID转ExternalUserID
    • 检查OAuth URL
    • VID转OpenID
    • 获取URL动作码
  • CDN
    • 配置存储(OSS/COS/MinIO)
    • FTN下载文件
    • CDN下载文件
    • CDN上传文件
    • 上传图片
    • FTN上传文件
    • 微信文件下载
    • CDN上传文件(别名)
    • CDN下载文件(别名)
  • 组织架构
    • 获取架构节点数据
    • 修改同事信息
    • 同步公司架构
    • 同步同事信息
  • 企业
    • 获取企业简要信息
  • 同步
  • 数据模型
    • BaseRequest
    • GuidParam
    • ErrorResponse
    • CommonResponse
  1. 消息

发送合并转发

POST
/msg/send_forward_msg
Fila cmd 1(CMD_SEND_MESSAGE,SendMessageRequest.forward oneof)。与 /msg/send_message_scene(cmd 109)完全同构:把 path 换成 scene、body 原样保留即可走协议版。
注意事项:
1.
messages[] 每条消息可携带 extra_content(base64 编码的额外数据,可选)——转发真实聊天记录时把接收消息回包的 extra_content 原样回传即可还原原始消息附加信息;该字段为 string 类型,网关不做明文→base64 自动编码,必须直接传 base64 字符串。
2.
其余低频类型(weapp/feed_video/feed_live/big_video/h5_feed_video)结构与对应 send_* 接口的 oneof 字段一致;h5_feed_video 的 bytes 字段传明文,网关自动 base64。
3.
每条消息只填一种 oneof 类型。

请求参数

Body 参数application/json必填

示例
{
    "guid": "string",
    "conversation_id": "string",
    "forward": {
        "message_title": "string",
        "sender_vid": "string",
        "sender_name": "string",
        "from_conv_type": 0,
        "from_conv_id": "string",
        "messages": [
            {
                "msg_type": "string",
                "sender_id": "string",
                "sender_name": "string",
                "sendtime": 0,
                "conv_type": 0,
                "conv_id": "string",
                "extra_content": "string",
                "text": {
                    "content": "string"
                },
                "image": {
                    "file_id": "string",
                    "size": 0,
                    "width": 0,
                    "height": 0,
                    "aes_key": "string",
                    "md5": "string",
                    "is_hd": true,
                    "auth_key": "string"
                },
                "video": {
                    "file_id": "string",
                    "size": 0,
                    "file_name": "string",
                    "aes_key": "string",
                    "md5": "string",
                    "duration": 0,
                    "width": 0,
                    "height": 0,
                    "auth_key": "string"
                },
                "file": {
                    "file_id": "string",
                    "size": 0,
                    "file_name": "string",
                    "aes_key": "string",
                    "md5": "string",
                    "auth_key": "string"
                },
                "emotion": {
                    "file_id": "string",
                    "size": 0,
                    "aes_key": "string",
                    "md5": "string",
                    "url": "string",
                    "width": 0,
                    "height": 0
                },
                "link": {
                    "title": "string",
                    "desc": "string",
                    "url": "string",
                    "image_url": "string"
                },
                "location": {
                    "longitude": 0,
                    "latitude": 0,
                    "address": "string",
                    "title": "string",
                    "zoom": 0
                },
                "nested_forward": {}
            }
        ]
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/msg/send_forward_msg' \
--header 'Content-Type: application/json' \
--data '{
    "guid": "string",
    "conversation_id": "string",
    "forward": {
        "message_title": "string",
        "sender_vid": "string",
        "sender_name": "string",
        "from_conv_type": 0,
        "from_conv_id": "string",
        "messages": [
            {
                "msg_type": "string",
                "sender_id": "string",
                "sender_name": "string",
                "sendtime": 0,
                "conv_type": 0,
                "conv_id": "string",
                "extra_content": "string",
                "text": {
                    "content": "string"
                },
                "image": {
                    "file_id": "string",
                    "size": 0,
                    "width": 0,
                    "height": 0,
                    "aes_key": "string",
                    "md5": "string",
                    "is_hd": true,
                    "auth_key": "string"
                },
                "video": {
                    "file_id": "string",
                    "size": 0,
                    "file_name": "string",
                    "aes_key": "string",
                    "md5": "string",
                    "duration": 0,
                    "width": 0,
                    "height": 0,
                    "auth_key": "string"
                },
                "file": {
                    "file_id": "string",
                    "size": 0,
                    "file_name": "string",
                    "aes_key": "string",
                    "md5": "string",
                    "auth_key": "string"
                },
                "emotion": {
                    "file_id": "string",
                    "size": 0,
                    "aes_key": "string",
                    "md5": "string",
                    "url": "string",
                    "width": 0,
                    "height": 0
                },
                "link": {
                    "title": "string",
                    "desc": "string",
                    "url": "string",
                    "image_url": "string"
                },
                "location": {
                    "longitude": 0,
                    "latitude": 0,
                    "address": "string",
                    "title": "string",
                    "zoom": 0
                },
                "nested_forward": {}
            }
        ]
    }
}'

返回响应

🟢200
application/json
OK
Bodyapplication/json

示例
{
    "error_code": 0,
    "error_message": "string",
    "data": {
        "msgId": "string",
        "seq": "string"
    }
}
修改于 2026-11-16 18:37:42
上一页
发送文件
下一页
发送表情/GIF
Built with