发送群消息 - 齐成云·IM消息服务

发送群组消息，支持文本、图片、文件等多种类型

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer QC2b8fd0ca342c72f857f5f96

Appid

string

可选

默认值:

1001

ClientId

string

可选

默认值:

131231231223

TimeStamp

string

可选

默认值:

Client-Type

string

可选

默认值:

EnterpriseCenterWEB

Body 参数application/json

receiverId

string

群组ID

必需

>= 1 字符<= 20 字符

示例值:

g_Ab3Xy9Mn4Kp8

messageType

enum<string>

消息类型

必需

枚举值:

textimagefilevideoaudiolocationcard

示例值:

text

messageContent

string

消息内容

必需

>= 1 字符<= 5000 字符

示例值:

大家好，这是一条群消息

messageExtra

object

可选

消息扩展信息（可选）

示例值:

{}

replyToMessageKey

string

可选

回复的消息Key（可选）

>= 1 字符<= 50 字符

示例值:

k8m3n9p2q5r7

forwardFromMessageKey

string

可选

转发的原消息Key（可选）

>= 1 字符<= 50 字符

示例值:

w4x7y1z5a8b2

conversationName

string

可选

会话名称（可选，不提供时自动获取群组名称）

<= 100 字符

示例值:

技术讨论群

conversationIcon

string

可选

会话图标（可选，不提供时自动获取群组头像）

<= 500 字符

示例值:

https://example.com/group_avatar.jpg

sourceType

enum<string>

来源类型（可选）

可选

枚举值:

internalmeituanelemedouyinxiaohongshuwechatalipaytaobaojdother

示例值:

internal

sourceAppId

string

可选

来源应用ID（可选）

<= 100 字符

示例值:

app_12345

示例

{
    "receiverId": "g_Ab3Xy9Mn4Kp8",
    "messageType": "text",
    "messageContent": "大家好，这是一条群消息",
    "messageExtra": {},
    "replyToMessageKey": "k8m3n9p2q5r7",
    "forwardFromMessageKey": "w4x7y1z5a8b2",
    "conversationName": "技术讨论群",
    "conversationIcon": "https://example.com/group_avatar.jpg",
    "sourceType": "internal",
    "sourceAppId": "app_12345"
}

返回响应

🟢200成功

application/json

发送成功

Body

object {0}

示例

{
    "code": 200,
    "message": "消息发送成功",
    "data": {
        "messageKey": "k8m3n9p2q5r7",
        "chatsMessageId": 12345,
        "groupId": "g_Ab3Xy9Mn4Kp8",
        "senderId": "user_123",
        "messageType": "text",
        "messageContent": "大家好，这是一条群消息",
        "createTime": "2024-01-01T12:00:00Z",
        "deliveryStatus": "sent"
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在