# 回复消息

回复指定消息,支持文本、富文本、图片等多种消息类型被文本、富文本、图片等多种消息类型回复。

注意事项:

  • 需要开启机器人能力
  • 回复群组消息,需要机器人在群中

# 请求

基本
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

# 富文本消息

发给群聊的富文本消息支持@用户,消息中如何使用@XX
用图片v2接口上传图片,来获取图片链接

{
  "content": "{\"text\": \"![image](<https://bosshi-admin-qa.weizhipin.com/api/media/download/TsH7SJs0E7OztL1PZZX9LB7zPMFJGPQszlAvaYRYhqcq_zlUQ00W_NCjEv0UUc-2mw~~_s139.jpg> \\\"w=300&h=152&originImageUrl=https://bosshi-admin-qa.weizhipin.com/api/media/download/TsH7SJs0E7OztL1PZZX9LB7zPMFJGPQszlAvaYRYhqcq_zlUQ00W_NCjEv0UUc-2mw~~_s139.jpg&originImageWidth=2858&originImageHeight=1446\\\")小钟老师,我按照tableau日常使用视频教学操作后,虚拟桌面和tableau权限已经申请通过,但这个页面显示被拒绝,想请教下您这是什么原因?\",\"title\":\"Test Title\"}",
  "msg_type": "rich_text",
  "uuid":"a0d69e20-1dd1-458b-k525-dfeca4015204"
}
1
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

# 音频消息

用文件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

# 响应

# 响应体

名称 类型 描述
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
最后更新于 : 3/4/2024, 3:29:16 PM