重要提示: 请开发者在接入和使用 SDK 时严格遵守以下要求,以确保应用符合合规标准。
一、最新 SDK 版本说明
为了确保您的应用拥有最新的安全补丁和功能改进,同时符合最新的合规要求,建议您始终使用七陌云客服访客端 SDK 的最新版本。
- 请定期访问七陌官方渠道(www.7moor.com)获取最新版本的 SDK 包。
- 更新 SDK 时,请同步查阅最新的隐私政策条款,确保您的应用隐私协议与 SDK 的数据处理行为保持一致。
二、权限调用合规要求
七陌云客服访客端 SDK 遵循权限最小化原则。以下是 SDK 可能涉及的系统权限及其合规使用说明,请根据您的目标平台(Android/iOS/HarmonyOS)进行配置:
| 权限名称/代码 |
是否可选 |
使用场景/目的 |
申请时机 |
适用平台 |
网络权限
INTERNET |
必选 |
用于 SDK 访问网络以提供在线客服服务。 |
应用安装时自动授予 |
Android / iOS / HarmonyOS |
网络状态权限
ACCESS_NETWORK_STATE
ACCESS_WIFI_STATE |
必选 |
用于检测网络连接状态(如 WiFi/4G/5G),优化网络通信质量。 |
应用安装时自动授予 |
Android |
电话状态权限
READ_PHONE_STATE |
必选 |
获取手机状态参数,辅助生成唯一设备标识符,用于唯一标识访客身份及安全风控。 |
首次初始化 SDK 时或进入客服页面时 |
Android |
前台服务权限
FOREGROUND_SERVICE
FOREGROUND_SERVICE_DATA_SYNC |
必选 |
用于保持应用在后台时的连接活跃,确保能及时接收客服消息。 |
应用安装时自动授予 |
Android |
震动权限
VIBRATE |
必选 |
用于收到新消息时的震动提醒。 |
应用安装时自动授予 |
Android |
通知权限
POST_NOTIFICATIONS |
可选 |
用于在系统状态栏显示新消息通知。 |
首次初始化 SDK 时或需要展示通知时 |
Android |
麦克风权限
RECORD_AUDIO |
可选 |
用于音视频通话时采集声音,或录音功能(发送语音消息)。 |
用户点击语音输入或视频通话按钮时 |
Android / iOS |
摄像头权限
CAMERA |
可选 |
用于音视频通话时采集画面,或拍照/摄像功能。 |
用户点击拍照或视频通话按钮时 |
Android / iOS |
存储权限 (读/写)
READ_EXTERNAL_STORAGE
WRITE_EXTERNAL_STORAGE
READ_MEDIA_AUDIO
READ_MEDIA_IMAGES
READ_MEDIA_VIDEO |
可选 |
用于发送相册中的图片/视频/文件(与客服沟通),或保存客服发送的文件。 |
用户点击发送图片/文件或保存文件按钮时 |
Android |
相册/媒体库权限
Photo Library |
可选 |
iOS 平台用于访问相册以发送图片或视频。 |
用户点击选择相册图片按钮时 |
iOS |
注意: 对于可选权限,严禁在应用启动时一次性申请。必须在用户实际触发相关功能(如点击“发送图片”按钮)时,才向用户发起权限申请弹窗。
三、延迟初始化要求
根据合规规范,
严禁在用户同意 App 隐私政策之前初始化 SDK 或收集任何个人信息(包括设备信息)。
❌ 错误做法
// 伪代码示例:在应用启动时直接初始化 SDK,属于违规行为
function Application_OnCreate() {
// 违规:用户尚未同意隐私政策,严禁在此处初始化 SDK
QimoSDK.init(config);
}
✅ 正确做法 (延迟初始化)
您应该将 SDK 的初始化代码封装在一个方法中,等待用户点击“同意”隐私政策后,再调用该方法。
// 1. 定义初始化方法
function initSDK() {
// 检查是否已经同意过隐私政策(本地标记)
if (hasUserAgreedPrivacyPolicy) {
QimoSDK.init(config);
Log("SDK 初始化成功");
}
}
// 2. 在用户点击同意隐私政策的事件中调用
function onUserClickAgree() {
// 保存同意状态到本地存储
savePrivacyAgreedState(true);
// 执行初始化
initSDK();
}
// 3. 在应用启动页(Splash)逻辑中
function Splash_OnCreate() {
if (checkPrivacyAgreedState()) {
// 如果之前已经同意过,可以直接初始化
initSDK();
proceedToMainActivity();
} else {
// 否则展示隐私政策弹窗,等待用户同意
showPrivacyDialog();
}
}
四、最小化使用功能要求
接入说明: 七陌云客服访客端 SDK 包括基本业务功能和扩展业务功能。
基本功能:创建在线客服对话、进行文本沟通
扩展功能:进行多媒体(图片、视频、文件等)、语音沟通,音视频通话,拍照/摄像上传。
| 产品功能类型 |
产品功能名称 |
个人信息类型及字段 |
是否必选 |
用途和目的 |
配置方式 |
| 基本功能 |
创建在线客服对话 |
设备标识符:包括 Android/iOS ID 等 |
是 |
用于客服人员为访客查询使用 SDK 问题时使用。 |
基本业务 |
| 设备硬件信息:设备型号、设备浏览器版本 |
用于访客与客服人员进行对话时使用,例如:进线后客服人员使用相关信息为访客查询是否是设备相关问题。 |
| 网络信息:IP 地址 |
用于访客与客服人员进行对话时使用,例如:根据访客 IP 地址判断是否支持某活动等。 |
| 个人信息:用户标识、用户名称、用户编号等 |
SDK 使用此功能将访客的个人信息传送给客服人员,方便客服人员为访客处理与个人信息相关的问题。 |
| 进行文本沟通 |
个人通信信息:文本聊天记录 |
是 |
用于访客与客服进行文字交流及记录存储。 |
| 扩展功能 |
进行多媒体沟通 |
设备内信息:图片、视频、文件等 |
否 |
用于访客发送多媒体文件辅助沟通。 |
Android、iOS、Harmony:
管理后台手动配置
(默认开启) |
| 个人通信信息:图片、视频、文件等沟通记录 |
否 |
用于访客与客服进行多媒体交流及记录存储。 |
| 进行语音沟通 |
多媒体文件:录制的语音消息 |
否 |
用于访客对客服人员发送语音消息。 |
| 个人通信信息:语音消息记录 |
否 |
用于访客与客服进行语音交流及记录存储。 |
| 音视频通话 |
网络信息:网络类型、WiFi 状态、IP 地址 |
否 |
用于客服人员与访客进行进行音视频通话时判断访客网络状态、培训访客使用等。 |
Android、iOS:
管理后台单独配置
(默认关闭) |
| 设备标识符:包括 Android/iOS ID 等 |
用于系统判断访客设备是否支持音视频通话。 |
| 设备硬件信息:设备型号、设备浏览器版本 |
用于系统判断访客设备是否支持音视频通话。 |
| 拍照/摄像 |
多媒体文件:拍摄的照片、录制的视频 |
否 |
用于访客对客服人员录制视频/拍摄照片上传。 |
Android、iOS、Harmony:
管理后台手动配置
(默认开启) |
五、隐私政策披露要求与示例说明
您必须在您的《隐私政策》中设立独立章节或列表,向用户明示集成的第三方 SDK 信息(包含七陌 SDK 及其集成的第三方服务)。
1. 七陌 SDK 主体信息
- SDK 名称: 七陌云客服访客端 SDK
- 服务提供方: 北京容联七陌科技有限公司
- 使用目的: 提供在线客服咨询、即时通讯服务
- 收集个人信息类型: (必选)设备标识符(Android/iOS ID 等)、设备硬件信息(设备型号、设备浏览器版本)、网络信息(IP 地址)、个人信息(用户标识、用户名称、用户编号等)、个人通信信息(文本聊天记录);(可选)设备内信息(图片、视频、文件等)、个人通信信息(图片、视频、文件等沟通记录、语音消息记录)、多媒体文件(录制的语音消息、拍摄的照片、录制的视频)、网络信息(网络类型、WiFi 状态)
- 隐私政策链接: https://www.7moor.com/privacy_for_harmonyos
2. 集成的第三方 SDK 目录
七陌 SDK 可能会接入以下第三方服务以实现特定功能,您需要在隐私政策中一并披露:
| SDK 名称 |
公司名称 |
适用平台 |
使用场景/目的 |
收集个人信息类型 |
隐私政策链接 |
| 七牛云存储 |
上海七牛信息技术有限公司 |
Android/iOS/HarmonyOS |
在线咨询或机器人自动接待时,用于云存储/云下载。 |
设备存储文件 |
点击查看 |
| MiniMax |
上海稀宇科技有限公司 |
全平台 |
用于提升智能客服系统的对话体验(业务咨询、服务信息等)。 |
用户的访客会话信息 |
点击查看 |
3. 隐私政策参考条款示例
为了提供在线客服咨询服务,我们的应用集成了
七陌云客服访客端 SDK。该 SDK 需要收集您的设备信息和网络状态信息。为了实现文件存储和智能对话功能,该 SDK 还会集成
七牛云存储 SDK(用于文件上传下载)和
MiniMax 服务(用于智能客服对话)。关于这些第三方 SDK 如何处理您的个人信息,请查阅
《七陌隐私政策》及相关第三方隐私政策。
六、最终用户授权同意的建议方式
为了确保用户授权的有效性,建议采用以下交互流程:
- 首次启动: App 首次启动时,立即弹出隐私政策摘要或全文。
- 明示告知: 在弹窗中清晰列出 App 及第三方 SDK 将收集的信息和用途。
- 用户动作: 提供明确的“同意”和“拒绝”按钮。不得默认勾选,不得仅提供“确定”按钮。
- 触发初始化: 只有当用户点击“同意”按钮后,App 才能执行 SDK 的初始化代码(参见“延迟初始化要求”)。
- 拒绝处理: 如果用户点击“拒绝”,App 应允许用户退出或以仅浏览模式运行(不初始化 SDK),不得强制退出或反复弹窗骚扰用户。
隐私政策授权弹窗示例:
敏感个人信息授权弹窗示例(SDK已处理权限的申请和说明):
七、保障个人信息主体权利
作为应用开发者,您应协助最终用户行使个人信息主体权利(如访问、更正、删除、撤回同意等)。对于涉及SDK收集的数据:
- 行使权利渠道: 您应在隐私政策中提供便捷的联系方式。
- 七陌联系方式: 如果用户对SDK收集的信息有疑问或通过 App 方无法解决,可以引导用户联系七陌官方:
- 响应时效: 七陌承诺在验证用户身份后的 15 天内 予以回复。
×
![]()