DSCOM呼叫中心软件接口文档.doc

2008-11-07 Lanyears Linktimes cti接口last modified: 2008-12-26, monitor增加coach和silent模式； 2009-02-17, 增加一个取主叫附加信息的函数41及听取录音文件71； 2009-02-19, 增加59， lt_phone_putcall_to_app 2009-03-11，将原来的crm被动接口列出为第二类。-PPPP-A-RRRR-TTTTT-1-P-P-A-A-R-R-T-1-PPPP-AAAAA-RRRR-T-1-P-A-A-R-R-T-1-P-A-A-R-R-T-1-一、crm集成cti命令/* 座席类*/101. 座席登录以工号、接口、队列为参数登录座席，lt_agent_login.php?agentid=agentid&interface=inferface&queue=queue成功返回0；失败返回-1;example: 座席使用SIP/808分机，工号2001登录队列2008:32766/cti/lt_agent_login.php?agentid=2001&interface=SIP/808&queue=200102. 座席退出登录lt_agent_logoff.php&interface=interface&queue=queue成功返回0；失败返回-1;example: 8:32766/cti/lt_agent_logoff.php?interface=SIP/808&queue=200103. 获取座席状态以工号为参数获取座席状态;lt_agent_get_agent_state.php?agentid=agentid成功返回座席的状态号码；失败或座席未登录返回-1;状态号码为：-1, 未登录;0, 就绪;1, 通话中;2, 振铃;3, 整理;4, 私事暂休;5, 公事暂休;6, 外拨工作;7, 代接电话;8, 振铃超时;9, 暂休超时;10, 忙于其他队列;11, 自定义1;12, 自定义2;13, 自定义3;example: 8:32766/cti/lt_agent_get_agent_state.php?agentid=2001104. 获取座席状态以接口为参数获取座席状态;接口需要类型参数： 如果是固定座席，需要格式：Local/013801223828from-internal,其中0为外拨前缀； 如果是非固定座席，需要格式：SIP/808,其中808为SIP分机号码；lt_agent_get_interface_state.php?interface=inferfaceexample: 8:32766/cti/lt_agent_get_interface_state.php?interface=Local/013801223828from-internal105. 获取所有队列及座席状态返回的是一些字符串，需要自己整理；lt_agent_get_all_agent_state.php?example: 8:32766/cti/lt_agent_get_all_agent_state.php106. 座席状态设置以工号为参数设置座席状态，仅用于非固定座席lt_agent_set_agent_state.php?agentid=agentid&newstate=newstate成功返回设置的状态号码；失败返回-1;状态表见数据库AgentState；0, 就绪;1, 通话中;-该状态不能设置，系统来设置2, 振铃;-该状态不能设置，系统来设置3, 整理;4, 私事暂休;5, 公事暂休;6, 外拨工作;7, 代接电话;8, 振铃超时;9, 暂休超时;-该状态不能设置，系统来设置10, 忙于其他队列;-该状态不能设置，系统来设置11, 自定义1;12, 自定义2;13, 自定义3;example: 设置座席2001的状态为私事暂休，8:32766/cti/lt_agent_set_agent_state.php?agentid=2001&newstate=4;107. 接口状态设置以接口为参数设置座席状态，可以用于固定座席和非固定座席lt_agent_set_interface_state.php?interface=interface&newstate=newstate成功返回设置的状态号码；失败返回-1;非固定座席example: 8:32766/cti/lt_agent_set_interface_state.php?interface=SIP/808&newstate=4;固定座席 example: 8:32766/cti/lt_agent_set_interface_state.php?interface=Local/013800138000from-internal&newstate=4;108. 获取某个接口所对应的登录工号lt_agent_get_agentid_by_interface.php?interface=interface成功：结果在返回值中失败返回-1；example: 8:32766/cti/lt_agent_get_agentid_by_interface.php?interface=SIP/808109. 获取某个工号所登录的接口lt_agent_get_interface_by_agentid.php?agentid=agentid结果在返回值中失败返回-1；example: 8:32766/cti/lt_agent_get_interface_by_agentid.php?agentid=2001;/* 弹屏主叫号码类*/201. 取主叫号码取指定分机上的来电号码lt_phone_getcallerid.php?extension=extension成功返回主叫号码；失败返回空字符串;example: 8:32766/cti/lt_phone_getcallerid.php?extension=808202. 取主叫附加信息, 2009-2-17来电时，取指定分机上的来电号码、uniqueid, 队列, 等信息lt_phone_getcallinfo.php?extension=extension成功返回info字符串；失败返回空字符串;example: 8:32766/cti/lt_phone_getcallinfo.php?extension=808返回格式：QTime=2009-02-17 14:10:57QueueName=200AgentID=2001Extension=6807CallerIDigits=Channel=SIP/6808-b7e01fd0UniqueID=1234851051.419BillingID=02166778899/* 电话接口类*/301. 拨打电话使用分机extension来拨打外线电话destlt_phone_placecall.php?extension=extension&dest=dest成功返回0；失败返回-1;系统先呼叫extension，待摘机后再呼叫外线。example: 8:32766/cti/lt_phone_placecall.php?extension=808&dest=013800138000302. 转接电话(盲转)将座席分机extension的外线电话external转接到另外一个分机或外线dest上;lt_phone_blind_transfercall.php?external=external&extension=extension&dest=dest成功返回0；失败返回-1;example: 将自己808的外线电接到另外一个分机8098:32766/cti/lt_phone_blind_transfercall.php?externalextension=808&dest=809303. 转接电话(询转)将座席分机extension的外线电话external转接到另外一个分机或外线dest上;lt_phone_consultation_transfercall.php?external=external&extension=extension&dest=dest成功返回0；失败返回-1;example: 将自己808的外线电接到另外一个分机8098:32766/cti/lt_phone_consultation_transfercall.php?externalextension=808&dest=809304. 挂断电话挂断电话lt_phone_hangupcall.php?extension=extension成功返回0；失败返回-1;example: 8:32766/cti/lt_phone_hangupcall.php?extension=808305. 监听电话1) 班长monitor分机监听座席extension分机与外线的通话, 采用coach模式lt_phone_coach_monitorcall.php?monitor=monitor&extension=extension成功返回0；失败返回-1;example: 8:32766/cti/lt_phone_coach_monitorcall.php?monitor=809&extension=8082) 班长monitor分机监听座席extension分机与外线的通话, 采用silent模式lt_phone_silent_monitorcall.php?monitor=monitor&extension=extension成功返回0；失败返回-1;example: 8:32766/cti/lt_phone_silent_monitorcall.php?monitor=809&extension=808306. 电话驻留将分机当前通话的外线电话驻留听音乐;lt_phone_put_on_hold.php?extension=extension成功返回0；失败返回-1;example: 8:32766/cti/lt_phone_put_on_hold.php?extension=808307. 显示所有驻留电话lt_phone_list_on_hold.php返回列表example: 8:32766/cti/lt_phone_list_on_hold.php308. 将一个驻留电话拾起由extension将驻留在parkext上的电话拾起lt_phone_resume_from_hold.php?parkext=parkext&extension=extension成功返回0；失败返回-1;example: 8:32766/cti/lt_phone_resume_from_hold.php?parkext=701&extension=808309. 拨打电话，接通后转接到custom-app上。系统拨打外线电话destlt_phone_putcall_to_app.php?dest=dest&display=display&app=custom-app,s,1成功返回0；失败返回-1;系统先呼叫dest，待摘机后再转接到custom-app,s,1。example: 8:32766/cti/lt_phone_putcall_to_app.php?dest=01062416509&display=01051666383&app=custom-app,s,1/* 信息类*/401. 听取指定录音文件, 2009-2-17指定uniqueid,在ie浏览器上播放录音文件lt_info_getmonitorfile.php?uniqueid=uniqueid成功显示下载界面；失败显示无文件提示;example: 8:32766/cti/lt_info_getmonitorfile.php?uniqueid=1236640493.44402. 查找指定主被叫的最近一个uniqueid, 2009-2-17dest被叫lt_info_getlastuniqueid.php?dest=dest成功返回uniqueid；失败返回0;example: 8:32766/cti/lt_info_getlastuniqueid.php?dest=013801223828403. 保存录音文件与指定客户号码与工单号相连, 2009-3-11lt_info_saveworksheetid.php?uniqueid=uniqueid&customerid=customerid&sheetid=sheetiduniqueid为此电话的唯一表示号码。可以通过命令202或402获得。成功返回1；失败返回0;example: 8:32766/cti/lt_info_saveworksheetid.php?uniqueid=1230987.34&customerid=345&sheetid=20090311023404. 获得客户、工单号的录音文件列表及下载地址lt_info_listmonitorfiles.php?customerid=customerid&sheetid=sheetid如果未指定sheetid，则返回所有customerid对应的值。成功返回列表，格式如下：来电或去电时间(年月日 时:分:秒)|通话时长(HH:MM:SS)|主叫号码(CALLERID)|座席工号(AGENTID)|座席接电分机(EXTENSION)|录音文件唯一标识|YYYY-MM-DD HH:MM:SS|HH:MM:SS|CALLERID|AGENTID|EXTENSION|uniqueid|YYYY-MM-DD HH:MM:S