重要提示: 请开发者在接入和使用 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 如何处理您的个人信息,请查阅《七陌隐私政策》及相关第三方隐私政策。

六、最终用户授权同意的建议方式

为了确保用户授权的有效性,建议采用以下交互流程:
  1. 首次启动: App 首次启动时,立即弹出隐私政策摘要或全文。
  2. 明示告知: 在弹窗中清晰列出 App 及第三方 SDK 将收集的信息和用途。
  3. 用户动作: 提供明确的“同意”和“拒绝”按钮。不得默认勾选,不得仅提供“确定”按钮。
  4. 触发初始化: 只有当用户点击“同意”按钮后,App 才能执行 SDK 的初始化代码(参见“延迟初始化要求”)。
  5. 拒绝处理: 如果用户点击“拒绝”,App 应允许用户退出或以仅浏览模式运行(不初始化 SDK),不得强制退出或反复弹窗骚扰用户。

隐私政策授权弹窗示例:

隐私政策授权弹窗示例

敏感个人信息授权弹窗示例(SDK已处理权限的申请和说明):

敏感个人信息授权弹窗示例

七、保障个人信息主体权利

作为应用开发者,您应协助最终用户行使个人信息主体权利(如访问、更正、删除、撤回同意等)。对于涉及SDK收集的数据:
  • 行使权利渠道: 您应在隐私政策中提供便捷的联系方式。
  • 七陌联系方式: 如果用户对SDK收集的信息有疑问或通过 App 方无法解决,可以引导用户联系七陌官方:
  • 响应时效: 七陌承诺在验证用户身份后的 15 天内 予以回复。