本文导读

展开导读

文档首页/ 云客服/ 运营管理——座席工作台集成第三方Web页面/ 场景三：通过URL地址集成（增加页面JS调用）/ 集成开发/ 开发获取身份认证结果功能

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

更新时间：2023-10-11 GMT+08:00

背景信息

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

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

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

图1 业务流程

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

图2 IVR流程图

前提条件

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

身份认证功能配置步骤

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

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

图4 身份认证流程
启用身份认证流程。

图5 启用身份认证流程
音视频工作台展示可进行身份认证。

图6 音视频工作台
身份认证记录查询。

图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方法的参数“身份认证方式编码”，用于指定要获取身份验证结果的身份认证方式。

表1 getVerifyResult输入参数说明
参数名	参数类型	参数解释	是否必填	说明
verifyTypeCode	string	身份认证方式编码	是	只可以允许字母、数字和下划线

表2 getVerifyResult输出参数说明
参数名	参数类型	参数解释	是否必填	说明
verifyResult	string	身份认证结果	是	枚举值。 0：未返回 1：通过 2：失败 3：异常空字符串表示身份认证方式编码不合法

父主题： 集成开发

上一篇：开发一键外呼功能

下一篇：开发样例

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消