产品概述
NI PaaS 即时通讯(IM)是一套可私有化部署的 IM PaaS:包含 Rust 服务端(WebSocket 长连接 + REST Open API + Admin API)、多端客户端 SDK(IMLib / IMKit)、控制台与运营后台。所有公开接口由同一份 IDL 生成文档,接口语义与文档零漂移。
选择你的接入路径
产品介绍
了解 IM PaaS 的架构、四种会话形态与能力边界。
客户端集成
按平台接入 IMLib / IMKit,完成初始化、连接与收发消息。
服务端集成
调用 Server API 管理用户、群组、消息、聊天室与回调。
API 接口列表
按模块浏览全部 REST 接口、参数、返回与错误码。
即时通讯产品线
即时通讯与实时音视频是并列的两条产品线。当前版本文档中心只覆盖即时通讯;音视频仅保留入口,不展开内容。
| 产品线 | 文档入口 | 说明 |
|---|---|---|
| 即时通讯 IM | 功能介绍 / 服务端集成 | 单聊、群组、超级群、聊天室;本文档中心的主体内容 |
| 实时音视频 RTC | 音视频范围说明 | 会议、直播、1v1 与多人呼叫,与 IM 并列但不在当前版本范围 |
四种会话形态
IM PaaS 以会话(Conversation)组织消息,提供单聊、群组、超级群与聊天室四种形态。
| 形态 | 场景类比 | 消息可靠性 | 成员上限 |
|---|---|---|---|
| 单聊 Private | 一对一私聊 | 在线投递 + 离线补发 + 历史漫游 | — |
| 群组 Group | 工作群 / 兴趣群 | 在线投递 + 离线补发 + 历史漫游 | 3,000 |
| 超级群 SuperGroup | 大型社区 / 频道 | 在线投递 + 历史漫游 | 100,000 |
| 聊天室 Chatroom | 直播互动 / 广场 | 仅在线投递,不补发 | 5,000 |
场景指南与教程
推送通道与投递
token 台账、6 个厂商通道配置、no_token/not_configured 状态机;厂商发送未实现。
推送接入
webhook 配置、接收端示例与测试方法;token 注册已可用。
翻译能力
provider/端点配置、BCP-47 语言码、message.translate 与 1021 边界。
用户信息托管
资料字段、自托管/外部同步、userId 规则与同步 API。
Node.js App Server SDK
Open API + Admin API 实物,含签名/重试/错误映射与冒烟证据。
超级群会话类型
SUPER_GROUP(10) 的语义、发送/历史规则与存量 2+super 兼容。
超级群场景指南
频道、用户组、私有频道与配额;四端 SDK 频道/用户组已实现,频道消息隔离未实现。
选型教程
单聊/群聊/聊天室/超级群与消息类型选择,含可运行片段。
IA 迁移与别名策略
301/alias、redirects.json 与旧地址/短链映射表。