# 转发视频号消息
[异步回调]该接口用于转发视频号消息,异步回调发送结果
注意:
- 因目前企业微信机制原因,企微用户发送视频号的方式为先监听回调,接收微信用户发送的视频号再进行转发。
- 仅当机器人接收到视频号消息才能进行转发
请求方式: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值"
}'