常见问题解答

· 1 min read

掌上意见箱常见问题解答 (FAQ)

本文档旨在为掌上意见箱智能意见收集管理平台的开发者和高级用户提供常见问题的解答。内容基于产品知识库和最佳实践，力求清晰、准确。

1. 账户与权限管理

Q1: 如何创建和管理组织账户？

A: 掌上意见箱支持多层级组织架构。超级管理员可通过管理后台的“组织管理”模块创建子组织、分配管理员并设置其权限范围。权限可细分为：全局管理、指定项目/渠道管理、仅数据查看等。

Q2: 用户角色有哪些？权限如何划分？

A: 主要角色包括：

  • 超级管理员：拥有平台所有权限，包括系统设置、组织与用户管理、所有数据访问。
  • 组织管理员：管理所属组织及下级组织内的项目、成员和数据。
  • 项目管理员：负责特定意见收集项目的全生命周期管理（创建、配置、发布、分析）。
  • 数据分析员：拥有指定项目或渠道的数据查看、导出和分析权限。
  • 普通成员：通常仅能提交意见或查看已公开的反馈结果。 权限通过角色-资源绑定模型进行控制，确保最小权限原则。

2. 意见收集与渠道

Q3: 支持哪些意见收集渠道？

A: 掌上意见箱提供多渠道集成方案：

  1. Web嵌入：提供JavaScript SDK，可轻松将意见箱组件嵌入自有网站或Web应用。
// 示例：初始化并嵌入意见箱
<script src="https://cdn.feedbackbox.com/sdk/v1.min.js"></script>
<script>
  FeedbackBox.init({
    projectId: 'YOUR_PROJECT_ID',
    position: 'bottom-right', // 悬浮按钮位置
    theme: 'light' // 主题
  });
</script>
  1. API接口：提供完整的RESTful API，支持后端系统直接提交意见数据或同步用户信息。
  2. 移动端SDK：提供iOS与Android原生SDK，支持深度集成到移动App中。
  3. 公开链接/二维码：可为每个项目生成独立的收集链接和二维码，用于线下场景或社交媒体传播。

Q4: 如何自定义意见收集表单？

A: 在项目创建或编辑页面，进入“表单设计器”。您可以通过拖拽方式添加多种字段类型：

  • 基础字段：单行文本、多行文本、评分、单选、多选、下拉列表。
  • 高级字段：文件上传（支持图片、文档）、地理位置、联系人信息。
  • 逻辑字段：可根据上一题答案动态显示或跳转后续问题。 设计完成后，可实时预览效果并保存发布。

3. 数据处理与分析

Q5: 收集到的意见数据如何进行分析？

A: 平台提供多维度的数据分析工具：

  1. 实时看板：展示意见提交总量、各渠道分布、满意度趋势等关键指标。
  2. 文本分析：利用自然语言处理技术，自动对文本意见进行情感分析（正面/中性/负面）、主题聚类和关键词提取，帮助快速洞察核心问题。
  3. 自定义报表：支持基于任意字段（如时间、渠道、用户标签）进行交叉筛选和统计，生成可视化图表（柱状图、饼图、趋势线），并支持导出为CSV或PDF。

Q6: 数据导出格式和方式有哪些？

A: 支持两种主要导出方式：

  1. 后台手动导出：在“数据管理”页面，选择时间范围、渠道等筛选条件后，可一键导出原始数据（CSV格式）或分析报告（PDF格式）。
  2. API自动同步：通过GET /api/v1/feedbacks接口（需认证）可编程式获取数据，实现与内部BI系统或数据仓库的自动同步。接口支持分页、过滤和时间戳增量同步。

4. 集成与开发

Q7: 如何将用户信息同步到掌上意见箱？

A: 为实现精准的用户画像和定向分析，建议在用户登录后，通过SDK或API同步用户标识和属性。

// 前端SDK示例：设置用户信息
FeedbackBox.identify({
  userId: '12345', // 内部用户ID
  traits: {
    name: '张三',
    email: 'zhangsan@example.com',
    department: '技术部',
    subscriptionTier: 'premium'
  }
});

# 后端API示例 (Python)
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
user_data = {
  'userId': '12345',
  'traits': {'department': '技术部'}
}
response = requests.post('https://api.feedbackbox.com/v1/users/identify', 
                         json=user_data, headers=headers)

同步后，在分析报表中即可按用户维度进行筛选和统计。

Q8: 是否支持私有化部署？

A: 是的。掌上意见箱提供企业私有化部署方案，支持部署在客户自有的服务器或云环境（如阿里云、AWS、腾讯云）中。私有化部署包包含完整的后端服务、数据库和管理前端，并提供专属的技术支持与升级服务。请联系我们的销售或技术支持团队获取详细方案。

5. 安全与合规

Q9: 数据安全如何保障？

A: 安全是我们的首要原则：

  • 传输安全：全站采用HTTPS/TLS 1.2+加密传输。
  • 数据加密：敏感数据（如用户联系信息）在数据库中进行加密存储。
  • 访问控制：严格的API访问认证（JWT Token、OAuth 2.0）和基于角色的权限控制。
  • 合规性：遵循《网络安全法》、《个人信息保护法》等相关法律法规，提供数据匿名化、删除接口等功能，协助客户满足合规要求。
  • 私有化部署：满足企业对数据物理隔离的最高安全需求。

Q10: 如何处理用户隐私和GDPR/《个保法》要求？

A: 平台设计充分考虑隐私合规：

  1. 用户知情同意：可在意见表单开头内置自定义的隐私声明和勾选框。
  2. 数据最小化：支持配置仅收集必要字段。
  3. 数据主体权利：提供API和管理界面，支持查询、导出和删除特定用户的所有意见数据。
  4. 日志与审计：记录所有数据的访问和操作日志，满足合规审计需求。 建议客户根据自身业务场景，合理配置平台功能并制定相应的用户隐私政策。

本文档内容会随产品迭代更新，请以平台最新版本为准。如需进一步的技术支持，请访问我们的开发者中心或联系技术支持团队。

404 - Document Not Found

The document you are looking for does not exist or has been moved.