快速开始

泡泡 IM 提供私有化即时通讯服务与带界面的多平台 SDK。你可以保留产品现有的账号和导航，把聊天能力接入网站或 App。

1. 准备服务端

选择一种安装方式，完成数据库与管理员设置。确认以下地址正常：

地址	用途
https://example.com/admin/	管理后台
https://example.com/app/sdk/*	SDK HTTP 接口
wss://example.com/ws	实时连接

2. 打通身份

用户先登录你的产品。你的后端根据已经验证的登录身份，调用 POST /app/sdk/token 换取 IM Token，再返回给 SDK 的 authProvider。

用户登录宿主 → 宿主后端确认身份 → IM 服务签发 Token
                                      ↓
                       SDK 登录 → 首次同步 → 展示聊天

SDK Secret 只保留在后端。Token 中的 user_id 对应宿主稳定用户 ID；昵称、头像可以更新，用户 ID 不随资料修改而变化。

接入内置宿主时，POST /app/auth/token 已提供相应的会话换票入口。第三方宿主接入流程见认证与登录。

3. 选择平台

平台	接入入口
Web / H5	JavaScript 工作台、容器嵌入与浮层
Android	Kotlin / Java 与原生 Fragment
iOS	Swift 与 UIKit Controller
HarmonyOS	ArkTS 与原生页面
uni-app	Vue 页面与模块接入

4. 验证首个会话

准备两位工作伙伴的账号，例如陈悦和林舟。完成登录、添加好友、发送文字和图片，然后退出并重新登录，检查历史记录与未读数量。群聊、语音、视频、名片和通话在基本链路通过后继续验证。

业务入口打开聊天、未读角标和账号切换均使用 SDK 公开 API。SDK 内部 HTTP 与实时连接由 SDK 管理；自己实现协议客户端时再查阅HTTP 接口和实时通信。