| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| id_zh:二次开发者指南:接口开发手册_v2.0:通话实时事件获取 [2014/03/16 16:39] – solo | id_zh:二次开发者指南:接口开发手册_v2.0:通话实时事件获取 [2014/03/16 17:00] (current) – removed solo |
|---|
| ====== 通话实时事件获取 ====== | |
| |
| ===== 例子 ===== | |
| |
| 可参考页面代码 | |
| <code>http://$(ipaddress):$(port)/asterccinterface/astercc_nginx_http_push.html</code> | |
| |
| <note tip>如果要接受整个团队的所有事件,须在团队高级设置中填写“业务接口地址”=>127.0.0.1, | |
| 登录服务器执行命令 | |
| /etc/init.d/asterccd restart</note> | |
| |
| |
| 第一步：第三方页面引用asterCC安装服务器上的js文件 | |
| <script src=”””””””http://$(ipaddress):$(port)/asterccinterface/astercc_nginx_http_push.js “></script> | |
| 引用文件说明： | |
| 该文件用于实时获取asterCC端的通话事件 | |
| 第二步：第三方页面创建JS函数sonAccept(message) | |
| function sonAccept(message) { | |
| |
| } | |
| 创建函数说明： | |
| 该函数用于接收实时的asterCC通话事件； | |
| sonAccept：函数名，固定写法； | |
| message：事件内容，字符串类型； | |
| message内容示例： | |
| message=“calleridnum=041139735857&didnumber=8008008&activenum=041139735855&source=AGENT&event=ringing&uniqueid=78969&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:21:58&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=Local/015967121144@hosted-dialout-408a;1&from=dialout&”; | |
| |
| 推荐解析message事件字符串的方法： | |
| var aryMessage = message.split('&'); | |
| var aryEvent = new Array(); | |
| for(i=0;i<aryMessage.length;i++) { | |
| var tmp = aryMessage[i].split('='); | |
| eval("aryEvent['"+tmp[0]+"'] = '"+tmp[1]+"';"); | |
| } | |
| 这样将事件字符串拆分成数组形式，便于操作。 | |
| |
| 第三步：处理事件 | |
| 根据事件的不同，辨别通话进行的情况以及业务处理。 | |
| |
| 下面列出asterCC在不同呼叫情况时传出的mseeage： | |
| 呼出： | |
| 坐席振铃： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=AGENT&event=ringing&uniqueid=19866&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:01&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=Local/041139735857@hosted-dialout-408a;1&from=dialout&”; | |
| 坐席应答： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=AGENT&event=answer&uniqueid=19866&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:01&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel= &from=dialout&”; | |
| 客户振铃： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=CALLEE&event=ringing&uniqueid=19867&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:01&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=Local/0138888888888@hosted-dialout-7636;1&from=dialout&”; | |
| 客户应答： | |
| message=“calleridnum=041139735857&didnumber=&activenum=041139735857&source=CALLEE&event=answer&uniqueid=19867&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:09&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=&from=dialout&”; | |
| 客户挂断： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=CALLEE&event=hangup&uniqueid=19867&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:47&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=Local/0138888888888@hosted-dialout-7636;1&from=dialout&”; | |
| 坐席挂断： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=AGENT&event=hangup&uniqueid=19866&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:47&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=Local/041139735857@hosted-dialout-408a;1&from=dialout&”; | |
| 通话整体结束事件： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=CONVERSATION&event=hangup&uniqueid=0&sessionid=efeb7b374a3408b0d0954f30a1504d83&eventTime=2010-01-01 08:22:47&AgentTeamId=20&modeltype=Campaign&model_id=10&AgentGroupId=100&calltype=dialout&channel=&from=dialout&”; | |
| |
| |
| 呼入： | |
| 客户呼入： | |
| message= “source=CALLER&event=incoming&modeltype=Campaign&uniqueid=1555&model_id=10&from=dialin&sessionid=1f10eab01f5b1b36230b8e91aef34810&channel=Local/0138888888888@hosted-dialin-701a;1”; | |
| 坐席振铃： | |
| message=“calleridnum=0138888888888&didnumber=800888&activenum=041139735857&source=AGENT&event=ringing&uniqueid=1556&sessionid=1f10eab01f5b1b36230b8e91aef34810&eventTime=2010-01-01 11:11:07&AgentTeamId=3&modeltype=Campaign&model_id=10&AgentGroupId=100&from=dialin&channel=Local/041139735857@hosted-dialin-531a;1”; | |
| 坐席应答： | |
| message=“calleridnum=0138888888888&didnumber=800888&activenum=041139735857&source=AGENT&event=answer&uniqueid=1556&sessionid=1f10eab01f5b1b36230b8e91aef34810&eventTime=2010-01-01 11:11:10&AgentTeamId=3&modeltype=Campaign&model_id=10&AgentGroupId=100&from=dialin&channel=”; | |
| 客户挂断： | |
| message=“calleridnum=0138888888888&didnumber=800888&activenum=041139735857&source=CALLER&event=hangup&uniqueid=1555&sessionid=1f10eab01f5b1b36230b8e91aef34810&eventTime=2010-01-01 11:12:54&AgentTeamId=3&modeltype=Campaign&model_id=10&AgentGroupId=100&from=dialin&channel=Local/0138888888888@hosted-dialin-701a;1”; | |
| 坐席挂断： | |
| message=“calleridnum=0138888888888&didnumber=800888&activenum=041139735857&source=AGENT&event=hangup&uniqueid=1556&sessionid=1f10eab01f5b1b36230b8e91aef34810&eventTime=2010-01-01 11:12:54&AgentTeamId=3&modeltype=Campaign&model_id=10&AgentGroupId=100&from=dialin&channel=Local/041139735857@hosted-dialin-531a;1”; | |
| 通话整体结束事件： | |
| message=“calleridnum=0138888888888&didnumber=&activenum=041139735857&source=CONVERSATION&event=hangup&uniqueid=0&sessionid=1f10eab01f5b1b36230b8e91aef34810&eventTime=2010-01-01 11:12:54&AgentTeamId=3&modeltype=Campaign&model_id=10&AgentGroupId=100&channel=&from=dialin&”; | |
| |
| |
| 主要事件参数概述： | |
| |
| source代表事件来源对象，它的值会是AGENT(坐席),CALLER(呼入客户),CALLEE(被叫客户), CONVERSATION(全部通话), CONSULT(第N方) | |
| *source值全部是大写字母 | |
| |
| event 代表发生了什么事件，它的值会是ringing(振铃)，answer（应答），hangup（挂断），join（加入），incoming（来电），onhold（暂停），resume（恢复） | |
| *event值全部是小写字母 | |
| |
| calleridnum 代表客户电话，其值为客户的电话号码。 | |
| |
| activenum 代表当前source的电话号码。 | |
| |
| didnumber 代表DID号码。 | |
| |
| eventTime 代表事件实际发生时间，一般用于记录通话记录，避免由于程序延迟而造成时间不准确。 | |
| |
| sessionid 通话唯一标识，一通通话里所有事件都使用这个唯一标识，并且该唯一标识在系统内是唯一的，不会与其它通话重复。 | |
| |
| from 用于区分通话是来电(呼入时值为dialin)，还是去电（呼出时值为dialout）。 | |
| |
| eventid 标识当前事件的id，当你发现你收到事件的id小于你记录的最大id,那么说明事件是过去时事件。 | |
| |
| |
| uniqueid 是source在当前系统中通话的唯一标识，调用系统一些事件功能时，当作参数。 | |
| |
| channel 是source在当前系统中通话的通道，调用系统一些事件功能时，当作参数。 | |
| |
| AgentTeamId 当前事件所属团队的ID。 | |
| |
| AgentGroupId 当前事件所属坐席组的ID。 | |
| |
| modeltype 标识当前事件应用于哪个模块。Campaign(拨号计划), Virtualcustomer (虚拟用户) | |
| |
| model_id 根据modeltype 告知你某个计划的ID或某个虚拟用户的ID。 | |
