中国电信新一代呼叫中心(NGCC)接口规范(暂行版)A接口修订内容(0907)

中国电信新一代呼叫中心（NGCC）接口规范（暂行版）

A接口修订内容

中国电信集团公司

二零零七年八月

原规范中删除的内容

删除方法QueryCallStatisticsInfo（查询当日话务量）；

原规范中修改的内容

1．接口中所有CallID参数的长度改为64位。各接入平台厂家应保证忙时呼叫量在50CAPS 时至少一年之内CallID不得重复。

2．接口规范中所有“业务类型”用“技能组”代替。

3．基本属性AgentType定义改为：

原规范只定义了0（IP 座席），现增加了值1，表示1B+D座席类型；值2，表示PC+Phone 座席类型；值3，表示用户线类型。

4．基本属性ServiceLists (座席签入CTI平台时能处理的技能，可以为ID组合或者名称组合)由基本属性改为状态属性，长度从原来的512改为无限制。座席登录后具有后台配置好的ServiceLists中所有技能，临时修改可以通过调用ResetSkill方法，永久修改可以通过后台修改技能。

5．在OnRequestRelease、OnReleaseSuccess事件中增加CallID参数。

6．Alternate（切换呼叫）方法改为：function Alternate (CallID: Integer): Integer；

参数CallID为要建立通话一方的CallID。删除原规范的另外三个参数。7．Consultation（咨询）方法改为

function Consultation (MediaType, ConsultNum:String, ConsultType:

Integer,ConsultTag:Integer，CallingNum：String): Integer;

【参数说明】

增加并修改了参数ConsultType（咨询类别）的值；增加可选参数CallingNum（主叫号码）。

本规范中，凡未特定标注为“远端咨询”字样的地方，咨询含义均为“本地咨询”模式。

8、方法SingleStepTransfer改为：

【函数说明】

function SingleStepTransfer (MediaType: Integer; TransferID: String;

TransferType: Integer; CallingNum:String): Integer;

【参数说明】

增加可选参数CallingNum（主叫号码）。

9、方法Conference（三方通话）的功能改为：座席把一个被保持呼叫加入到当前正在通话

的呼叫中，形成三方通话；或者座席在咨询后发起三方会议。

10、方法ReleaseCallByCallID（根据呼叫标识释放）功能描述改为：

【功能】

根据呼叫标识释放。Consultaion后可以调用此方法返回到和用户的通话。

增加功能描述，明确ReleaseCallByCallID可用于Consultaion后返回到和被保持用户的通话。

11、事件OnBeginRecordSuccess（开始录音成功）增加带回参数：Recordfilename，录音文

件的绝对路径（包括文件名），String型。

【触发条件】

座席调用BeginRecord 方法成功后，或全程录音启动成功后，CTI 需向座席上报此事

件。

12、事件OnStopRecordSuccess （停止录音成功）触发条件改为： 【触发条件】

调用StopRecord 方法成功时，触发此事件。录音开始后，若未调用StopRecord 方法但是挂机，也触发此事件。

用户挂机导致全程录音结束成功后，CTI 亦应向座席上报此事件。 增加了录音时挂机情况下的触发条件。

13、 对方法StopRecord 进行修改，增加2个参数，修改为function StopRecord(MediaType:

Integer ；AgentID:String): Integer; 【参数说明】

原规范中增加的内容

1． 增加基本属性CardType ：APC 卡类型，参数类型为：Integer ，0：CQ01；1：CQ05；2：

CQ06；、3：CQ04（缺省值）

。 2． 增加基本属性InitialReady ，定义为：

3． 增加方法QueryQueueWaitNum （分类查询呼叫等待数） 【功能】

按技能或者座席查询最大等待数、最长等待时长。

【函数说明】

function QueryQueueWaitNum (IDtype: Integer; QueueID: String;):

String;

【参数说明】

【返回值】

空：表示没有查询到；

非空格式：技能号:当前最大等待数:最长等待时长|技能号:当前最大等待数:最长等待时长。

4．增加方法QueryAgentStatus（查询座席状态）

【功能】

获取某个座席或某个技能组中登陆的座席总数、每个座席的工号、姓名和绑定的

DN或IP

【函数说明】

function QueryAgentStatus (IDtype: Integer ；QueueID: String；):

String;

【参数说明】

【返回值】

返回结果为空，表示没有查询到；

返回结果非空格式：agentId:DN:IP:状态| agentId:DN:IP:状态（在返回结果中，要求

DN、IP需至少返回其一。例如，IB+D座席可仅返回IP，DN为空）

5．增加事件OnAgentEnterIdleSuccess（退出后续处理态成功）、OnAgentEnterIdleFailuer（退