# 转发视频号消息

[异步回调]该接口用于转发视频号消息,异步回调发送结果

注意:

  1. 因目前企业微信机制原因,企微用户发送视频号的方式为先监听回调,接收微信用户发送的视频号再进行转发。
  2. 仅当机器人接收到视频号消息才能进行转发

请求方式:POST

请求地址:https://$basehost/gateway/qopen/ForwardChannelMessage

body参数

{
  "robot_id": "机器人id",
  "contact_id": "联系人id",
  "group_id": "群id",
  "channel_msg_sn": "私聊或群聊消息回调获取的channel_msg_sn值"
}
字段 类型 必填 说明
robot_id string 机器人id
contact_id string 联系人id,该字段赋值后,group_id不再支持赋值
group_id string 群id,该字段赋值后,contact_id不再支持赋值
channel_msg_sn string 私聊或群聊消息回调获取的channel_msg_sn值

注意:如果contact_id与group_id同时存在,优先选取group_id

返回值:

{
    "data": {
        "serial_no": "",
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   serial_no string 请求序列号
hint string 请求日志ID

处理结果,异步返回值 encoding_content解密后的结构:

{
    "event_type": 705014,
    "err_code": 0,
    "err_msg": "",
    "serial_no": "操作编号",
    "robot_id": "机器人id",
	"data": {
        "contact_id": "好友id",
        "group_id": "群id",
        "msg_id": "消息id"
    }
}

字段说明

字段 类型 说明
event_type int 事件类型,705014
err_code int 响应码
err_msg string 错误提示
serial_no string 操作编号
robot_id string 机器人id
contact_id string 好友id
group_id string 群id
msg_id string 消息id

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/ForwardChannelMessage \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
      "robot_id": "机器人id",
      "contact_id": "联系人id",
      "group_id": "群id",
      "channel_msg_sn": "从消息回调获取的channel_msg_sn值"
   }'
最后更新时间: 2024/4/19 10:59:26