国信呼叫中心电话客服系统
接口说明书 V1.1
国信计算机科技
2012/10/08
国信科技以“技术创新”为产品设计理念，以现代化的管理方式，不断追求技术进步、服务创新，是专业的呼叫中心电话客服系统提供商,采用先进的SIP 软交换技术，为大中小微型企业机构量身定制呼叫中心解决方案，开启企业级互联网语音应用新时代。
公司名称：深圳市国信计算机科技有限公司
公司网址：/
服务邮箱：support@
Tel/Fax ：+86-755-28529359
客服QQ ：1258045866
客服QQ ：1258053566
一、国信呼叫中心电话IVR交互接口
电话IVR交互开放接口用于支持呼叫中心与用第三方系统的对接。
让没有IVR语音交互能力的第三方系统也能通过电话与客户交互。
典型应用场景为：电话下单，电话防伪验证，优惠卡消费，电话自助查询等
注：由国信先行根据您的需求写出电话语音交互流程配置文件，文件格式是XML的，协助对接调试成功，后续客户可自行开发和维护。
二次拨号交互HTTP请求接口定义如下：
呼叫中心使用HTTP协议提交客户输入的数字串到对接的系统。
此接口要求用户自研的系统具有http get请求的处理能力。
二次拨号交互HTTP响应定义如下：
第三方系统http响应返回任意字符串。
可自行定义字符串的意义，例如：200:成功 400: 失败。
呼叫中心根据配置文件结合响应自动选择下一步处理方式，处理方式包括：
转话给某个客服分机
继续放音收号
挂机。
使用示例，如图1-1所示
1、使用电话对卡号或序列号验证和提交接口示例：
http://x.x.x.x/srvlt1? id=xxx&caller=xxx&cardnum=xxx
响应为纯字符串：
“200”：提交成功，播放购买提示音
“202”：提交成功，可继续输入卡号
“404”：卡无效，可继续输入
“500”：系统错误，挂机
可以继续自定义返回值,系统可以根据每个返回值，播放对应的提示音，进行后续处理。
2、电话订购货物的接口示例：
http://x.x.x.x/srvlt2? id=xxx&caller=xxx&buycount=xxx
响应为纯字符串：
“200”：提交成功，播放购买提示音后挂机
“403”：无权购买，例如当前号码在黑名单中等
“404”：缺货，挂机
可以继续自定义返回值,系统可以根据每个返回值，播放对应的提示音，然后进行后续处理。
3、电话查询余额的接口示例：
http://x.x.x.x/srvlt2? id=xxx&caller=xxx&userid=xxx
响应为字符串：
189.12 ：你的余额为一百八十九元一角二分
NOT_FOUND: 用户不存在
OUT_TIME: 用户已过期
可以继续自定义返回值,系统可以根据每个返回值，播放对应的提示音，然后进行后续处理。
3、销售系统处理方式
如图1-1，根据http消息的id参数,关联出历次提及的信息，生成订单。
图 1-1 呼叫中心IVR与销售系统交互示例
二、国信呼叫中心HTTP来电通知接口定义
用于对接客户现有CRM和OA系统，使得CRM和OA具有来电弹屏功能
图 2-1 呼叫状态通知配置
三、国信呼叫中心WebService-SOAP第三方呼叫控制外呼接口1．WSDL获取方式，x.x.x.x 是电话服务器的IP地址
http://x.x.x.x:12121/bridge/services/CallSoapControl?wsdl
2．根据WSDL生成SOAP的客户端代码即可进行第三方呼叫控制
3．接口说明
3.1 点击呼叫接口，可用于批量外呼。
public void click2call(final String caller, final String callee) 3.2 点击挂机的接口
public void click2hungup(final String caller, final String callee)
3.3 点击呼叫状态查询接口
表 2-3 呼叫状态查询接口
public int state4click(final String caller, final String callee)
四、IP电话点击呼叫接口
1．WSDL获取方式，x.x.x.x 是电话服务器的IP地址
http://127.0.0.1:12121/bridge/services/Click2CallControl?wsdl
2．根据WSDL生成SOAP的客户端代码即可进行IP电话的点击呼叫
3．接口说明
3.1 IP电话点击呼叫接口。
public String click2ipcall(final String extnum, final String callee) 3.2 点击挂机的接口
public void click2hungup(final String clickCallId)
3.3 点击呼叫状态查询接口
表 2-3 呼叫状态查询接口
public int state4click(final String caller, final String callee)
3.4 获取当次点击呼叫的呼叫日志
3.4.1 使用下面WSDL生成日志查询接口客户端代码
http://127.0.0.1:12121/bridge/services/CallRecordHome?wsdl
3.4.2 当次点击呼叫日志查询方法说明
public Calllog[] listCallog(final Integer first, final Integer maxResults, final String whereCondition, final String orderby)注意：呼叫日志在接通后生成，挂机10秒后才能下载录音
四、国信呼叫中心WebService-SOAP呼叫日志查询接口
1.WSDL获取方式，x.x.x.x 是电话服务器的IP地址
http://127.0.0.1:12121/bridge/services/CallRecordHome?wsdl http://127.0.0.1:12121/bridge/services/CallLogDataService?wsdl 2．根据WSDL生成SOAP的客户端代码即可查询呼叫日志，下载录音
3．接口说明
3.1 呼叫日志查询接口。
public Calllog[] listCallog(final String beginDate, final String endDate, final String telnum)
public byte[] downloadVoice(final String filepath)
四、短信接口
1.WSDL获取方式，x.x.x.x 是电话服务器的IP地址
http://127.0.0.1:12121/bridge/services/ClientSmsHome?wsdl
2．根据WSDL生成SOAP的客户端代码即可调用发送短信
3．接口说明
3.1 短信发送接口关键方法说明。
public int send(final ClientSms sms)
3.1 短信发送接口关键方法说明。
表 4-1 短信发送结果查询接口listWithUserId方法的定义
public ClientSms[] listWithUserId(final int firstIndex, final int maxResults, final int userId)
4. 如何获取发送者编号(sender)
四、HTTP点击呼叫接口
1. 该接口用于通过网页点击一个电话号码发起呼叫
2. 固定线路点击呼叫接口
http://127.0.0.1:12121/bridge/callctrl?caller=801&callee=179575&autht
ype=no&opt=CLICK_TO_DIAL
3. IP 电话点击呼叫接口： http://127.0.0.1:12121/bridge/callctrl?caller=802&callee=1274631386633&authtype=no&opt=CLICK_TO_IP_DIAL
4. 参数说明
实现效果如图：
电话系统服务器 弹屏助手。