OpenIM消息推送api打通了应用和IM系统之间的通知桥梁，让应用消息可以及时触达到目标用户。以办公场景为例，比如员工入职通知，放假通知等业务通知，由oa系统处理具体的业务逻辑，再调用消息推送api，触达到目标用户。

效果示例

以协同办公为例，员工收到系统推送的工作通知，有新任务需要处理。

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

OpenIM简介

OpenIM：从服务端到客户端SDK开源即时通讯整体解决方案。开发者可以轻松替代第三方IM云服务，打造具备聊天、社交功能的app，也可以在自身应用中集成SDK，以提供即时通讯能力。开源IM的价值在于“一切皆可控”“我的信息我做主”，无论是技术，还是信息安全。

整体超过7.2K star，OpenIM作为开源IM的领跑者，持续添加新功能，包括消息推送api，群聊已读。服务端和sdk都是Apache-2.0 License授权协议，可以免费使用。带有UI的产品需要商业授权，有兴趣的客户可以联系我们深度交流。

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

请求参数

返回示例

{
  "errCode": 0, 
  "errMsg": "", 
  "data": {
      "serverMsgID": "", 
      "clientMsgID": "", 
      "sendTime": 1645697804432
  }
}Copy to clipboardErrorCopied

返回参数

消息类型格式描述

简要描述

• 管理员消息发送字段中contentType支持的消息类型说明以及消息content的具体字段说明。

ContentType消息类型说明

Content具体内容

• content内部为具体的json对象，不同的消息类型是不同的json对象

文本消息

{
  ...,
  "content": {
      "text": "nihao"
  },
  ....
}Copy to clipboardErrorCopied

自定义消息

{
  ...,
  "content": {
      "data": "", 
      "description": "", 
      "extension": ""
  },
  ....
}Copy to clipboardErrorCopied