发送消息

支持文本、图片、文件、语音、位置与自定义消息；发送接口统一返回消息实体与发送状态。

平台调用风格

C ABI 约定：im_client_* 返回 int（0 成功，非 0 为 IDL 错误码）；char** out_json 由库分配、调用方用 im_string_free 释放；char* out + size_t cap 为调用方缓冲区（0 成功 / -1 参数非法 / -2 缓冲区不足）。

接口一览

操作	语义	传输	返回
`sendMessage`	发送任意类型消息。优先走长连接；连接不可用（SUSPEND/DISCONNECTED）时按 SDK_NO_CONNECTION 失败并保留本地待发队列（可选实现）。rev23：options.channelId 用于超级群频道消息（conversationType=10），仅频道成员接收；消息模型带 channelId。	WS 长连接	`Message`
`sendTextMessage`	发送文本消息；内部等价 sendMessage(content={type:'text',text,mentionedInfo?,quote?})。	WS 长连接	`Message`
`sendImageMessage`	发送图片消息；url 由 uploadFile 或业务方上传得到。	WS 长连接	`Message`
`sendFileMessage`	发送文件消息。	WS 长连接	`Message`
`sendVoiceMessage`	发送语音消息；duration 秒 1..300。	WS 长连接	`Message`
`sendLocationMessage`	发送位置消息；lat/lng 范围校验。	WS 长连接	`Message`

本页 6 个操作，其中 2 个在本平台绑定中声明了方法签名，其余为 C ABI 未暴露（见对应小节）。

跨端方法名

操作	Android	Web	Electron	macOS	Flutter	Native (C ABI)	iOS
`sendMessage`	`sendMessage`	`sendMessage`	`sendMessage`	`sendMessage`	`sendMessage`	`im_client_send_content`	`func`
`sendTextMessage`	`sendTextMessage`	`sendTextMessage`	`sendTextMessage`	`sendTextMessage`	`sendTextMessage`	`im_client_send_text`	`func`
`sendImageMessage`	`sendImageMessage`	`sendImageMessage`	`sendImageMessage`	`sendImageMessage`	`sendImageMessage`	—	`func`
`sendFileMessage`	`sendFileMessage`	`sendFileMessage`	`sendFileMessage`	`sendFileMessage`	`sendFileMessage`	—	`func`
`sendVoiceMessage`	`sendVoiceMessage`	`sendVoiceMessage`	`sendVoiceMessage`	`sendVoiceMessage`	`sendVoiceMessage`	—	`func`
`sendLocationMessage`	`sendLocationMessage`	`sendLocationMessage`	`sendLocationMessage`	`sendLocationMessage`	`sendLocationMessage`	—	`func`

方法名在 GA 平台之间保持一致（规则 A）；Native C ABI 只覆盖部分操作，其余操作以 — 标注。

sendMessage

发送任意类型消息。优先走长连接；连接不可用（SUSPEND/DISCONNECTED）时按 SDK_NO_CONNECTION 失败并保留本地待发队列（可选实现）。rev23：options.channelId 用于超级群频道消息（conversationType=10），仅频道成员接收；消息模型带 channelId。

im_client_send_content(im_client_t*, int conversation_type, const char* target_id, const char* content_json, const char* client_msg_id, char* out_json, size_t out_len)

WS 长连接since 1.0.0

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`content`	`Content`	必填；消息内容体（按消息类型传对应字段）
`options`	`{clientMsgId?:string, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

示例

const char* content_json = "{\"type\":\"text\",\"text\":\"你好，NI PaaS\"}";
char out[1024];
int rc = im_client_send_content(client, 1, "user2", content_json, NULL, out, sizeof(out));

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1003`	`FORBIDDEN`	客户端 / 参数 / 权限	403	否	无权限
`1004`	`USER_NOT_FOUND`	客户端 / 参数 / 权限	404	否	用户不存在
`1005`	`GROUP_NOT_FOUND`	客户端 / 参数 / 权限	404	否	群组不存在
`1006`	`NOT_GROUP_MEMBER`	客户端 / 参数 / 权限	403	否	未加入群组
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1008`	`RATE_LIMITED`	客户端 / 参数 / 权限	429	是	发送过于频繁
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1010`	`SENSITIVE_WORD`	客户端 / 参数 / 权限	400	否	内容包含敏感词
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`1012`	`CHATROOM_NOT_FOUND`	客户端 / 参数 / 权限	404	否	聊天室不存在
`1013`	`CHATROOM_CLOSED`	客户端 / 参数 / 权限	410	否	聊天室已销毁
`1014`	`NOT_CHATROOM_MEMBER`	客户端 / 参数 / 权限	403	否	未加入聊天室
`1016`	`USER_BANNED`	客户端 / 参数 / 权限	403	否	账号已被封禁
`1021`	`SERVICE_NOT_ACTIVATED`	Open API 签名与开通	403	否	服务未开通
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪
`3002`	`SDK_TIMEOUT`	SDK 本地	0	是	请求超时

sendTextMessage

发送文本消息；内部等价 sendMessage(content={type:'text',text,mentionedInfo?,quote?})。

im_client_send_text(im_client_t*, int conversation_type, const char* target_id, const char* text, const char* client_msg_id, char* out_message_id, size_t out_len)

WS 长连接since 1.0.0

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`text`	`string`	必填；文本内容（上限见消息体限制）
`options`	`{clientMsgId?:string, mentionedInfo?:MentionedInfo, quote?:Quote, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, mentionedInfo?:MentionedInfo, quote?:Quote, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

示例

char message_id[128];
int rc = im_client_send_text(client, 1 /* ConversationType.PRIVATE */, "user2", "你好，NI PaaS",
                             NULL /* clientMsgId，传值则作为幂等键 */, message_id, sizeof(message_id));
if (rc != 0) { fprintf(stderr, "send failed: %d\n", rc); }

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1010`	`SENSITIVE_WORD`	客户端 / 参数 / 权限	400	否	内容包含敏感词
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪
`3002`	`SDK_TIMEOUT`	SDK 本地	0	是	请求超时

sendImageMessage

发送图片消息；url 由 uploadFile 或业务方上传得到。

本平台 C ABI 未暴露该方法

WS 长连接since 1.0.0

本操作未在 native C ABI（include/im_sdk.h）暴露；如需该能力，请使用 Web / Electron / Flutter / Android 绑定，或通过服务端 Open API 完成。

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`content`	`{url:string,width?:uint32,height?:uint32,size?:uint64}`	必填；消息内容体（按消息类型传对应字段）：{ url:string, width?:uint32, height?:uint32, size?:uint64 }
`options`	`{clientMsgId?:string, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪

sendFileMessage

发送文件消息。

本平台 C ABI 未暴露该方法

WS 长连接since 1.0.0

本操作未在 native C ABI（include/im_sdk.h）暴露；如需该能力，请使用 Web / Electron / Flutter / Android 绑定，或通过服务端 Open API 完成。

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`content`	`{url:string,name:string,size?:uint64,mime?:string}`	必填；消息内容体（按消息类型传对应字段）：{ url:string, name:string, size?:uint64, mime?:string }
`options`	`{clientMsgId?:string, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪

sendVoiceMessage

发送语音消息；duration 秒 1..300。

本平台 C ABI 未暴露该方法

WS 长连接since 1.0.0

本操作未在 native C ABI（include/im_sdk.h）暴露；如需该能力，请使用 Web / Electron / Flutter / Android 绑定，或通过服务端 Open API 完成。

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`content`	`{url:string,duration:uint32}`	必填；消息内容体（按消息类型传对应字段）：{ url:string, duration:uint32 }
`options`	`{clientMsgId?:string, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪

sendLocationMessage

发送位置消息；lat/lng 范围校验。

本平台 C ABI 未暴露该方法

WS 长连接since 1.0.0

本操作未在 native C ABI（include/im_sdk.h）暴露；如需该能力，请使用 Web / Electron / Flutter / Android 绑定，或通过服务端 Open API 完成。

参数

参数	类型	说明
`conversationType`	`ConversationType`	必填；会话类型枚举（ConversationType）
`targetId`	`string`	必填；目标会话 ID：单聊为对方 userId，群聊为 groupId，聊天室为 chatroomId
`content`	`{latitude:double,longitude:double,address?:string}`	必填；消息内容体（按消息类型传对应字段）：{ latitude:double, longitude:double, address?:string }
`options`	`{clientMsgId?:string, channelId?:string}`	可选；选项对象（字段见类型列）：{ clientMsgId?:string, channelId?:string }

Message 消息实体（messageId、seq、发送状态）

错误码

错误码	名称	分类	HTTP	可重试	说明
`1001`	`INVALID_PARAMETER`	客户端 / 参数 / 权限	400	否	参数错误
`1007`	`MESSAGE_TOO_LARGE`	客户端 / 参数 / 权限	400	否	消息体过大（上限 5KB）
`1009`	`GROUP_MUTED`	客户端 / 参数 / 权限	403	否	你已被禁言
`1011`	`BLOCKED`	客户端 / 参数 / 权限	403	否	已被对方拉黑或你已拉黑对方
`3001`	`SDK_NOT_CONNECTED`	SDK 本地	0	是	长连接未就绪

发送消息

接口一览​

跨端方法名​

sendMessage​

sendTextMessage​

sendImageMessage​

sendFileMessage​

sendVoiceMessage​

sendLocationMessage​

相关文档​

接口一览

跨端方法名

sendMessage

sendTextMessage

sendImageMessage

sendFileMessage

sendVoiceMessage

sendLocationMessage

相关文档