跳到主要内容

发送群聊状态消息

应用下的用户可以向群组中发送群聊状态消息。通过该接口发送的消息，仅当前在线群成员用户可收到。如群成员当前未在线，则无法再收到此条状态消息。

  • 通过该接口发送的消息，默认不会向消息发件人客户端同步。如需同步，请参见 isIncludeSender 参数用法。
  • 单次最多向 3 个群组发送消息。

关于群聊状态消息​

服务端提供群聊状态消息接口 /statusmessage/group/publish.json。任何类型的消息，只要通过该接口发送，均具有以下特点：

  • 仅在线群成员可以收到此条消息。
  • 在服务端不计数、不存储。因此，如果接收者当前未在线，则不会再收到此条消息，也无法从服务端的历史消息中获取该消息。
  • 默认不支持全量消息路由。

移动端在接收该接口发送的消息时，与处理其他单聊会话消息的方式一致，会根据消息类型本身的存储、计数属性决定是否计入未读消息数、是否进行本地存储。如需了解即时通讯服务预定义的消息类型的存储、计数属性，可参见消息类型概述。如果发送的是您自定义的消息类型，需要关注该自定义消息类型在客户端的具体计数属性与存储属性定义。

请求方法​

POST： https://数据中心域名/statusmessage/group/publish.json

频率限制： 每秒钟限发送 20 条消息。请注意，如果一次向 3 个群组发送消息，视为 3 条消息。

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数类型必传说明
fromUserIdString是发送人用户 ID，通过 Server API 非群成员也可以向群组中发送消息。
toGroupIdString是接收群ID，提供多个本参数可以实现向多群发送消息，最多不超过 3 个群组。
objectNameString是消息类型，接受内置消息类型（见消息类型概述）或自定义消息的消息类型值。

注意：在自定义消息时，消息类型不可以 "RC:" 开头，以免与系统内置消息类型重名；消息类型长度不可超过 32 个字符。SDK 中必须已注册过该自定义消息，否则 SDK 收到该消息后将无法解析。
contentString是所发送消息的内容。2026 年 5 月 29 日起，新注册客户的除图片消息（RC:ImgMsg）、流式消息（RC:StreamMsg）、语音消息（RC:VcMsg）、视频消息（RC:SightMsg）、位置消息（RC:LBSMsg）、合并转发消息（RC:CombineV2Msg，RC:CombineMsg）、引用消息（RC:ReferenceMsg）外，其他消息的 content 消息体大小限制不超过 5 KB。
  • 内置消息类型：将消息内容体 JSON 对象序列化为 JSON 字符串传入。消息内容 JSON 结构体详见用户内容类消息格式或其他内置消息类型的消息内容格式。

    例如，文本消息内容 JSON 结构体内部包含 content 字段（此为 JSON 结构体内的 key 值，注意区分），则需要将 {"content":"Hello world!"} 序列化后的结果作为此处 content 字段的值。

  • 自定义消息类型（objectName 字段必须指定为自定义消息类型）：如果发送自定义消息，该参数可自定义格式，不限于 JSON。
isIncludeSenderInt否是否向发件人客户端同步已发消息。1 表示同步，默认值为 0，即不同步。注意，该接口用于发送状态消息，因此仅支持在发件人已登陆客户端（在线）的情况下同步已发消息。

请求示例​

HTTP
POST /statusmessage/group/publish.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Timestamp: 1585127132438
Nonce: 14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

content=%7B%22content%22%3A%22hello%22%2C%22extra%22%3A%22helloExtra%22%7D&fromUserId=2191&toGroupId=2193&toGroupId=2192&objectName=RC:TxtMsg&isIncludeSender=0

返回结果​

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值返回类型说明
codeNumber返回码，200 为正常。
messageUIDsArray返回 messageUID 列表
messageUIDs[i].groupIdString群组ID， 和请求 toGroupId 对应
messageUIDs[i].messageUIDString发送到对应群组的消息的唯一 ID

返回结果示例​

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 200,
    "messageUIDs": [
        {
            "groupId": "2191",
            "messageUID": "XXXX-JJJJ-KKK-LLLL"
        },
        {
            "groupId": "2192",
            "messageUID": "XXXX-JJJJ-KKK-LLKL"
        }
    ]
}