中国电信新一代呼叫中心(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（退出后续处理态失败）和OnAgentEnterWrapUpSuccess（进入后续处理态成功）、OnAgentEnterWrapUpFailuer（进入后续处理态失败）6．增加事件OnCallInsideSuccTalk（内部呼叫通话），和事件OnCallOutsideSuccTalk类似。

7、增加PalyRecord方法，为窄带质检席提供放音功能。

function PlayRecord( RecordFileName:String；AgentID:String): Integer;【参数说明】8、增加BeginPlay方法，解决窄带质检员的监听与听录音播放功能需求【功能】：对指定的录音文件进行放音。

【预置条件】：调用Initial初始化。

调用SignIn签入。

【函数声明】：function BeginPlay（FileName: WideString）: Integer;【参数说明】：【返回值】：返回值为0表示放音请求已成功发往排队机，其它值表示请求失败。

【函数说明】：放音为异步非阻塞方式实现，因此不能根据函数返回值来判断放音动作是否被正确实现。

放音成功将触发OnPlaySuccess事件，放音失败触发OnPlayFailure事件。

座席在请求应答和通话过程中不能放音。

9、增加StopPlay方法，【功能】：座席停止放音。

【预置条件】：调用Initial方法初始化。

调用SignIn签入。

调用BeginPlay放音。

【函数声明】：function StopPlay: Integer;【返回值】：返回值为0表示停止放音成功，其它值表示失败。

【函数说明】：如果当前不是放音状态，也不是暂停状态，则调用此方法将失败。

停止放音成功时触发OnStopPlaySuccess事件，失败时触发OnStopPlayFailure事件。

10、增加OnPlaySuccess（放音成功），OnPlayFailure（放音失败）事件。

调用BeginPlay方法成功，并且放音动作正确执行，则触发OnPlaySuccess（放音成功）。

调用BeginPlay方法失败，或者调用BeginPlay方法成功，但放音动作执行失败，则触发OnPlayFailure（放音失败）。

11、增加OnEndPlay（放音结束）事件，当放音到文件末尾时，自动停止放音，触发OnEndPlay 事件。

此时RecordStatus=None。

12、增加OnStopPlaySuccess（停止放音成功），OnStopPlayFailure（停止放音失败）事件。

调用StopPlay方法成功时，触发OnStopPlaySuccess（停止放音成功）。

调用StopPlay方法失败时，触发OnStopPlayFailure（停止放音失败）。

13、增加A接口座席状态转移图：座席状态编号，0：AgentNull，1：AgentNotReady，2：AgentReady，3：AgentBusy，4：AgentWorkingAfterCall。

说明：（1）当座席处于状态0时，如果基本属性InitialReady设为“True”，则登录后进入AgentReady状态，可以接听电话。

如果InitialReady设为“False”，则登录后进入AgentNotReady状态，不可以接听电话。

（2）当座席处于状态3时，如果SetAgentAutoEnterIdle设为“True”，则座席从状态3进入到状态2，可以接听电话。

如果SetAgentAutoEnterIdle设为“False”，则座席从状态3进入到状态4，不可以接听电话。

（3）休息状态可以归入到状态1。

（4）各状态调用事件失败，状态为当前状态不变。

14、增加GetAccessNo（取业务接入码）【功能】：座席用此方法取用户拨打的业务接入码，呼叫应答前后都可以调用。

【函数说明】：function GetAccessNo: String；【参数说明】：无【返回值】：返回值为用户拨打的业务接入码（如118114、114等）。