Skip to main content
Version: latest

使用接口导入团队成员

重要提示

该功能为 尊享版 付费功能,如未升级,请先 升级 后再使用

概述#

本文档介绍如何使用接口导入/同步团队成员,适用于从腾讯问卷官网创建的团队,不适用于企业微信、腾讯乐享等平台安装的腾讯问卷应用。

适用场景#

  • 使用方已经有内部 IT 系统,希望成员登录完内部系统后,无缝进入腾讯问卷,不需要二次登录
  • 使用方已经有一套组织架构,希望在腾讯问卷内保持一致

方案细节#

准备工作#

  1. 通过官网创建团队 (工作台-创建团队
  2. 了解团队内成员的角色权限、数量限制等,按需升级高级版 https://wj.qq.com/buy.html
  3. 获取开放接口权限 https://wj.qq.com/docs/openapi/instructions

调用流程#

  1. 调用接口注册第三方账号,传入 openid 用于关联你的内部系统,获得问卷系统生成的账号 id
  2. 调用接口获取团队ID,用于后续将账号加入团队
  3. 调用接口创建分组,用于后续将账号进行分组,如果不需要,也可以将账号全部放在根目录
  4. 调用接口加入团队/分组,在管理员数量有余量时,账号的角色为问卷管理员;数量不足时将自动降级为普通成员,不能进行问卷的创建和管理
  5. 调用接口修改成员角色,按需将部分账号设置为团队管理员问卷管理员普通成员
  6. 调用接口获取一次性登录码,用于账号的静默登录,登录的时机由使用方控制,请保证用户在你的内部系统已经登录过,防止数据泄露或越权
  7. 构造链接带上一次性登录码,引导用户进入链接,此时用户已经在问卷内静默登录成功,可以在自行切换页面

补充说明#

调用流程第 7 步可以是浏览器直接跳转,也可以是 iframe 中嵌入(iframe 仅建议在 PC 端使用,在微信或者无痕模式下使用可能会出现登录失败) 方案细节