跳到主要内容

账号、界面打通方案

简介​

企业内部系统或平台类产品在使用腾讯问卷时，往往关注账号体系及组织架构如何打通、怎样从其他平台免登录进入腾讯问卷。
该文档为您提供深度对接腾讯问卷的解决方案，通过嵌套或者跳转的形式，结合开放接口，使腾讯问卷与您的系统紧密关联。

目标​

  • 将第三方账号同步到腾讯问卷
  • 实现第三方系统跳转到腾讯问卷，无缝连接

方案示意​

方案示意

场景一：企业内部系统集成腾讯问卷（尊享版接入）​

效果​

企业内部系统可以是社区、HR门户、IM工具等，已有一套用户体系和组织架构，可以实现：

  • 组织架构和账号打通，登录企业内部账号后，无需再次使用QQ/微信等账号登录，即可直接使用腾讯问卷
  • 企业内多人协同管理问卷的编辑、发放和数据统计，或是按照组织架构进行分级管理问卷资产
  • 进行内部调查问卷的集中投放、限定填答人范围、或者内部360互评
  • 企业成员离职后无法再用企业账号登录腾讯问卷，保障数据安全

接入流程​

场景二：服务平台集成腾讯问卷（服务商合作）​

效果​

服务平台可以是 ToC 的社区、效率工具，也可以是 ToB 的营销平台、采购系统等，对不同的组织或个人提供服务，可以实现：

  • 将腾讯问卷作为一个工具嵌入到您的平台中
  • 用户登录您的平台后，无需再次使用QQ/微信等账号登录，即可直接使用腾讯问卷
  • 结合Webhook可以实现数据及时回推到第三方平台，并携带原有系统的用户标识，实现功能联动和数据闭环
  • 如果您的平台服务于多个企业，也可以实现服务商代开发的方式，为企业提供腾讯问卷的集成服务

接入流程​

  • [必须] 获取接口使用凭证（平台级别），请联系客服沟通您的平台需求，达成合作意向后，我们将为您提供专属的 AppID 和 Secret
  • [必须] 使用 AppID 和 Secret 获取 access_token 接口授权
  • [必须] 使用 access_token 为平台用户注册一个腾讯问卷账号
  • [必须] 使用 access_token 为当前账号创建一个团队空间
  • [必须] 使用 access_token 为当前账号获取一次性登录码
  • [必须] 使用一次性登录码跳转或者嵌套，进入腾讯问卷工作台或问卷填答页 统一入口
  • [可选] 如果忘记了问卷侧 user_id，请通过 获取第三方用户信息 接口查询

授权流程​

授权流程

代码示例​

index.html

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="utf-8">
    <title>嵌入demo</title>
</head>
<body>
<h1>下方 iframe 嵌入了带登录态的问卷编辑页</h1>
<div>
<iframe src="./redirect.php" allowfullscreen="allowfullscreen" sandbox="allow-same-origin allow-scripts" width="2000" height="1000"></iframe>
</div>
</body>
</html>

redirect.php

<?php

class redirection
{
    private $_appid;
    private $_access_token;

    public function __construct($appid, $access_token)
    {
        $this->_appid = $appid;
        $this->_access_token = $access_token;
    }

    /**
     * 请求腾讯问卷开放接口
     * @param $method
     * @param $url
     * @param $data
     * @return mixed
     */
    private function openapi_request($method, $url, $data)
    {
        $params = [
            "appid" => $this->_appid,
            "access_token" => $this->_access_token,
        ];

        if ($method == "GET" && !empty($data)) {
            $params = array_merge($params, $data);
            $data = null;
        }

        // 拼装请求参数
        $params_string = urldecode(http_build_query($params));
        $api = "https://" . $url . "?" . $params_string;
        $headers = ['Content-Type:application/json', 'Accept:application/json'];

        try {
            // 发起请求
            $ch = curl_init();
            curl_setopt($ch, CURLOPT_URL, $api);
            curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
            if ($method == "POST") {
                curl_setopt($ch, CURLOPT_POST, 1);
                curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
            }
            $output = curl_exec($ch);
            curl_close($ch);
        } catch (Exception $e) {
            return false;
        }

        // 结果处理
        $result = json_decode($output, true);
        if ($result['code'] != "OK") {
            die($result['error']['type']);
        }
        return $result["data"];
    }

    /**
     * @param $openid string 第三方唯一用户标识
     * @return int 问卷侧 user_id
     */
    /**
     * @param $openid
     * @param $nickname
     * @param $avatar
     * @return mixed
     */
    function create_user($openid, $nickname, $avatar)
    {
        $method = "POST";
        $url = "open.wesurvey.com/api/sso/users";
        $data = [
            'openid' => $openid,
            'nickname' => $nickname,
            'avatar' => $avatar,
        ];

        $response = $this->openapi_request($method, $url, $data);
        return $response['user_id'];
    }

    /**
     * @param $user_id
     * @return mixed
     */
    function get_login_code($user_id)
    {
        $method = "POST";
        $url = "open.wesurvey.com/api/sso/code";
        $data = [
            'user_id' => $user_id,
        ];

        $response = $this->openapi_request($method, $url, $data);
        return $response['code'];
    }
}

// 1. 申请 appid 及 secret
// 2. 使用 appid 及 secret 换取 access_token，填充至此处
$appid = "";
$access_token = "";

$openid = ""; // 填写接入方唯一用户标识
$nickname = ""; // 填写接入用户昵称
$avatar = ""; // 填写接入用户头像

$ins = new redirection($appid, $access_token);
// 3. 请求腾讯问卷开放接口创建用户
$user_id = $ins->create_user($openid, $nickname, $avatar);
// 4. 请求腾讯问卷开放接口获取一次性登录码
$code = $ins->get_login_code($user_id);

// 5. 带着 appid + code 跳转到腾讯问卷页面
$action = trim($_GET['action']);
switch ($action) {
    case 'survey_create':
        // 重定向到腾讯问卷创建页面
        $url = "https://wesurvey.com/api/v2/redirect?appid={$appid}&code={$code}&action={$action}";
        break;
    case 'survey_collect':
        // 重定向到腾讯问卷填答页面
        $survey_id = 0; // 从问卷投放链接获得
        $survey_hash = "abcd";
        $url = "https://wesurvey.com/api/v2/redirect?appid={$appid}&code={$code}&action={$action}&survey_id={$survey_id}&survey_hash={$survey_hash}";
        break;
    default:
        echo "unknown action";
        exit();
}
header('Location: ' . $url);