以办公场景为例,比如员工入职通知,放假通知等业务通知,由oa系统处理具体的业务逻辑,再调用消息推送api,触达到目标用户。
效果示例
以协同办公为例,员工收到系统推送的工作通知,有新任务需要处理。

员工点击工作通知,可以查看具体详情,每条通知有不同的发送者昵称和头像。这种通知类型是一种新的会话类型,全部聚合在同一个会话。

OpenIM简介
OpenIM:从服务端到客户端SDK开源即时通讯整体解决方案。开发者可以轻松替代第三方IM云服务,打造具备聊天、社交功能的app,也可以在自身应用中集成SDK,以提供即时通讯能力。开源IM的价值在于“一切皆可控”“我的信息我做主”,无论是技术,还是信息安全。
整体超过7.2K star,OpenIM作为开源IM的领跑者,持续添加新功能,包括消息推送api,群聊已读。服务端和sdk都是Apache-2.0 License授权协议,可以免费使用。带有UI的产品需要商业授权,有兴趣的客户可以联系我们深度交流。
5X8小时vip专属服务,包括: | |
(1)一对一技术咨询,微信 电话等各种方式; | |
(2)sdk使用辅导咨询; | |
(3)服务端架构及部署答疑; | |
(4)IM新需求优先排期; | |
(5)bug优先修复; | |
(6)系统维护和故障响应; |
web端体验:https://open-im-online.rentsoft.cn/
安卓端体验:https://www.pgyer.com/OpenIM
iOS端体验:
https://testflight.apple.com/join/o956rTGx

单机性能及容量总结
服务器资源:8核16G内存, 6个机械磁盘,每个磁盘100G, mongo 分片,10MB带宽。
容量:用户同时在线10万以上,消息条数10亿。
性能评估:同时在线用户10万,每秒钟发送消息900条,(从发送者发出消息到接收到消息)消息延时1秒
可靠性总结
每条消息都能被对方精确收到,并成功落地app本地db。对于失败的3条消息,接收方确实没有收到,确保系统消息一致性。
系统具备优秀的平行扩展能力,除存储模块外,其他模块都无状态,支持亿级用户,千亿消息量。
github地址:https://github.com/OpenIMSDK/Open-IM-Server
开发者中心:https://doc.rentsoft.cn/#/
简要描述
管理员通过后台接口发送通知类型消息
请求URL
http://x.x.x.x:10000/manager/send_msg
请求方式
POST
请求示例
{"operationID": "Oa notification operationID111","sendID": "openIM123456","recvID": "18712345678","senderPlatformID": 2,"senderFaceURL": "http://www.head.com","senderNickname": "系统通知2","content": {"notificationName": "公文管理","notificationFaceURL": "http://www.head1.com","notificationType": 1,"text": "大家好,今天是...","externalUrl":"","mixType": 0,"pictureElem": {"sourcePath": "","sourcePicture": {"uuid": "","type": "","size": 0,"width": 0,"height": 0,"url": ""},"bigPicture": {"uuid": "","type": "","size": 0,"width": 0,"height": 0,"url": ""},"snapshotPicture": {"uuid": "","type": "","size": 0,"width": 0,"height": 0,"url": ""}},"soundElem": {"uuid": "","soundPath": "","sourceUrl": "","dataSize": 0,"duration": 0},"videoElem": {"videoPath": "","videoUUID": "","videoUrl": "","videoType": "","videoSize": 0,"duration": 0,"snapshotPath": "","snapshotUUID": "","snapshotSize": 0,"snapshotUrl": "","snapshotWidth": 0,"snapshotHeight": 0},"fileElem": {"filePath": "","uuid": "","sourceUrl": "","fileName": "","fileSize": 0},"ex": ""},"contentType": 1400,"sessionType": 4,"isOnlineOnly": false,"offlinePushInfo": {"title": "admin revoke your message","desc": "","ex": "","iOSPushSound": "default","iOSBadgeCount": false}}Copy to clipboardErrorCopied请求参数
参数名 | 类型 | 必选 | 说明 |
operationID | string | 是 | 操作ID,保持唯一,建议用当前时间微秒+随机数,用于后台链路追踪问题使用 |
sendID | string | 是 | 管理员ID,为后台config文件中配置的管理员ID中一个,默认openIM123456 |
recvID | string | 是 | 接收者userID |
senderPlatformID | int | 否 | 发送者平台号,模拟用户发送时填写, 1->IOS,2->Android,3->Windows,4->OSX,5->Web,5->MiniWeb,7->Linux |
senderFaceURL | string | 否 | 发送者头像,用于客户端通知会话产生 |
senderNickname | string | 否 | 发送者昵称,用于客户端通知会话产生 |
content | object | 是 | 消息的具体内容,内部是json 对象 |
notificationName | string | 是 | 通知标题 |
notificationFaceURL | string | 是 | 通知头像 |
notificationType | int | 是 | 通知类型,如:1代表入职通知,2代表离职通知 |
text | string | 是 | 通知正文e |
externalUrl | string | 否 | 通知点击后需要跳转到的地址链接(不填则无需跳转) |
mixType | int | 是 | 通知混合类型 0:纯文字通知 1:文字+图片通知 2:文字+视频通知 3:文字+文件通知 |
pictureElem | object | 否 | 图片元素对象 |
sourcePicture | object | 否 | 原图 |
bigPicture | object | 否 | 大图 |
snapshotPicture | object | 否 | 缩略图 |
soundElem | object | 否 | 声音元素对象 |
videoElem | object | 否 | 视频元素对象 |
fileElem | object | 否 | 文件元素对象 |
uuid | string | 否 | 对象唯一ID用于缓存使用 |
type/videoType/ | string | 否 | 图片类型/视频类型 |
size/dataSize/videoSize/snapshotSize/fileSize | int | 否 | 多媒体文件大小,单位字节 |
width/snapshotWidth | int | 否 | 图片/视频缩略图宽度 |
height/snapshotHeight | int | 否 | 图片/视频缩略图高度 |
url/sourceUrl/videoUrl | string | 否 | 图片/文件/视频的URL |
sourcePath/soundPath/videoPath/filePath | string | 否 | 文件路径,可不填写 |
fileName | string | 否 | 文件名字 |
ex | string | 否 | 扩展字段 |
contentType | int | 是 | 消息类型固定为1400 |
sessionType | int | 是 | 通知会话类型固定为4 |
isOnlineOnly | bool | 否 | 改字段设置为true时候,发送的消息服务器不会存储,接收者在线才会收到,不在线该消息丢失。 |
offlinePushInfo | object | 否 | 离线推送的具体内容,如果不填写,使用服务器默认推送标题 |
title | string | 否 | 推送的标题 |
desc | string | 否 | 推送的具体描述 |
ex | string | 否 | 扩展字段 |
iOSPushSound | string | 否 | IOS的推送声音 |
iOSBadgeCount | bool | 否 | IOS推送消息是否计入桌面图标未读数 |
返回示例
{"errCode": 0,"errMsg": "","data": {"serverMsgID": "","clientMsgID": "","sendTime": 1645697804432}}Copy to clipboardErrorCopied返回参数
参数名 | 类型 | 说明 |
errCode | int | 0成功,非0失败 |
errMsg | string | 错误信息 |
sendTime | int | 消息发送的具体时间,具体为毫秒的时间戳 |
serverMsgID | string | 服务器生成的消息的唯一ID |
clientMsgID | string | 客户端生成的消息唯一ID,默认情况使用这个为主键 |
消息类型格式描述
简要描述
管理员消息发送字段中contentType支持的消息类型说明以及消息content的具体字段说明。
ContentType消息类型说明
ContentType值 | 类型说明 |
101 | 文本消息 |
102 | 图片消息 |
103 | 音频消息 |
104 | 视频消息 |
105 | 文件消息 |
106 | 群聊中的@类型消息 |
107 | 合并转发类型消息 |
108 | 名片消息 |
109 | 地理位置类型消息 |
110 | 自定义消息 |
111 | 撤回类型消息 |
112 | 已读回执类型消息 |
114 | 引用类型消息 |
Content具体内容
content内部为具体的json对象,不同的消息类型是不同的json对象
文本消息
{...,"content": {"text": "nihao"},....}Copy to clipboardErrorCopied参数名 | 必选 | 类型 | 说明 |
text | 是 | string | 文本消息的具体内容 |
自定义消息
{...,"content": {"data": "","description": "","extension": ""},....}Copy to clipboardErrorCopied参数名 | 类型 | 必选 | 说明 |
data | json string | 是 | 用户自定义的消息为json对象转换后的string |
description | json string | 否 | 扩展的描述信息为json对象转换后的string,可以不使用 |
extension | json string | 否 | 扩展字段,暂时不使用 |









