1. SDK介绍

1.1 概述

呼叫中心SDK基于CallCenterService(CCS)，开发语言采用JavaScript，浏览器需支持WebSocket。SDK通过websocket连接CCS(server)，与CCS的消息交互修改坐席状态及通话事件监听回调

基本通话流程时序图：

1.2 快速入门

线上Demo访问地址：https://cc.yuntongxun.com/ccc/public/cc_sdk/demo.html

本地解压ccsdk压缩包，浏览器访问根目录demo.html文件

填写以下部分参数即可登录坐席开始通话

参数名	是否必填	描述
Url_3CS	是	接口服务器地址，默认为访问域名+”/3cs”; 例：https://cc.yuntongxun.com/3cs
company_id	是	企业ID；可在Admin端，服务配置-企业配置-企业列表查看获取company_id
选择登录类型	是	默认为”工号方式”
operator_id	是	坐席工号，例：10000（不带企业缩写）
password	是	坐席密码，md5加密32位小写，例123456=>e10adc3949ba59abbe56e057f20f883e
登录类型	是	默认选择”WebCall/WebRtc 软话机” SIP话机：硬话机登录
是否预测外呼	是	默认：”否”
客户端话机类型	是	默认：”Webcall” 线上webcall软件下载地址 => https://cc.yuntongxun.com/ccc/public/cc_sdk/WebCall.4.0.1.20.exe 本地解压ccsdk压缩包，根目录直接获取安装包WebCall.4.0.1.20.exe WebRTC：不需要安装Webcall插件
服务端类型	是	默认：”CCS”
sip_id	否	默认：空
插件签入帐号	否	默认：空
注：以上参数如有不知如何获取方式，请联系项目经理或实施、客服人员获取

1.2.1 基本参数查看说明

1、企业ID（company_id）

可在Admin端，服务配置-企业配置-企业列表查看获取company_id

2、创建坐席步骤：

1).系统配置—SIP组—SIP管理创建SIP；

2).服务配置—坐席—坐席管理创建坐席绑定SIP；

3).服务配置—职场技能组—技能配置创建技能绑定坐席；

4).服务配置—职场技能组—技能组创建技能组绑定技能；

1.2.2 demo操作步骤

1、完整填写1.2参数；

2、点击登录按钮，即可登陆成功：

3、发起外呼：

4、外呼成功通话中状态：

1.3 快速集成

1、创建HTML文件，加载依赖包

jquery-1.7.2.min.js-------------------必须引入

language.js---------------------------必须引入

janus/adapter-latest.js-------------- 必须引入

janus/janus.js------------------------ 必须引入

CallCenter.js------------------------- 必须引入

CallTransaction.js------------------- 使用通话事务部分引入

plugins/PluginCore.js--------------- 使用插件部分引入

plugins/PreviewTask.js------------- 使用插件部分引入

2、登录：

CallCenter.opLogin(工号,密码,企业ID,2,0,””,”接口服务器地址/url_3CS”,1);

例：CallCenter.opLogin("1001","e10adc394******e057f20f883e",300,2,0,"","https://cc.yuntongxun.com/3cs",1);

WebRTC方式登录，必须添加语音标签

<audio id="localVideo" autoplay></audio>
<audio id="remoteVideo" autoplay></audio>
<audio id="ringingVideo" loop src="./plugins/beep.wav"></audio>
<audio id="ringingBackVideo" src="./plugins/CalledHangup.wav"></audio>

4、登出

CallCenter.logout();

回调监听：

CallCenter.opLogin_callback = function(json){}

1.4 代码示例

快速集成SDK代码示例

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
  <script src="janus/adapter-latest.js"></script>
  <script src="CallCenter.js"></script>
  <script>
    function login() {
      CallCenter.opLogin(
        "10000", // 坐席工号
        "96e79218********dd5a330112", // 坐席密码，MD5加密32位小写
        "300", // 企业ID
        "2", // 登录方式 "0"手机, "1"硬话机, "2"软话机（webcall&webrtc）
        "0", // 是否智能外呼，0否，1是
        "", // 默认为空，技能组id
        "https://177183.acloudcc.com/3cs", // 服务地址 默认为访问域名 + "/3cs"
        "1" // 软话机类型 "1" webcall，"2" webrtc
      )
    }
    function callout() {
      CallCenter.callout("156****4530")
    }
  </script>
</head>
<body>
<div id="app" style="width: 200%;height: 100px;display: inline-block"></div>
<button onclick="login()">登录</button>
<button onclick="callout()">外呼</button>
<audio id="localVideo" autoplay></audio>
<audio id="remoteVideo" autoplay></audio>
<audio id="ringingVideo" loop src="./plugins/beep.wav"></audio>
<audio id="ringingBackVideo" src="./plugins/CalledHangup.wav"></audio>
</body>
</html>

1.4.1 Webcall登录

CallCenter.opLogin(
  "10000", // 坐席工号
  "96e79218********dd5a330112", // 坐席密码，MD5加密32位小写
  "300", // 企业ID
  "2", // 登录方式 "0"手机, "1"硬话机, "2"软话机（webcall&webrtc）
  "0", // 是否智能外呼，0否，1是
  "", // 默认为空，技能组id
  "https://177183.acloudcc.com/3cs", // 服务地址 默认为访问域名 + "/3cs"
  "1" // 软话机类型 "1" webcall，"2" webrtc
)

1.4.2 WebRTC登录

CallCenter.opLogin(
  "10000", // 坐席工号
  "96e79218********dd5a330112", // 坐席密码，MD5加密32位小写
  "300", // 企业ID
  "2", // 登录方式 "0"手机, "1"硬话机, "2"软话机（webcall&webrtc）
  "0", // 是否智能外呼，0否，1是
  "", // 默认为空，技能组id
  "https://177183.acloudcc.com/3cs", // 服务地址 默认为访问域名 + "/3cs"
  "2" // 软话机类型 "1" webcall，"2" webrtc
)

1.4.3手机登录

CallCenter.opLogin(
  "10000", // 坐席工号
  "96e79218********dd5a330112", // 坐席密码，MD5加密32位小写
  "300", // 企业ID
  "0", // 登录方式 "0"手机, "1"硬话机, "2"软话机（webcall&webrtc）
  "0", // 是否智能外呼，0否，1是
  "", // 默认为空，技能组id
  "https://177183.acloudcc.com/3cs", // 服务地址 默认为访问域名 + "/3cs"
  "" // 软话机类型 "1" webcall，"2" webrtc
)

1.4.4硬话机登录

CallCenter.opLogin(
  "10000", // 坐席工号
  "96e79218********dd5a330112", // 坐席密码，MD5加密32位小写
  "300", // 企业ID
  "1", // 登录方式 "0"手机, "1"硬话机, "2"软话机（webcall&webrtc）
  "0", // 是否智能外呼，0否，1是
  "", // 默认为空，技能组id
  "https://177183.acloudcc.com/3cs", // 服务地址 默认为访问域名 + "/3cs"
  "" // 软话机类型 "1" webcall，"2" webrtc
)