# 回复消息
回复指定消息,支持文本、富文本、图片等多种消息类型被文本、富文本、图片等多种消息类型回复。
注意事项:
- 需要开启机器人能力
- 回复群组消息,需要机器人在群中
# 请求
基本 | |
---|---|
HTTP URL | https://hi-gw.weizhipin.com/open-apis/im/v2/messages/:message_id/reply |
HTTP Method | POST |
支持的应用类型 | 自建应用商店应用 |
权限要求 | 获取用户给机器人发送的信息、向用户发送单聊、群聊消息 |
# 请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token "示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
# 路径参数(url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值)
名称 | 类型 | 描述 |
---|---|---|
message_id | string | 待回复的消息的ID 示例值:"150402" |
# 查询参数
名称 | 类型 | 描述 |
---|---|---|
user_id_type | string | 用户 ID 类型示例值:"open_id" 可选值有: open_id:用户的 open id union_id:用户的 union id user_id:用户的 user id 默认值:open_id 当值为 user_id,字段权限要求: 获取用户 user ID |
# 请求体
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
content | string | 是 | 消息内容,json结构序列化后的字符串。不同msg_type对应不同内容。 消息内容详细说明 |
msg_type | string | 是 | 消息类型 包括:image、 compressive_card、 rich_text、text等;以请求示例为准 |
uuid | string | 否 | 由开发者生成的唯一字符串序列,用于发送消息请求去重;持有相同uuid的请求1小时内至多成功执行一次 示例值:"a0d69e20-1dd1-458b-k525-dfeca4015204" 数据校验规则: 最大长度:50 字符 |
# 请求体示例
# 普通消息
发给群聊的普通消息支持@用户,消息中如何使用@XX
{
"content": "{\"text\":\" test content\"}",
"msg_type": "text",
"uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
1
2
3
4
5
2
3
4
5
# 富文本消息
发给群聊的富文本消息支持@用户,消息中如何使用@XX
用图片v2接口上传图片,来获取图片链接
{
"content": "{\"text\": \"小钟老师,我按照tableau日常使用视频教学操作后,虚拟桌面和tableau权限已经申请通过,但这个页面显示被拒绝,想请教下您这是什么原因?\",\"title\":\"Test Title\"}",
"msg_type": "rich_text",
"uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
1
2
3
4
5
2
3
4
5
# 图片消息
{
"content": "{\"originImage\":{\"height\":2160,\"url\":\"https://bosshi-admin-qa.weizhipin.com/api/media/download/TsH7SJs0E7OztL1PZZX9LB7zPMFJGPQszlAvaYRYhqcq_zlUQ00W_NCjEv0UUc-2mw~~.PNG\",\"width\":1080},\"tinyImage\":{\"height\":300,\"url\":\"https://bosshi-admin-qa.weizhipin.com/api/media/download/TsH7SJs0E7OztL1PZZX9LB7zPMFJGPQszlAvaYRYhqcq_zlUQ00W_NCjEv0UUc-2mw~~_s139.jpg\",\"width\":150}}",
"msg_type": "image",
"uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
1
2
3
4
5
2
3
4
5
# 音频消息
用文件v2接口上传文件,来获取语音文件链接,大小等参数。
{
"content": "{\"duration\":14,\"transText\":\"test\",\"size\":14412,\"transType\":2,\"url\":\"https://hi.zhipin.com/api/media/download/TsD7RJk2E7azkr1PYZX-Ehb6UMt0Ke0RmVQna-lgkshF4TxTWnIW3cDOfKgeAsPfkoEv.amr\"}",
"msg_type": "audio",
"uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
1
2
3
4
5
2
3
4
5
# 响应
# 响应体
名称 | 类型 | 描述 |
---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | message | - |
∟message_id | string | 消息id |
# 响应体示例
{
"code": 0,
"traceId": "_Ao59UOIBLPCeAAu",
"success": true,
"msg": "操作成功",
"data": {
"message_id": "14810370341xxoo"
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9