使用接口导入团队成员
#
概述本文档介绍如何使用接口导入/同步团队成员,适用于
从腾讯问卷官网创建的团队,不适用于
企业微信、腾讯乐享等平台安装的腾讯问卷应用。
#
适用场景- 使用方已经有内部 IT 系统,希望成员登录完内部系统后,无缝进入腾讯问卷,不需要二次登录
- 使用方已经有一套组织架构,希望在腾讯问卷内保持一致
#
方案细节#
准备工作- 通过官网创建团队 (工作台-创建团队)
- 了解团队内成员的角色权限、数量限制等,按需升级高级版 https://wj.qq.com/buy.html
- 获取开放接口权限 https://wj.qq.com/docs/openapi/instructions
#
调用流程- 调用接口注册第三方账号,传入 openid 用于关联你的内部系统,获得问卷系统生成的账号 id
- 调用接口获取团队ID,用于后续将账号加入团队
- 调用接口创建分组,用于后续将账号进行分组,如果不需要,也可以将账号全部放在根目录
- 调用接口加入团队/分组,在管理员数量有余量时,账号的角色为
问卷管理员
;数量不足时将自动降级为普通成员
,不能进行问卷的创建和管理 - 调用接口修改成员角色,按需将部分账号设置为
团队管理员
、问卷管理员
或普通成员
- 调用接口获取一次性登录码,用于账号的静默登录,登录的时机由使用方控制,请保证用户在你的内部系统已经登录过,防止数据泄露或越权
- 构造链接带上一次性登录码,引导用户进入链接,此时用户已经在问卷内静默登录成功,可以在自行切换页面
#
补充说明调用流程第 7 步可以是浏览器直接跳转,也可以是 iframe 中嵌入(iframe 仅建议在 PC 端使用,在微信或者无痕模式下使用可能会出现登录失败) 方案细节