什么情况下需要即时通讯 SDK？
已经有自己的 App
企业已有政企门户、金融 App、医疗平台、工业现场 App 或行业监管平台，希望在原有入口里加入沟通能力。
不想跳转到外部聊天工具
员工、客户或业务人员继续在原系统里工作，IM 只是嵌入能力，不改变原有业务入口和使用习惯。
不想从零开发 IM
消息可靠投递、离线补发、多端同步、音视频、推送和安全审计都比较复杂，直接接入 SDK 更现实。
需要私有化和数据可控
聊天记录、文件、通讯录、日志和审计数据部署在企业自己的服务器或私有云环境中，方便统一管控。
开放平台 API 和即时通讯 SDK 有什么区别？
把业务系统接入小天互连
以小天互连为统一工作入口，将 OA 审批、ERP 通知、HR 提醒、CRM 跟进、告警消息等通过 API 推送到小天互连，让员工在小天互连里统一接收和处理。
了解开放平台 API →
把小天互连即时通讯能力嵌入你的系统
企业已有自己的 App、门户或业务系统，通过 SDK 把小天互连的消息、群组、文件、音视频和安全能力嵌入进去。你的系统仍是主入口，小天互连作为即时通讯能力层。
获取 SDK 接入建议 →
哪些行业更适合接入即时通讯 SDK？
客户服务与内部业务系统
适合在金融 App、客服系统、业务办理平台中接入在线沟通、文件传输和消息留痕能力。
医患沟通与院内协同
适合医疗平台、院内移动系统、科室协作平台接入图文问诊、报告传输和安全沟通能力。
生产现场与工单协同
适合 MES、WMS、设备运维、工单系统接入即时沟通能力，让工单、设备和班组形成协同闭环。
内网门户与专网办公
适合政务门户、内网 App、专网协同系统接入安全可控的即时通讯能力。
跨地域调度与运维协同
适合调度平台、巡检系统、应急指挥平台接入消息、群组和音视频协同能力。
平台内置沟通能力
适合教育平台、培训平台、行业服务平台把 IM 能力作为平台基础能力提供给用户。
哪些系统最适合接入小天互连 SDK？
自研 App
让企业自研 App 具备单聊、群聊、文件、音视频和消息通知能力，不需要跳转到外部聊天工具。
企业门户 / 移动门户
把通知、消息、沟通入口嵌入统一门户，让门户不仅能看信息，也能直接沟通和协同。
OA / ERP / HR / CRM
在业务系统中直接发起沟通、推送待办、形成业务群，让沟通和业务流程关联起来。
行业监管平台
支持跨单位、跨部门、跨角色的安全协同，适合需要统一管控和留痕的行业平台。
工业现场系统
让工单、设备、班组、值班人员之间直接沟通，减少现场系统和聊天工具之间的来回切换。
客户服务系统
实现客服会话、文件传输、记录留存和审计追溯，适合金融、政企、医疗等服务场景。
为什么要做接入，而不是从零自研即时通讯？
消息可靠投递
需要处理离线、补发、乱序、重复、弱网、跨端同步等问题，不能只看发送按钮是否可用。
多端同步与推送
iOS、Android、PC、Web 端体验要一致，还要处理后台保活、厂商推送和消息状态同步。
音视频稳定性
音视频不只是打开摄像头，还涉及弱网优化、会议体验、终端兼容和私有化部署环境适配。
安全审计与合规
企业 IM 需要权限、日志、留痕、敏感词、文件控制、水印和终端安全等能力。
私有化部署与运维
服务端部署、升级、备份、监控、高可用和故障排查都需要持续投入。
长期版本维护
IM 是高频基础能力，后续终端适配、系统升级和安全修复都需要长期团队维护。
SDK 接入复杂吗？一般多久能上线？
标准接入流程
确认接入场景
明确是自研 App、门户、业务系统还是行业平台接入，以及需要消息、群组、文件还是音视频能力。
准备测试环境
开通测试服务端，准备 SDK 包、接口文档、Demo 工程和账号体系联调方式。
SDK 集成开发
完成客户端或 Web 端 SDK 接入，并与企业原有账号、组织、权限体系打通。
联调验收上线
完成消息、文件、群组、音视频、安全审计和私有化部署环境验证后上线。
Android SDK 初始化示例
// 1. 初始化 SDK（Application 中调用）
XTIMManager.init(this, "your_app_id");
// 2. 登录（传入服务端签发的 Token）
XTIMManager.login(userId, imToken, new IUIKitCallBack() {
public void onSuccess() { }
public void onError(String err) { }
});
// 3. 发送消息
XTIMManager.sendTextMessage(toUserId, "你好", callback);申请技术方案
说明技术栈、部署环境、接入端和功能范围，形成初步方案。
通常 1–2 个工作日开通测试环境
提供 SDK 包、接口文档、Demo 工程和测试服务端环境。
通常 1 个工作日集成开发联调
根据接入深度完成客户端、Web 或服务端接口联调。
常见 2–6 周部署验收上线
完成私有化部署、功能验收、安全检查和上线支持。
视环境复杂度评估接入后，你的系统可以获得哪些 IM 能力？
即时消息
支持单聊、群聊、消息漫游、文件收发、已读未读、消息撤回和自定义消息类型。
群组管理
支持组织群、项目群、业务群和大群场景，可通过接口与业务系统联动。
音视频通话
支持一对一音视频、多人会议、屏幕共享等能力，可结合私有化环境部署。
文件与文档
支持文件收发、预览、权限控制、群文件和文档中心能力，便于沉淀协作文档。
安全与合规
支持消息审计、权限控制、敏感词、水印、终端管控和私有化数据管理。
账号与组织
支持与企业已有账号、组织架构和统一认证体系对接，减少重复账号管理。
接入小天互连 SDK 后，系统可以支持哪些终端？
iOS SDK
适合 iPhone、iPad 等移动端 App 接入，支持消息、文件、通知和音视频等能力。
Android SDK
适合 Android App、行业移动终端和国产移动终端场景，支持移动端即时通讯能力接入。
PC SDK / 桌面端
适合 Windows、国产桌面终端、企业桌面工作台等场景，支持桌面端沟通和通知能力。
Web / JS SDK
适合门户、业务工作台、H5 页面和 Web 系统中嵌入会话、消息和通知能力。
鸿蒙接入方案
可结合项目需求评估鸿蒙终端接入方式，适合国产终端和信创移动场景。
跨端接入方案
可根据项目情况评估 uniapp、H5、WebView 等跨端方案，减少多端重复开发。
接入过程中，我们提供哪些支持？
开发文档
提供接口说明、参数、返回值、错误码和常见接入示例，方便开发团队评估工作量。
Demo 工程
提供典型端的 Demo 工程和调用示例，帮助开发人员快速理解初始化、登录和消息收发流程。
联调支持
结合账号体系、组织同步、消息推送、音视频和私有化部署环境进行联调支持。
部署与升级
支持私有化部署、版本升级、环境检查和上线后的技术支持，降低长期维护压力。
标准 SDK 授权
适合有技术团队、需求明确、希望自行集成 IM 能力的企业。
SDK + 定制开发
适合技术团队有限、需要 UI 定制或希望快速上线的组织。
平台 / ISV 合作
适合行业平台、软件厂商或自研平台，将 IM 能力作为平台能力提供给最终用户。
接入即时通讯 SDK 之后，还应该继续看哪些内容？
SDK 接入前最常问的问题
即时通讯 SDK 是什么，和普通 API 有什么区别？
SDK 更适合把 即时通讯能力嵌入客户端、Web 页面或业务系统界面中；API 更适合服务端调用、消息推送、组织同步、统一认证和状态回写。实际项目中，SDK 和 API 经常组合使用。
SDK 接入后，数据会不会经过第三方服务器？
小天互连支持私有化部署，消息、文件、通讯录、日志和审计数据可以部署在企业自有服务器或私有云环境中，便于统一管理和合规审计。
企业已有账号体系，怎么和 SDK 对接？
通常采用 Token 鉴权方式。用户先通过企业原有账号体系登录业务系统，再由服务端换取 IM Token，SDK 使用 Token 初始化连接，用户不需要感知两套账号。
SDK 接入一般需要多久？
基础消息、群组、文件等能力的接入周期通常相对可控；如果涉及多端、深度 UI 定制、音视频、复杂账号体系或私有化环境联调，周期会相应增加，建议结合场景评估。
UI 能不能按我们的系统风格定制？
可以根据项目方式选择标准界面、主题定制或基于能力层自行构建 UI。对于有自研 App 或行业平台的企业，通常会结合原系统设计风格做适配。
是否支持私有化、信创和内网环境？
小天互连面向私有化部署和高安全协同场景，可结合企业内网、专网、私有云和信创环境进行部署与适配，具体范围建议按项目环境确认。
如果只是推送审批待办，是不是不用 SDK？
是的，如果只是把 OA 审批、ERP 通知、HR 提醒等消息推送到小天互连里，通常优先看开放平台 API；如果要把聊天、群组、文件、音视频等 即时通讯能力嵌入自己的系统，再重点评估 SDK。
SDK 适合所有企业吗？
不是所有企业都需要 SDK。如果企业没有自研 App、门户或业务系统，只是需要一套可私有化部署的企业即时通讯系统，直接使用小天互连标准产品可能更合适。
