LQ-SDK服务调用技术手册V504.doc

索引与目录 适用场景 4 服务调用采取什么模式 4 使用步骤： 4 服务列表 4 服务请求数据包说明 5 取坐席状态 5 转分机 6 呼分机 6 示忙 7 示闲 7 三方通话 7 监听 8 强插 8 强拆 8 坐席挂断 8 挂断外线 9 坐席拒接 9 通话保持 9 通话恢复 9 自动外呼 10 发送DTMF 10 发送闪断 10 文本播放TTS 10 立即外转 11 安全外转 11 安全外转-接通 12 安全外转-回退 12 安全外转-会议 12 来电转流程 12 批量外呼转流程 13 查询录音文件 13 录入通话摘要 14 取呼叫流水 14 取队列状态 15 取通道状态 16 发送短信 18 查短信账号余额 18 坐席退出 18 查询号码归属地 19 重新弹屏 19 回呼 19 服务应答数据包说明 20 其它参数设置 20 交互式E-IVR如何返回给坐席端？ 20 应用举例 22 来电转入范例: 22 自动外呼范例: 22 版权声明 23 服务调用技术手册 适用场景 本文档的阅读对象是有一定开发基础的软件开发人员，而对于他们原本熟悉的开发语言则不限。 通过本文档，第三方软件开发人员可以在他们的软件界面上快速实现呼叫中心的系统控制功能。这些系统功能是指坐席主动发起的功能，比如呼叫、转分机等。 有关来电弹屏的对接不属于本文档的范围，请另参见LQ-Connect软件对接技术手册。 服务调用采取什么模式 Http协议及XML是当前最为流行的系统间通讯协议及数据交换格式，服务将以http及xml作为调用的基本模式。 松耦合：通过Http协议调用系统的呼叫中心功能，第三方的客户端软件可以松耦合地和系统进行对接，最大限度地降低因为开发平台的差异所带来的集成复杂度。 方便快捷：系统内部提供的各种服务可以由第三方软件的Http调用实现（比在页面上做一个form表单提交是最简单不过的操作了），这样呼叫中心的操作功能就集成在了第三方软件界面上，而后端复杂的呼叫中心控制则交由系统后台完成。 广泛适用：第三方的客户端软件可以是基于.net或j2ee架构的B/S方式的浏览器，也可以是C/S方式开发的VB、PB、Java、C#开发的客户端。 第三方客户端软件可使用Windows、Linux、MacOS等平台。 使用步骤： Http的调用方法：使用Post或Get方法，进行html网页模式的form表单提交即可，或使用ajax方式提交将获得更加优异的使用效果。 Http服务的URL： :7627/v/vack ，假设为服务器的IP地址。 根据服务的类型设置相应的http请求字段，每个请求的必填字段是服务号void 参见服务使用范例。 服务列表 服务名 服务号vo_id LOffice兼容 LCall兼容 转分机 transfer2Ext √ 呼分机 callauto √ 示忙 setBusyAj √ 示闲 setBusyAj √ 三方通话 talk3s √ 监听 listenlc √ 强插 breakin √ 强拆 breakout √ 通话保持 talkkeep √ 通话恢复 talkrestore √ 自动外呼 callauto √ 文本播放TTS playTTS √ 立即外转 callouterFast √ 安全外转 callouterSafe √ 安全外转-接通 callouterSafeTalk √ 安全外转-回退 callouterSafeReturn √ 安全外转-会议 callouterSafeConf? √ 来电转流程 push2flow √ 批量外呼转流程 Callusb √ 取通道状态 getChStatus √ √ 取坐席状态 getOperStatus √ √ 查询录音文件 playSelected √ √ 录入通话摘要 popModifyCustCall √ √ 取呼叫流水 getCustCall √ √ 取队列状态 getQueueStatus √ 发送DTMF senddtmf √ 发送短信 fastSMS √ √ 坐席退出 agentLogout √ √ 重新弹屏 sendPop √ √ 回呼 callback √ 备注： 以下是LOffice或LCall系列产品开放的后台服务列表，基于系统本身的功能特点，有的服务只有LCall能提供，而有的服务两者均能提供。 服务请求数据包说明 取坐席状态 服务 取坐席状态 功能说明 根据坐席的工号，取得该坐席对应的线路通道号及其它状态信息。 请求字段说明 vo_id: 设置为getOperStatus oper: 坐席工号