开发获取身份认证结果功能

背景信息

坐席工作台集成身份认证功能，在业务代表为客户查询或办理某些特定业务时，需要获取客户的身份验证授权，才可进行下一步操作。

身份验证的典型业务流程如图1所示。

业务代表接入客户电话后在音视频工作台对客户发起身份验证流程，身份验证流程由用户配置的IVR流程决定。IVR流程中需要配置用户用于身份验证的第三方接口，该接口根据随路数据中传递的参数以及用户的输入信息进行身份验证，并且返回认证结果给音视频工作台。可以根据返回的认证结果决定业务代表是否拥有为客户查询或者办理某些特定业务的操作权限。

图1 业务流程

一个简单的典型的身份认证配置的IVR流程内容如图2所示。

图2 IVR流程图

前提条件

1. 角色拥有身份认证权限

   新租户的租户管理员默认拥有该权限，老租户需使用升级脚本进行升级，升级后的租户管理员也拥有该权限。拥有该权限的租户管理员可赋予该权限给其他角色。

2. 角色拥有身份认证配置权限

   新租户的租户管理员默认拥有该权限，老租户需使用升级脚本进行升级，升级后的租户管理员也拥有该权限。

3. 角色拥有身份认证记录查询权限

   新租户的租户管理员默认拥有该权限，老租户需使用升级脚本进行升级，升级后租间管理员也拥有该权限。有身份认证记录查看权限的租间管理员默认有可查看租间所有的身份认证记录的权限，拥有该权限的租户管理员可赋予该权限给其他角色。

4. 有开启的身份认证配置

身份认证功能配置步骤

1. 流程管理页面中配置好身份验证流程要使用的IVR流程。
   图3 IVR流程
   

2. 新增身份认证流程，在验证流程配置中选择对应的IVR流程。
   图4 身份认证流程
   

3. 启用身份认证流程。
   图5 启用身份认证流程
   

4. 音视频工作台展示可进行身份认证。
   图6 音视频工作台
   

5. 身份认证记录查询。
   图7 身份认证记录
   

二次开发接口

IVR流程传递给三方接口的body参数内容：

{
"calldata":{ // 随路数据
"verifyServiceNo":"88880011", // 身份认证受理号码
"verifyWorkNo":"371" // 身份认证座席工号
}
}

三方接口需返回的body参数内容：

calldata:{ // 随路数据
"data":{
"verifyResult":0, // 身份认证结果：0：未返回 1：通过，2：失败，3：异常
"verifyReturn1":"", // 身份认证返回数据1
"verifyReturn2":"",// 身份认证返回数据2
"verifyReturn3:"","" // 身份认证返回数据3
}
}

企业开发人员基于JS OpenAPI开发企业业务系统页面用于集成到AICC座席工作台，可通过接口获取认证结果。

AICCSupport.getVerifyResult(verifyTypeCode)

结果返回对象格式：

{
"verifyResult":0, // 身份认证结果：0：未返回 1：验证通过，2：验证失败，3：验证异常
}

获取身份认证方式的认证结果

AICCSupport.getVerifyResult(verifyTypeCode);

verifyTypeCode是getVerifyResult方法的参数“身份认证方式编码”，用于指定要获取身份验证结果的身份认证方式。