集成指南
从业务系统视角完成 WuKongIM 接入。
WuKongIM 负责实时连接、频道消息、持久化、集群路由和在线投递；你的业务服务仍然负责账号、权限、业务关系、内容治理和最终业务动作。
先确认当前安全边界
当前 v3 Beta 应用默认会完成 CONNECT 协议协商、会话加密以及已存设备 Token 的精确校验。产品 HTTP 接口仍不包含业务鉴权中间件，内置 Token 记录也没有过期时间或重放策略。生产接入必须把这些接口放在受信网络或经过鉴权的反向代理之后，并由业务身份系统负责凭据签发、轮换与撤销。
推荐集成路径
集成架构
划分客户端、业务服务和 WuKongIM 集群的职责。
身份认证
设计 UID、设备、Token、连接和撤销生命周期。
消息收发
理解客户端和服务端消息路径、确认与恢复边界。
Webhook
安全、幂等地消费消息和在线状态事件。
插件扩展
评估节点内 Hook、生命周期、UID 绑定与安全边界。
上线检查
发布前检查身份、连接、消息、恢复、安全、容量和回滚。
选择平台 API 前，先通过 WuKongIMSDK 核心概念理解共同词汇，再进入 WuKongIMSDK 选择平台并按任务顺序接入。
最小业务闭环
- 用户先登录你的业务服务，而不是直接向 WuKongIM 证明业务身份。
- 业务服务为会话分配稳定 UID、设备标识和短生命周期凭据。
- 客户端获取路由并通过 SDK 或协议实现连接 Gateway。
- 客户端或受信业务服务发送消息，并检查协议级结果。
- 业务服务通过 Webhook 接收异步事件，把副作用写入自己的可靠队列。
- 断线后由客户端 SDK 重连并恢复消息，不把 Webhook 当作客户端收件箱。
上线前检查
| 领域 | 必须由你确认 |
|---|---|
| 身份 | UID 来源唯一，Token 不由不可信客户端自行签发 |
| 网络 | HTTP 产品接口不直接暴露公网，Gateway 使用受控入口 |
| 权限 | 好友、群成员、黑白名单和内容策略由业务规则驱动 |
| 消息 | 业务定义 Payload 版本，发送方保存 client_msg_no |
| 回调 | 接收端先持久化再返回 200，处理逻辑可重复执行 |
| 运维 | 监控队列压力、失败、重试耗尽和端到端延迟 |
优先用稳定的服务端接口与 Webhook 建立边界清晰的集成；只有确实需要节点附近的同步或提交后 Hook 时，再引入插件扩展。
实现完成后，用真实客户端、服务端配置、网络环境和回滚方案执行上线检查。