15. 融云 API 15.11 IM 消息发送回执【未授权拦截通过，待登录态联调】

Table of Contents

15.11 IM 消息发送回执【未授权拦截通过，待登录态联调】

POST /tieup/api/v1/im/messages/{message_no}/send-ack

路径参数：

参数 类型 必填 说明
message_no string 是 消息编号

鉴权：需要 Authorization: Bearer <access_token>，仅消息发送者可回传。

请求体：

{
  "send_status": 1,
  "rong_message_uid": "5GSB-N82K-4F9H",
  "failed_reason": ""
}

请求参数：

参数 类型 必填 说明
send_status integer 是 1=成功，2=失败
rong_message_uid string 否 旧版客户端 SDK 发送成功后返回的融云消息 UID；新链路由后端发送时不需要调用本接口
failed_reason null 否 旧版客户端 SDK 发送失败原因

响应字段：

字段 类型 说明
message_no string 消息编号
object_name string 融云消息 ObjectName
direction integer 消息方向：1=粉丝发给艺人，2=艺人发给粉丝，3=艺人普通群发
message_type string 消息类型：text/image/voice/video
content object/null 本地消息正文；撤回后为 null
content.text string text
reference object/null 引用消息快照
extra_content object 融云 extraContent 扩展快照
reply_count integer 被引用回复次数
send_status integer 发送状态：0=创建，1=发送成功，2=发送失败，3=已撤回
recall_status integer 撤回状态：0=正常，1=已撤回
created_at string 创建时间

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "message_no": "MSG202607030001",
    "object_name": "RC:TxtMsg",
    "direction": 1,
    "message_type": "text",
    "content": {
      "text": "你好"
    },
    "reference": null,
    "extra_content": {
      "senderRole": "fan",
      "fanId": "10001",
      "artistId": "20001",
      "replyCount": "0"
    },
    "reply_count": 0,
    "send_status": 1,
    "recall_status": 0,
    "created_at": "2026-07-03 15:30:45"
  }
}

说明：

  • 本接口仅作为旧版客户端兼容入口；后端已发送的消息调用本接口时只会幂等返回当前状态，不会覆盖 rong_message_uid 或发送状态。
  • 旧版链路中 send_status = 1 表示客户端 SDK 发送成功，必须回传 rong_message_uid。
  • 旧版成功回执只保存客户端返回的融云 UID；回执到达时间仅用于本地 sent_at 展示，不写入 rong_sent_time_ms，避免把本机时间误作融云原始消息时间。
  • 旧版链路中 send_status = 2 表示客户端 SDK 发送失败，可回传 failed_reason。
  • 成功回执会推进定向消息未读统计或群发任务状态；重复成功回传按幂等返回。