全部产品
云市场
云游戏

整体流程说明

更新时间:2018-09-20 16:04:07

一、进行单点登录(OAuth2)认证

在您自有业务系统中使用云呼最理想的情形是:登录自有业务系统后,自动加载软电话SDK,并达到可外呼可接听的状态,那么就需要用到单点登录,单点登录完整说明文档请看 应用注册获取访问令牌token,大致描述如下:

  • 首次签入软电话SDK,此时自有系统账号没有对应的token,那么就需要跳转到阿里云登录页面进行登录(也就是上面文档中讲得 获取授权码和获取访问令牌的步骤);
  • 阿里云账号登录后,可以拿到access_token和refresh_token,然后将refresh_token存起来,并且和自有系统账号的关系对应起来。这样以后每次登录直接用refresh_token去获取新的access_token即可。
  • refresh_token有效期最长可设置为1年,这样一年内都不需要进行阿里云账号的登录。access_token有效期最长可设置为3小时,这样3小时之内都不需要获取新的access_token。
  • 关于access_token和refresh_token有效期的说明请看 OAuth2单点登录-温馨提示

二、拿到access_token之后,进行转发软电话SDK发出的请求

在软电话SDK初始化及使用过程中,会调用多个云呼叫中心服务端的API获取数据,由于将软电话SDK嵌入进了您的自有业务系统(没有阿里云平台的登录状态),所以软电话SDK的请求只能调用我们的openAPI,调用openAPI需要access_token等很多公共参数,这些信息软电话SDK自己是无法获取的,所以需要在您自由业务系统的服务端中新增一个Controller用来接收软电话SDK发起的请求,接收到请求后,您再去调用openAPI,最终将拿到的数据回传给软电话SDK。

  • 软电话SDK初始化的config信息中,有 ajaxorigin、ajaxpath、ajaxApiParamName、apiName 四个配置项,是与您的服务端转发请求相关的,以上四个配置项,可以指明软电话SDK发出的请求,请求到哪里。
  • ajaxorigin是用户接口的域名部分,ajaxpath是用户接口域名后面的一段路径,一个完整的URL访问路径是 ${ajaxOrigin}${ajaxPath}?${ajaxApiParamName}=${apiName},比如https://ccc.aliyun.com/data/api/action=ListSkillGroupsOfUser中,https://ccc.aliyun.com/是ajaxOrigin, data/api/是ajaxPath, action是ajaxApiParamName, ListSkillGroupsOfUser是apiName
  • 软电话SDK在发起请求时,会携带一些必备的参数,这些参数您无需关心,在您转发请求时,透传出去即可。

三、转发请求后,回传给软电话SDK返回值的格式

因为软电话SDK会自动校验API的返回值是否正确,如果返回值有误,会导致无法使用。软电话SDK只识别标准JSON格式,例如下图:

四、温馨提示

  1. 强烈建议您直接参考我们提供的系统集成的demo,如果不了解java或php语言,那么可以根据 CRM demo介绍 的文档说明以及本篇文档自己开发。
  2. 系统集成相关的文档,尤其是软电话SDK文档,一定一定要完完整整仔仔细细的看,其实很多问题,文档中都有说明。
  3. 软电话SDK在调试阶段,一定要引入非压缩版的JS文件,这样浏览器控制台会有很多错误提示,一定要仔细看。