23550

一洽客服系统-实时接收会话业务数据

目录

1. 选择数据接收模式
2. 消息加解密说明
3. 选择接收的业务数据
3.1登录状态
3.1.1公司状态变更
3.1.2分组状态变更
3.1.3客服状态变更
3.1.4路由状态变更
3.2对话数据
3.2.1对话开始
3.2.2对话结束
3.2.3对话接通
3.2.4对话转接
3.2.3对话内容
3.2.4对话评估
3.2.5对话满意度评价
3.3客户数据
3.4浏览数据
3.4.1访客进入
3.4.2访客离开
3.4.3轨迹数据
4. demo代码下载

1.选择数据接收模式

安全模式：POST给消息接收接口的数据会进行加密，消息接收方需要对其进行解密后才能使用，数据安全性较高
明文模式：PSOT给消息接口的数据是明文的XML数据，数据安全性较低，如果不想解密业务消息，请尽量使用SSL协议的接口地址。

接口调用方式：POST
接口GET参数：签名信息（每次调用一洽都会讲签名信息以GET参数的形式追加在接口地址中）

2. 消息加解密说明

什么是EncodingAESKey？
一洽采用AES对称加密算法对消息体对行加密，EncodingAESKey则是加密所用的秘钥。消息接收方用此秘钥对收到的密文消息体进行解密。

消息加解密过程和微信公众平台的消息加解密方式一致。
示例代码（包括C++、php、Java、Python和C#版本）示例代码
注：一洽的签名信息在GET请求中，微信的示例代码签名在XML结构中，Encrypt节点的加解密方式是一样的。

Java要求jdk 1.6及1.6以上
异常java.security.InvalidKeyException:illegal Key Size的解决方案：在官方网站下载JCE无限制权限策略文件（请到官网下载对应的版本， 例如JDK7的下载地址：http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html 下载后解压，可以看到local_policy.jar和US_export_policy.jar以及readme.txt，如果安装了JRE，将两个jar文件放到%JRE_HOME%\lib\security目录下覆盖原来的文件；如果安装了JDK，将两个jar文件放到%JDK_HOME%\jre\lib\security目录下覆盖原来文件

3.选择接收的业务数据

一洽服务器会根据开发者选择的数据模块POST相应的业务数据给开发者服务器URL，主要数据包括：
登录状态 、对话数据 、客户数据 ，以下是每种数据类型业务数据的详细数据和介绍

3.1登录状态
在线和离线解释：

状态 解释
在线 当前有客服登录状态为在线或者忙碌，可正常接入对话
离线 当前没有客服登录或者所有登录客服的状态为离开或者隐身，请求进入留言处理

3.1.1 公司状态变更
GET参数追加：dataType=companyStatus
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=companyStatus

POST内容：公司当前状态XML信息
明文XML示例：

<xml>
<companyStatus>1</companyStatus>
</xml>

下面所有的加密示例所使用的的appid和encodingAesKey如下：

appId:myAPPID
encodingAesKey:43weiyiqiaencodingAesKey1111111111111111111

密文XML示例：

<xml>
<Encrypt><![CDATA[YrU6kXHIBgy03Vq9QbJU54cwPSxyJlgeJJV8/xCDlsFPONdHhoJzINJqVI5Wo6yVJMjaOaf5Xt1Wup3UQo5/lDnRM3y5hnxGcI82f7aQ0wRcm4HQVvHmwqP+9+lnBbLL]]></Encrypt>
</xml>

companyStatus状态解释

状态 含义
1 在线
2 离线

3.1.2分组状态变更
GET参数追加：dataType=skillStatus
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=skillStatus

POST内容：分组状态XML信息
明文XML示例：

<xml>
<skillStatus>1</skillStatus>
<skillId>3</skillId>
<skillNanme><![CDATA[订单组]]></skillName>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[4dEBoMVBC4OstAFSGJ4YcrsrbiHq6T3Ot5uQh3wdYq7X/Rd/CC5LHAtN2K9y/Gz1ibnNzWZoO0E2W24k5C0zvGHNnS1K/4uWDht0/IaoJhgA0IBpLDr/OXWVx+SWReEtnL2ehmeL9Fxt81z724aPPxuIkKEIdZBP79W5mI+u+5pcAmch2VbOEH0APkYbJu/XZAhoGxKYPfNOnIFigRzb3w==]]></Encrypt>
</xml>

XML属性解释

属性 含义
skillId 状态发生变化的分组ID
skillNanme 状态发生变化的分组名称
skillStatus 当前分组的状态 1：在线 2：离线

3.1.3 客服状态变更
GET参数追加：dataType=staffStatus
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=staffStatus

POST内容：客服状态XML信息
明文XML示例：

<xml>
<staffStatus>1</staffStatus>
<staffId>14</staffId>
<staffLogname><![CDATA[13430987639]]></staffLogname>
<staffName><![CDATA[张三]]></staffName>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[37vOG3cQ5KKSlb+O5+PTZwHOrAQRB0v57bdh9CArghPmk27vaVH7/9U117aRXrOVyweluFqRI43Baq41H8HgpzjFoyoy45nTW2pxk/ZJbP/pWG1Pwk3hSwtvQaD97haGf2cs7QVZA3mV6E8Z8Chw/1MolA7OQxCXwU8/3bi/SxzDIoeTKS+4gwGbUUvfwSo/8JPKCk37X+T73/bhufoe0rdNgX8PkFG7+83KiUpgupPZq8Ehp7Kr+TbA7Pmiq8og]]></Encrypt>
</xml>

XML属性解释

属性 含义
staffId 状态发生变化的客服ID
staffLogname 状态发生变化的客服账号（手机/邮箱)
staffName 状态发生变化的客服姓名
staffStatus 当前客服的状态 1:在线 2:忙碌 3:离开 4:隐身 5:退出

3.1.4 路由状态变更
GET参数追加：dataType=routeStatus
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=routeStatus

POST内容：路由状态XML信息
明文XML示例：

<xml>
    <routeStatus>1</routeStatus>
    <routeId>272</routeId>
    <routeName><![CDATA[订单物流]]></routeName>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[37vOG3cQ5KKSlb+O5+PTZwHOrAQRB0v57bdh9CArghPmk27vaVH7/9U117aRXrOVyweluFqRI43Baq41H8HgpzjFoyoy45nTW2pxk/ZJbP/pWG1Pwk3hSwtvQaD97haGf2cs7QVZA3mV6E8Z8Chw/1MolA7OQxCXwU8/3bi/SxzDIoeTKS+4gwGbUUvfwSo/8JPKCk37X+T73/bhufoe0rdNgX8PkFG7+83KiUpgupPZq8Ehp7Kr+TbA7Pmiq8og]]></Encrypt>
</xml>

XML属性解释

属性 含义
routeId 状态发生变化的路由ID
routeName 状态发生变化的路由名称
routeStatus 指定路由的状态 1:在线 2:离线

3.2 对话数据
访客开始建立对话到对话结束，一洽会向数据接收方推送6种数据:对话开始、对话结束、对话内容、留言内容、对话主题评估、满意度评价
3.2.1对话开始
GET参数追加：dataType=chatStart 或者 robotChatStart
chatStart:人工对话/留言开始
robotChatStart:机器人对话开始
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatStart

POST内容：对话开始的XML信息
明文XML示例：

<xml>
<chatStatus><![CDATA[1]]></chatStatus>
<myData><![CDATA[network=wifi&game=斗地主&ver=9.2&os=ios10]]></myData> 
<metaData>
<uid><![CDATA[1314521]]></uid>
<grade><![CDATA[1]]></grade>
<category><![CDATA[金牌会员]]></category>
<name><![CDATA[王宝强]]></name>
<nickName><![CDATA[宝宝]]></nickName>
<gender><![CDATA[男]]></gender>
<age><![CDATA[36]]></age>
<birthday><![CDATA[2015-08-01]]></birthday>
<maritalStatus><![CDATA[2]]></maritalStatus>
<phone><![CDATA[18990987546]]></phone>
<qq><![CDATA[9876389]]></qq>
<wechat><![CDATA[echatsoft]]></wechat>
<email><![CDATA[9876389@qq.com]]></email>
<nation><![CDATA[中国]]></nation>
<province><![CDATA[广东]]></province>
<city><![CDATA[深圳]]></city>
<address><![CDATA[深南大道金融街]]></address>
<photo><![CDATA[http: // www.baidu.com/mypic.png]]></photo>
<memo><![CDATA[娱乐明星]]></memo>
</metaData> 
<visitorData> 
<visitorMedia><![CDATA[5]]></visitorMedia>
<visitorType><![CDATA[4]]></visitorType>
<visitorId><![CDATA[wechato6ohSwjIVENM7ZbBqPypRyu4D_zA]]></visitorId>
<visitorName><![CDATA[王宝强]]></visitorName>
<visitorPhoto><![CDATA[http:// wx.qlogo.cn/mmopen/WncXm]]></visitorPhoto>
<visitTimes><![CDATA[5]]></visitTimes>
<visitorLan><![CDATA[zh_CN]]></visitorLan>
<visitorIp><![CDATA[122.96.185.139]]></visitorIp>
<visitorCountry><![CDATA[中国]]></visitorCountry>
<visitorProvince><![CDATA[广东]]></visitorProvince>
<visitorCity><![CDATA[深圳]]></visitorCity>
<browserName><![CDATA[QQ浏览器]]></browserName>
<browserVersion><![CDATA[9.0]]></browserVersion>
<screenResolution><![CDATA[1920*1080]></screenResolution>
<osName><![CDATA[Windows]]></osName>
<osVersion><![CDATA[7]]></osVersion>
<se><![CDATA[baidu]]></se>
<keyword><![CDATA[在线客服软件]]></keyword>
<referPage><![CDATA[http://www.baidu.com/baidu.php?sc.WwCK00j7A0GeyEPIcgU]]></referPage>
<firstTime><![CDATA[2016-01-09 17:53:32]]></firstTime>
<firstPage><![CDATA[http://wx.qlogo.cn/mmopen]]></firstPage>
<firstPageTitle><![CDATA[一洽软件的价格]]></firstPageTitle>
<lastChatTime><![CDATA[2015-07-08 11:23:36]]></lastChatTime>
<lastChatStaffId><![CDATA[14]]></lastChatStaffId>
<lastChatStaffLogname><![CDATA[218098933897]]></lastChatStaffLogname>
<lastChatStaffName><![CDATA[郑丽文]></lastChatStaffName>
</visitorData> 
<routeData> 
<routeId><![CDATA[72]]></routeId>
<routeName><![CDATA[一洽]]></routeName>
<styleId><![CDATA[201]></styleId>
<styleName><![CDATA[一洽网站]]></styleName>
<chatDepartmentId><![CDATA[11]]></chatDepartmentId>
<chatDepartmentName><![CDATA[订单组]]></chatDepartmentName>
</routeData> 
<chatData>
<chatPage><![CDATA[http://wx.qlogo.cn/mmopen]]></chatPage>
<chatPageTitle><![CDATA[一洽软件的价格]]></chatPageTitle>
<chatTimes><![CDATA[5]]></chatTimes>
<chatEvent><![CDATA[1]]></chatEvent>
<chatRequestTime><![CDATA[2016-01-09 17:54:32]]></chatRequestTime>
<chatAnswerTime><![CDATA[2016-01-09 17:54:58]]></chatAnswerTime>
<chatType><![CDATA[1]]></chatType>
<chatStaffId><![CDATA[14]]></chatStaffId>
<chatStaffLogname><![CDATA[18098933897]]></chatStaffLogname>
<chatStaffName><![CDATA[郑丽文]]></chatStaffName>
<chatStaffRole><![CDATA[超级管理员]]></chatStaffRole>
<chatEntrance><![CDATA[售后]]></chatEntrance> 
<chatRecordId><![CDATA[5987809]]></chatRecordId> 
</chatData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[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]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatStatus 1：人工对话开始 2：人工对话结束 3：留言开始 4：留言结束 5：机器人对话开始 6：机器人对话结束
myData 开发者自定义扩展数据，如果打开对话时加了这个参数则传递该数据

metaData（会员数据，如果是会员则传递该数据）

属性 含义
uid 会员的唯一值
grade 会员级别，大于0的数字
category 会员类别 例如：金牌会员
name 会员姓名 例如：王宝强
nickName 会员的昵称 例如：宝宝
gender 会员的性别，0-未知， 1-男， 2-女
age 会员的年龄
birthday 会员的生日 例如：2015-08-01
maritalStatus 婚姻状况 1：未婚 2：已婚 0：未知
phone 会员的联系电话
qq 会员的QQ
wechat 会员的微信
email 会员的邮件地址
nation 会员的国家
province 会员的身份
city 会员的城市
address 会员地址
photo 会员头像地址
memo 会员备注信息

visitorData（访客数据）

属性 含义
visitorMedia 客户端的媒介，1-PC网页，2-手机网页,5-微信,6-sdk,200-自定义渠道
visitorType 访客身份类型 -1未知，0-游客(web)，1-会员(vip)，2-SDK游客(sdk)，4-微信（wechat)，5-自定义接口(custom)
mediaId visitorType==5时，此值有效，值为自定义渠道的渠道ID
visitorId 访客ID，身份描述+ID
visitorName 访客的姓名 例如：王宝强
visitorPhoto 访客的头像 例如：http://wx.qlogo.cn/mmopen/WncXm
visitTimes 访客来访的次数
visitorLan 访问者的语言 例如：zh,en
visitorIp 访客的来访IP
visitorCountry 访客所在国家 例如：中国
visitorProvince 访客所在省份 例如：广东省
visitorCity 访客所在城市 例如：深圳市
browserName 访客的浏览器 比如：qq   微信对话无此属性
browserVersion 访客的浏览器版本 比如：9.0   微信对话无此属性
screenResolution 访客的屏幕分辨率 例如：1920*1080   微信对话无此属性
osName 访客操作系统 例如：Windows   微信对话无此属性
osVersion 操作系统版本   微信对话无此属性
se 访客来访的搜索引擎 例如：baidu   微信对话无此属性
keyword 访客来访的搜索关键字 例如：一洽软件   微信对话无此属性
referPage 访客来源的URL，如果是微信，就是公众号名 例如：http: // www.baidu.com/baidu.php?sc.WwCK00j7A0GeyEPIcgU
firstTime 进入网站的时间 例如：2016-01-09 17:53:32   微信对话无此属性
firstPage 落地页 例如：http://www.echatsoft.com   微信对话无此属性
firstPageTitle 落地页面的标题 例如：一洽软件  微信对话无此属性
lastChatStaffId 上次对话的客服ID
lastChatStaffLogname 上次对话的客服账号
lastChatStaffName 上次对话的客服姓名

routeData（本次对话的路由数据）

属性 含义
routeId 接入对话的路由ID -1：web访客的默认路由 -2：微信对话的默认路由 -3：SDK对话的默认路由
routeName 路由名称
styleId 路由所使用的样式ID
styleName 路由所使用样式的名称
chatDepartmentId 本次分配对话的分组ID，如果是全部人员可接待则ID为0
chatDepartmentName 本地分配对话的分组名称 例如：订单组

chatData（对话数据）

属性 含义
chatPage 对话页面 例如：http://www.echatsoft.com   微信对话无此属性
chatPageTitle 对话页面标题 例如：一洽软件   微信对话无此属性
chatTimes 访客的对话次数
chatEvent 对话发起的方式，1-点击图标，2-接受邀请对话，3-客服主动对话,4-微信输入任意文字接入对话,5-微信点击菜单接入,6-微信输入指定文字接入,7-微信机器人转人工,11-机器人转人工,12-机器人转留言,14-web自动弹屏自动接入,15-web自动弹屏访客输入消息接入,16-商户留言转平台接入,17-微信开发者接入,18-自定义渠道事件接入,19-自定义渠道发送消息接入
chatRequestTime 请求对话的时间 例如：2016-01-09 17:54:32
chatAnswerTime 对话接通的时间 例如：2016-01-09 17:54:32
chatType 会话类型 1-在线对话，2-忙碌对话，3-离线消息，5-机器人对话
chatStaffId 接待对话的客服ID 人工对话有效
chatStaffLogname 接待对话的客服登录名 人工对话有效
chatStaffName 接待对话的客服姓名 人工对话有效
chatStaffRole 接待对话的客服的内部角色名称 例如：客 服主管 人工对话有效
chatEntrance 对话入口 访客端传参为echatTag的值
chatRecordId 对话记录的ID，唯一值 例如：1_123321

3.2.2对话结束
GET参数追加：dataType=chatEnd 或者 robotChatEnd
chatEnd:人工对话/留言结束
robotChatEnd:机器人对话结束
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatEnd

POST内容：对话结束的XML信息
明文XML示例：

<xml>
<chatStatus><![CDATA[2]]></chatStatus>
<chatData>
<chatRecordId><![CDATA[5987809]]></chatRecordId>
<chatEndTime><![CDATA[2016-01-09 17:54:58]]></chatEndTime>
<chatEndType><![CDATA[客服关闭]]></chatEndType>
<chatTotalTime><![CDATA[8200]]></chatTotalTime>
<chatWaitTime><![CDATA[16]]></chatWaitTime>
<firstAnswerTime><![CDATA[2]]></firstAnswerTime> 
<avgAnswerTime><![CDATA[5]]></avgAnswerTime>
<visitorSendMsg><![CDATA[25]]></visitorSendMsg>
<staffSendMsg><![CDATA[35]]></staffSendMsg>
<perfectMatchs><![CDATA[1]]</perfectMatchs>
<exactMatchs><![CDATA[1]]</exactMatchs>
<similarityMatchs><![CDATA[1]]</similarityMatchs>
<misMatchCount><![CDATA[1]]</misMatchCount>
<solvedCount><![CDATA[1]]</solvedCount>
<unsolvedCount><![CDATA[1]]</unsolvedCount>
</chatData>
<staffKpis>
<staffKpi>
<staffId><![CDATA[14]]></chatStaffId>
<staffLogname><![CDATA[13128888888]]></chatStaffLogname>
<staffName><![CDATA[一洽客服]]></chatStaffName>
<firstAnswerTime><![CDATA[2]]></firstAnswerTime> 
<avgAnswerTime><![CDATA[5]]></avgAnswerTime>
<visitorSendMsg><![CDATA[25]]></visitorSendMsg>
<staffSendMsg><![CDATA[35]]></staffSendMsg>
</staffKpi>
<staffKpi>
<staffId><![CDATA[15]]></chatStaffId>
<staffLogname><![CDATA[13128888666]]></chatStaffLogname>
<staffName><![CDATA[一洽客服]]></chatStaffName>
<firstAnswerTime><![CDATA[2]]></firstAnswerTime> 
<avgAnswerTime><![CDATA[5]]></avgAnswerTime>
<visitorSendMsg><![CDATA[25]]></visitorSendMsg>
<staffSendMsg><![CDATA[35]]></staffSendMsg>
</staffKpi>
</staffKpis>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[gUHc0D73LA5oHk+mfxqebcitJQGnoIUjYfSt2OzBIhoGQ3WU8RP0hVDFusA2CJN+wpZl4Wn/0wwjrK9+Nq4bP5+J8D1iSr610av5rvBrWPqV+ukvQYKR13msx7h/xDCBRu6txKQvgXVcTMiYZgj93mP/zWm9DU8ltWr8cZPwP1Xta692Qz1CSjInxuh2QC0dtVuL+3/abqvG7ZB6ZYhruvfQOD4VxHe6QfyBYWszgn+ptxB6drMWn8IHzed0L9MbCZcpk7jLv1pltsnpYJIcPfOrA5Tu9/gqfdj1HbjXkbrht8dWuKUTv+J+qavZVhH7epOwzJS5BMJuW55vntHHoQmNIKo5Okygy5UDL/mE2NLjaA3zKjVdL3TZdEip4FKAiRQORS964Th4TT3bz6SApg8XtCc6jsnhQ7vB5/kzkPJn55rHma+1ScOoJVJeYgyipOXqLK2I+qwbBeCIYkiaVkdDiUeu29w7s94Tqf7mL9LspnMRqTvadAsXanbdnFWeMDRhYk+iLUPfYs1lzH7uZg+Hzxbpw2fOzOjuZegK1mCCJyaW0jxY6JiFcUVc7pHYGLh28dsj09Fk4JQ30K6wuXwbOf8sJRbXCOeg4ta2xgZk011G0jTF4AtT7MVkbwVfaYtX5s2pUHqriqYpmCOqQbpQl1c31Y8FU2Ee7oFKEoZx2Az5e/sHECvExhYwywCi5cBEY+a6skfOAqxjoYM29HXyMkHWoVx8IVu2lT03N9DE2t1oXBVx6xpehHs1/x2cAAu+LpgXy/7ORxD6MnY6hYfRcbEnE1d5xQP14+6Q2pRLn3EhCvVqSfwK4Vpv/U+/DOW0AeVytf2qM+g3HG7ljof+YxahjFQpMa0Z//SCNlXqjQsJ+Z3TtraBijxNkIN1VVPYCErJyfQw3PTL20frPOENj2gCwIkX2NefTUoAozQg92gkwKXGAdgvWcPVnmE/9h4Qg7snaoxOiRkCd3jp9iJjfKtqJr4i+2GHRtUJ0l8a2lmKDtQI1+2mQx1F0NotM7vXLKo24DiaQJsR2qr5cs2HTl1hVPV6/sAX0fc12sRfurcOCgOcusEk4F2KzsNGeUWM0DAQCWTLYLelAIs1Mnciz0M/G2fGEV9Utgbjcd2gO/8p4vdt5gTERUIbNNKNAWbaY6ZK+HXqdtcCXgi9Z8jXXCCfBz+DtmCdToNOBgG8XJ2/XhhCBSpVemf0TCSUkmPvAP1po130JO/JP1P0gDxMiIIfn/VbCqOqHaXIRf725UtK1tZ5M9mD12wDP2mzt14WpXiwHC45XZCzzQPPt828YceTQYsLU0N+B3xM9xM1EzgQj1uYo41Rdn7C8pVJfvcPCy2WDyJAg6CNgJ6pY1EbT7nB4p4z3UcCMA73BjTkgzoBX3KMHdln3I8bz8bHucGda4omev1w60ZFbmgoZIcvBSnU35td/waAtdaH1pQaIs33lRRQ14/hY9JY3900yJKuGYvTKjpNvJCl7Fx8dnjp+OxhcfAlfCnzKj1P8Nvj+hypzjULU188nby8t07v59avszMEM3yqhBEluL04Yo9aAEaAE2qTFLXe/h1yKX5h61aFq6bBnnH/PA/XQWTDz8hwX3wyVZKWRcfnFCqlpg==]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatStatus 1：人工对话开始 2：人工对话结束 3：留言开始 4: 留言结束 5：机器人对话开始 6：机器人对话结束

chatData（对话数据）

属性 含义
chatRecordId 对话记录的ID，唯一值 例如：5987809
chatEndTime 对话结束时间 例如：2016-01-09 17:54:58
chatEndType 对话结束方式 0-未知，1-访客结束对话，2-客服结束对话，3-访客超时，5-客服退出，6-系统关闭，8-访客长时间未回复结束，12-忙碌放弃结束，14-留言超时结束，15-机器人自动转人工结束，16-机器人手动转人工结束，18-客服主动对话后留言/机器人对话结束
chatTotalTime 通话时长 单位：秒
chatWaitTime 等待时长 单位：秒
firstAnswerTime 首次响应时长 单位：秒
avgAnswerTime 平均响应时长 单位：秒
visitorSendMsg 访客发送消息条数
staffSendMsg 客服发送消息条数
perfectMatchs 完全匹配数，机器人对话有此字段
exactMatchs 精准匹配数，机器人对话有此字段
similarityMatchs 相似匹配数，机器人对话有此字段
misMatchCount 未命中数，机器人对话有此字段
solvedCount 点击解决数，机器人对话有此字段
unsolvedCount 点击未解决数，机器人对话有此字段

staffKpis（客服kpi数据，如果当前对话经过过转接则会有此节点，如果对话只有一个客服服务那么请使用chatData中的avgAnswerTime等信息作为客服的KPI数据）

staffKpi:

属性 含义
staffId 接待对话的客服ID
staffLogname 接待对话的客服登录名
staffName 接待对话的客服姓名
firstAnswerTime 首次响应时长 单位：秒
avgAnswerTime 平均响应时长 单位：秒
visitorSendMsg 访客发送消息条数
staffSendMsg 客服发送消息条数

3.2.3 对话接通
GET参数追加：dataType=chatAnswer
排队接通的对话会有此事件下发

请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatAnswer

POST内容：对话评估的XML信息
明文XML示例：

<xml>
<chatStatus><![CDATA[1]]></chatStatus>
<chatData>
<chatAnswerTime><![CDATA[2016-01-09 17:54:58]]></chatAnswerTime>
<chatWaitTime><![CDATA[16]]></chatWaitTime>
<chatType><![CDATA[1]]></chatType>
<chatStaffId><![CDATA[14]]></chatStaffId>
<chatStaffLogname><![CDATA[13128888888]]></chatStaffLogname>
<chatStaffName><![CDATA[一洽客服]]></chatStaffName>
<chatStaffRole><![CDATA[超级管理员]]></chatStaffRole>
<chatRecordId><![CDATA[5987809]]></chatRecordId> 
<chatDepartmentId><![CDATA[11]]></chatDepartmentId>
<chatDepartmentName><![CDATA[订单组]]></chatDepartmentName>
</chatData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[pcf0D1yQAvtOjRmwjkxHLuIjUFmA3AP+A2YKXxIerq5p/lh7URAmAXsxXJUJ4wu8kOkW/JGB9dyf7qmJYXMmv2TIyWSmDhhK1GXhZUHHBTyyWHieZaBUBPkT5EG3Vb/vX5amZE63vJllzyvDB9JD5MLoOyCS8O5JkPAWrVBGdFoa8VAEjEJHdSlDabyJ8h7QxX40z7002eAbZjwPtschrtVQjZd5j4U1e/NE5ryXq2jwljAC1WZHJb2F1K3nv+tKZuYQDltFxcE1LMA1m/b62allzqZ0ChYPsonSVcT7WtGLZAKqZktjO922qmsmfMeLBW4mO2Nw+D767W+9BUnucA==]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatStatus 固定为1，对话开始

chatData（对话数据）

属性 含义
chatAnswerTime 对话接通时间，格式：yyyy-MM-dd HH:mm:ss 2016-01-09 17:54:58
chatWaitTime 访客等待时长，单位：秒
chatType 会话类型 1-在线对话，3-离线消息，5-机器人对话
chatStaffId 接待对话的客服ID 人工对话有效
chatStaffLogname 接待对话的客服登录名 人工对话有效
chatStaffName 接待对话的客服姓名 人工对话有效
chatRecordId 对话记录的ID，唯一值 例如：1_123321
chatDepartmentId 本次分配对话的分组ID，如果是全部人员可接待则ID为0
chatDepartmentName 本地分配对话的分组名称 例如：订单组

3.2.4 对话转接
GET参数追加：dataType=chatTransfer
排队接通的对话会有此事件下发

请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatAnswer

POST内容：对话评估的XML信息
明文XML示例：

<xml>
<msgId><![CDATA[39086101]]></msgId>
<tm><![CDATA[1563851906863]]></tm>
<transferData>
<chatRecordId><![CDATA[1_5987809]]></chatRecordId>
<transferTime><![CDATA[2016-01-09 17:54:58]]></transferTime>
<fromStaffId><![CDATA[16]]></fromStaffId>
<fromStaffLogname><![CDATA[13128888888]]></chatStaffLogname>
<fromStaffName><![CDATA[一洽客服01]]></chatStaffName>
<toStaffId><![CDATA[16]]></toStaffId>
<toStaffLogname><![CDATA[13126666666]]></toStaffLogname>
<toStaffName><![CDATA[一洽客服02]]></toStaffName> 
</transferData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[pcf0D1yQAvtOjRmwjkxHLuIjUFmA3AP+A2YKXxIerq5p/lh7URAmAXsxXJUJ4wu8kOkW/JGB9dyf7qmJYXMmv2TIyWSmDhhK1GXhZUHHBTyyWHieZaBUBPkT5EG3Vb/vX5amZE63vJllzyvDB9JD5MLoOyCS8O5JkPAWrVBGdFoa8VAEjEJHdSlDabyJ8h7QxX40z7002eAbZjwPtschrtVQjZd5j4U1e/NE5ryXq2jwljAC1WZHJb2F1K3nv+tKZuYQDltFxcE1LMA1m/b62allzqZ0ChYPsonSVcT7WtGLZAKqZktjO922qmsmfMeLBW4mO2Nw+D767W+9BUnucA==]]></Encrypt>
</xml>

XML属性解释

transferData（转接数据）

属性 含义
chatRecordId 对话记录的ID，唯一值 例如：1_123321
transferTime 对话转接时间，格式：yyyy-MM-dd HH:mm:ss 2016-01-09 17:54:58
fromStaffId 发起转接的客服ID
fromStaffLogname 发起转接请求的客服登录名
fromStaffName 发起转接请求的客服名称
toStaffId 接受转接的客服ID
toStaffLogname 接受转接的客服登陆名
toStaffName 接受转接的客服名称

3.2.5 对话内容
GET参数追加：dataType=chatContent 或者 leaveMsgContent
chatContent:对话内容
leaveMsgContent:留言内容
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatContent

POST内容：对话评估的XML信息
明文XML示例：

<xml>
<chatData>
<chatRecordId><![CDATA[1_5987809]]></chatRecordId>
<chatContent><![CDATA[对话开始 >>2016-08-17 10:47:01.0\n访客>2016-08-17 10:47:08\n您好\n访客>2016-08-17 10:47:09\n您好\nElla>2016-08-17 10:47:13\n您好\n访客>2016-08-17 10:47:24\n想詢問自動應答功能 \n访客>2016-08-17 10:47:34\n是否可以多新增幾個呢\n访客>2016-08-17 10:47:46\n如30秒回復一個內容\n访客>2016-08-17 10:48:00\n90秒再回復一個呢?\nElla>2016-08-17 10:48:08\n您好，只能设置一次\n访客>2016-08-17 10:48:38\n因回覆內容不同 這樣設置有些不便\nElla>2016-08-17 10:49:18\n您公司ID是多少呢？\n对话结束 >>2016-08-17 10:51:12.0\n访客关闭对话]]></chatContent>
</chatData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[pcf0D1yQAvtOjRmwjkxHLuIjUFmA3AP+A2YKXxIerq5p/lh7URAmAXsxXJUJ4wu8kOkW/JGB9dyf7qmJYXMmv2TIyWSmDhhK1GXhZUHHBTyyWHieZaBUBPkT5EG3Vb/vX5amZE63vJllzyvDB9JD5MLoOyCS8O5JkPAWrVBGdFoa8VAEjEJHdSlDabyJ8h7QxX40z7002eAbZjwPtschrtVQjZd5j4U1e/NE5ryXq2jwljAC1WZHJb2F1K3nv+tKZuYQDltFxcE1LMA1m/b62allzqZ0ChYPsonSVcT7WtGLZAKqZktjO922qmsmfMeLBW4mO2Nw+D767W+9BUnucA==]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatRecordId 对话记录的ID，唯一值 例如：1_5987809
chatContent 对话内容

3.2.6 对话评估
GET参数追加：dataType=chatSubject
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatSubject

POST内容：对话评估的XML信息
明文XML示例：

<xml>
<chatRecordId><![CDATA[5987809]]></chatRecordId>
<chatSubject><![CDATA[售后>订单>物流]]></chatSubject>
<chatSubjectMemo><![CDATA[客户要求换货，拒绝维修]]></chatSubjectMemo> 
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[pcf0D1yQAvtOjRmwjkxHLuIjUFmA3AP+A2YKXxIerq5p/lh7URAmAXsxXJUJ4wu8kOkW/JGB9dyf7qmJYXMmv2TIyWSmDhhK1GXhZUHHBTyyWHieZaBUBPkT5EG3Vb/vX5amZE63vJllzyvDB9JD5MLoOyCS8O5JkPAWrVBGdFoa8VAEjEJHdSlDabyJ8h7QxX40z7002eAbZjwPtschrtVQjZd5j4U1e/NE5ryXq2jwljAC1WZHJb2F1K3nv+tKZuYQDltFxcE1LMA1m/b62allzqZ0ChYPsonSVcT7WtGLZAKqZktjO922qmsmfMeLBW4mO2Nw+D767W+9BUnucA==]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatRecordId 对话记录的ID，唯一值 例如：5987809
chatSubject 对话评估的主题 例如：售后>订单>物流
chatSubjectMemo 对话评估备注 例如：客户要求换货，拒绝维修

3.2.7对话满意度评价
GET参数追加：dataType=chatScore
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=chatScore

POST内容：对话评估的XML信息
明文XML示例：

<xml>
<chatRecordId><![CDATA[5987809]]></chatRecordId>
<chatScore><![CDATA[5]]></chatScore>
<scoreDimension><![CDATA[产品,服务]]></scoreDimension>
<scoreSuggest><![CDATA[产品很棒，客服的服务更棒！]]></scoreSuggest>
<chatStaffId><![CDATA[14]]></chatStaffId>
<chatStaffLogname><![CDATA[18098933897]]></chatStaffLogname>
<chatStaffName><![CDATA[郑丽文]]></chatStaffName>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[F3ojdKrzWIGB+2YVHlBtl+6TXDUBqW2feUcmB3TzVhPyVwnphnAra/wNH5H5NiF/fVaIbM1wCBuvzKCo6E0FBEz1nCwxJUmpQ5cCIZ0BKh+6+7Wp4iAeVN+NoHz0ufWqy3vJ8r7TMApOiTaIsbfGHG3AsN2aKjetC58x14Tq5VEa3WxZAbJm83E0FQ5mhRSWOLCf23x86elu69zPlgUp/rmWwelFCAi1S3Cx9EpaF2MQHUt7BrFU6/kmWLKOCt2pls+UEfWuqFtrqVHa32b+UGIA7ke835fv1ePcZR8wpzwtpzaVPujnpOxdh+DzJ2iriXA6Sz5iQZDF7gDlag/NzBQdTZ3XegyKBuRev+Fn6e9poBKXM4yF+nkh5+U6Y04P]]></Encrypt>
</xml>

XML属性解释

属性 含义
chatRecordId 对话记录的ID，唯一值 例如：5987809
chatScore 满意度评价，1-非常不满意，2-不满意，3-一般，4-满意，5-非常满意
scoreDimension 评价维度 例如：产品、服务、物流
scoreSuggest 评价的内容
chatStaffId 评价发生时正在接待对话的客服ID,如评价时对话已结束则无此信息
chatStaffLogname 评价发生时正在接待对话的客服登录名,如评价时对话已结束则无此信息
chatStaffName 评价发生时正在接待对话的客服姓名,如评价时对话已结束则无此信息

3.3 客户数据
客户数据提交后会POST到接收方的接口中。

GET参数追加：dataType=crmStatus
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=crmStatus

POST内容：客户信息的XML信息
明文XML示例：

<xml>
<msgId>29870357</msgId>
<tm>1557753020901</tm>
<visitorId><![CDATA[web377724523]]></visitorId>
<crmStatus><![CDATA[1]]></crmStatus>
<staffId><![CDATA[14]]></staffId>
<staffLogname><![CDATA[18098933897]]></staffLogname>
<staffName><![CDATA[郑丽文]]></staffName> 
<crmData>
<visitorId><![CDATA[1314521]]></visitorId>
<category><![CDATA[意向]]></category>
<name><![CDATA[王宝强]]></name>
<nickName><![CDATA[宝宝]]></nickName>
<gender><![CDATA[1]]></gender>
<age><![CDATA[36]]></age>
<birthday><![CDATA[2015-08-01]]></birthday>
<maritalStatus><![CDATA[2]]></maritalStatus>
<phone><![CDATA[18990987546]]></phone>
<qq><![CDATA[9876389]]></qq>
<wechat><![CDATA[echatsoft]]></wechat>
<email><![CDATA[9876389@qq.com]]></email>
<nation><![CDATA[中国]]></nation>
<province><![CDATA[广东]]></province>
<city><![CDATA[深圳]]></city>
<address><![CDATA[深南大道金融街]]></address>
<photo><![CDATA[http: // www.baidu.com/mypic.png]]></photo>
<memo><![CDATA[娱乐明星]]></memo>
</crmData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[FtwduBHlEd7OtmFkm5G5KFHQoaGPyTbSaL3P9ifkNHI71liOrABT0TJI6pDaBl4raBSMwVhsOsiIMaYbb4C6NMDOCKMZE5nltDaazVTUfMRdL/feVuyhOM2nG0xCu6YipmJVzix2W4fbCasvQt9xJmOeBXsPh9zI4F3jABwuMLv7rNj3OeaNFa9Td5YDIvPmLrZg/j/JMofD0mH4GpUm7qosvQTWBAugRRQTjfqqNJee460QvJRDCDuDdrI2nKpv8z+HLuc3QuMwVfJcQ+4/J8+be5QSDmYOTZFg/wgR10ELXTfTtv9vEtRT443nzLSvUgjaFyLwu1NvHub8zDqEYIWSoYUJU+XrAuou/5ZYKaeErUJKZsD26tT51qk/ItDs3Ts+yiUTTe1BumwIw0zdndncWCSSC2WTrTFViIo7Hptrun640k5S7aOAXdwxudziaQvv52ICwpKx/g9TshkEq/ZxMCdWjcmvnnU5tB0oinAb4Ovrfx/erpBnYZ5fzszSQ3IWY5Xvs9RciTDomRW2WAjFjivcOn0LxpZjRpXkzpMHptx/cQK0ul7Bw6tVwh5n7UhX4/cmmOGsw729vqaNh6U74FJ9J3ucdqkjCUnQPKHz1BLEDxE6llIobdmiuPC/rSpLWgogrDl6suOm3LqY2VjTdf7zHTXJ6iRHSXzZSikoP8Dze9Ee39OHgjYaVCyvio/rWD27FUqNqDh4SC8YFE5jIy1rkmEcVLKN6IUd8POrCChg9i9B3NbmKXtxhZlNIS0wJt3FOOL5S++OftJ4bNKdQzrnmR/NTFcb8DpeFSMYWZ/TO4jd3FyuZZADWf1jqV3PuRZa3kIoGpO9a2dmV88va7o9DmYD+NXcIwBCIQnhpDUILOx9eiyOb22kb0eUJTcBi2E2rBcd+tYOMfZ/redj6V336B0BqMXro78nFmyjvtU0PlNBVolCZQirif8ODdvHVdvObYnXU9ldcXsCIZ+2OfFPY54+RLxSZ4in9JiL9SdFmv85AGcAGDiyOmBtegdOnxwAIzC2IdqtsstNwnkNZzDAg8XQwdY4SaaoFg4HnGhd1oMuKHoOkKOx6mxgnD+2JfEFCfVjKi/qhnrLvq31EcK6thn8k2jSrMKTLfOhPlpLDYE78qMFM9yWtIjf1EcuPm7JjR8ZWyFxxi5jGophWU4/I6He2rJ4mh0TKL9y+7qyvQsukgaC/rk4xKHNDpIYHWlZmrrU2oJq2RuIH2E+Q5pTJ/J5tBoUhnS0PNNAmqu/6xCQLOsEb0IVTq+f]]></Encrypt>
</xml>

XML属性解释

属性 含义
crmStatus 把CRM数据发送到第三方的API接口 1：访客在信息收集窗口填写了数据，对话开始后会自动触发2：客服手动在一洽CRM系统填写了客户信息 3：客户进行分配
staffId 发送数据的客服人员ID
staffLogname 发送数据的客服人员登录用户名
staffName 发送数据的客服人员姓名

crmData（CRM数据）

属性 含义
visitorId 访客的唯一值 例如：web123456
category 客户类别 例如：意向客户
name 客户姓名 例如：王宝强
nickName 客户的昵称 例如：宝宝
gender 性别，0-未知， 1-男， 2-女
age 年龄
birthday 客户生日 例如：2015-08-01
maritalStatus 婚姻状况 1：未婚 2：已婚 0：未知
phone 客户电话号码
qq 客户qq号码
wechat 客户微信号
email 客户邮箱地址
nation 客户所在国家
province 客户所在省份
city 客户所在城市
address 客户地址
photo 客户头像地址
c1-c20 客户自定义字段
memo 客户信息备注

注：客服更新操作为保证及时性一洽每更新一个字段就会向数据接收方post一条数据 例如：修改姓名为空

<xml>
<crmStatus><![CDATA[2]]></crmStatus>
<visitorId><![CDATA[1314521]]></visitorId>
<staffId><![CDATA[14]]></staffId>
<staffLogname><![CDATA[18098933897]]></staffLogname>
<staffName><![CDATA[郑丽文]]></staffName> 
<crmData>
<visitorId><![CDATA[1314521]]></visitorId>
<name><![CDATA[]]></name>
</crmData>
</xml>

3.4 浏览数据
访客进入企业网站到离开企业网站，一洽回向数据接收方推送三种数据:访客进入、访客离开、访客轨迹

3.4.1访客进入
GET参数追加：dataType=visitorEnter
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=visitorEnter

POST内容：对话开始的XML信息
明文XML示例：

<xml>
<routeStatus><![CDATA[1]]></routeStatus>
<myData><![CDATA[network=wifi&game=斗地主&ver=9.2&os=ios10]]></myData> 
<metaData>
<uid><![CDATA[1314521]]></uid>
<grade><![CDATA[1]]></grade>
<category><![CDATA[金牌会员]]></category>
<name><![CDATA[王宝强]]></name>
<nickName><![CDATA[宝宝]]></nickName>
<gender><![CDATA[男]]></gender>
<age><![CDATA[36]]></age>
<birthday><![CDATA[2015-08-01]]></birthday>
<maritalStatus><![CDATA[2]]></maritalStatus>
<phone><![CDATA[18990987546]]></phone>
<qq><![CDATA[9876389]]></qq>
<wechat><![CDATA[echatsoft]]></wechat>
<email><![CDATA[9876389@qq.com]]></email>
<nation><![CDATA[中国]]></nation>
<province><![CDATA[广东]]></province>
<city><![CDATA[深圳]]></city>
<address><![CDATA[深南大道金融街]]></address>
<photo><![CDATA[http: // www.baidu.com/mypic.png]]></photo>
<memo><![CDATA[娱乐明星]]></memo>
</metaData> 
<visitorData> 
<visitorMedia><![CDATA[5]]></visitorMedia>
<visitorType><![CDATA[4]]></visitorType>
<visitorId><![CDATA[wechato6ohSwjIVENM7ZbBqPypRyu4D_zA]]></visitorId>
<visitorName><![CDATA[王宝强]]></visitorName>
<visitorPhoto><![CDATA[http:// wx.qlogo.cn/mmopen/WncXm]]></visitorPhoto>
<visitTimes><![CDATA[5]]></visitTimes>
<visitorLan><![CDATA[zh_CN]]></visitorLan>
<visitorIp><![CDATA[122.96.185.139]]></visitorIp>
<visitorCountry><![CDATA[中国]]></visitorCountry>
<visitorProvince><![CDATA[广东]]></visitorProvince>
<visitorCity><![CDATA[深圳]]></visitorCity>
<browserName><![CDATA[QQ浏览器]]></browserName>
<browserVersion><![CDATA[9.0]]></browserVersion>
<screenResolution><![CDATA[1920*1080]></screenResolution>
<osName><![CDATA[Windows]]></osName>
<osVersion><![CDATA[7]]></osVersion>
<se><![CDATA[baidu]]></se>
<keyword><![CDATA[在线客服软件]]></keyword>
<referPage><![CDATA[http://www.baidu.com/baidu.php?sc.WwCK00j7A0GeyEPIcgU]]></referPage>
<firstTime><![CDATA[2016-01-09 17:53:32]]></firstTime>
<firstPage><![CDATA[http://wx.qlogo.cn/mmopen]]></firstPage>
<firstPageTitle><![CDATA[一洽软件的价格]]></firstPageTitle>
<lastChatTime><![CDATA[2015-07-08 11:23:36]]></lastChatTime>
<lastChatStaffId><![CDATA[14]]></lastChatStaffId>
<lastChatStaffLogname><![CDATA[218098933897]]></lastChatStaffLogname>
<lastChatStaffName><![CDATA[郑丽文]></lastChatStaffName>
</visitorData> 
<routeData> 
<routeId><![CDATA[72]]></routeId>
<routeName><![CDATA[一洽]]></routeName>
<styleId><![CDATA[201]></styleId>
<styleName><![CDATA[一洽网站]]></styleName>
<chatDepartmentId><![CDATA[11]]></chatDepartmentId>
<chatDepartmentName><![CDATA[订单组]]></chatDepartmentName>
</routeData> 
<trackData>
<trackRecordId>123456</trackRecorId>
<visitTimes>3</visitTimes>
</trackData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[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]]></Encrypt>
</xml>

XML属性解释

属性 含义
routeStatus 访客进入时该路由客服的状态, 1:在线 2：离线
myData 开发者自定义扩展数据，如果打开对话时加了这个参数则传递该数据
metaData （会员数据，如果是会员则传递该数据），同对话开始数据中的metaData
visitorData 访客数据，同对话开始数据中的visitorData
routeData 路由数据，同对话开始数据中的routeData

trackData（浏览数据）

属性 含义
trackRecordId 此次浏览轨迹的ID，浏览记录唯一值
visitTimes 当前访客此次是第几次来访

3.4.1.1 关键字数据

百度屏蔽了竞价和SEO的关键字传递，一洽可通过和百度的合作对关键字数据进行抓取，在获取到访客的搜索关键字后会单独下发给开发者。

事件类型：keywordReturn

请求地址实例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=keywordReturn

POST内容：访客关键字xml数据
明文XML实例：

<xml>
    <msgId><![CDATA[37122226]]></msgId>
    <tm><![CDATA[1563867929683]]></tm>
    <trackRecordId>123456</trackRecorId>
    <se><![CDATA[baidu]]></se>
    <keyword><![CDATA[深圳大学]]></keyword>
    <keywordType><![CDATA[1]]></keywordType>
</xml>

XML属性解释：

属性 含义
trackRecordId 此次浏览轨迹的ID，浏览记录唯一值,和visitorEnter中的ID关联后补充关键字信息
se 访客来访的搜索引擎 例如：baidu   微信对话无此属性
keyword 访客来访的搜索关键字 例如：一洽软件   微信对话无此属性
keywordType 点击类型， 1：SEO 2：竞价

3.4.2访客离开
GET参数追加：dataType=visitorOut
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=visitorOut

POST内容：对话结束的XML信息
明文XML示例：

<xml>
    <routeStatus>2</routeStatus>
    <trackData>
        <trackRecordId>18198</trackRecordId>
        <visitPageCount>1</visitPageCount>
        <visitTotalTime>262728</visitTotalTime>
        <chatRecordId><![CDATA[1_12024,3_2800,3_2801,5_1498]]></chatRecordId>
        <giveupRecordId><![CDATA[21584,21585,21586]]></giveupRecordId>
    </trackData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[gUHc0D73LA5oHk+mfxqebcitJQGnoIUjYfSt2OzBIhoGQ3WU8RP0hVDFusA2CJN+wpZl4Wn/0wwjrK9+Nq4bP5+J8D1iSr610av5rvBrWPqV+ukvQYKR13msx7h/xDCBRu6txKQvgXVcTMiYZgj93mP/zWm9DU8ltWr8cZPwP1Xta692Qz1CSjInxuh2QC0dtVuL+3/abqvG7ZB6ZYhruvfQOD4VxHe6QfyBYWszgn+ptxB6drMWn8IHzed0L9MbCZcpk7jLv1pltsnpYJIcPfOrA5Tu9/gqfdj1HbjXkbrht8dWuKUTv+J+qavZVhH7epOwzJS5BMJuW55vntHHoQmNIKo5Okygy5UDL/mE2NLjaA3zKjVdL3TZdEip4FKAiRQORS964Th4TT3bz6SApg8XtCc6jsnhQ7vB5/kzkPJn55rHma+1ScOoJVJeYgyipOXqLK2I+qwbBeCIYkiaVkdDiUeu29w7s94Tqf7mL9LspnMRqTvadAsXanbdnFWeMDRhYk+iLUPfYs1lzH7uZg+Hzxbpw2fOzOjuZegK1mCCJyaW0jxY6JiFcUVc7pHYGLh28dsj09Fk4JQ30K6wuXwbOf8sJRbXCOeg4ta2xgZk011G0jTF4AtT7MVkbwVfaYtX5s2pUHqriqYpmCOqQbpQl1c31Y8FU2Ee7oFKEoZx2Az5e/sHECvExhYwywCi5cBEY+a6skfOAqxjoYM29HXyMkHWoVx8IVu2lT03N9DE2t1oXBVx6xpehHs1/x2cAAu+LpgXy/7ORxD6MnY6hYfRcbEnE1d5xQP14+6Q2pRLn3EhCvVqSfwK4Vpv/U+/DOW0AeVytf2qM+g3HG7ljof+YxahjFQpMa0Z//SCNlXqjQsJ+Z3TtraBijxNkIN1VVPYCErJyfQw3PTL20frPOENj2gCwIkX2NefTUoAozQg92gkwKXGAdgvWcPVnmE/9h4Qg7snaoxOiRkCd3jp9iJjfKtqJr4i+2GHRtUJ0l8a2lmKDtQI1+2mQx1F0NotM7vXLKo24DiaQJsR2qr5cs2HTl1hVPV6/sAX0fc12sRfurcOCgOcusEk4F2KzsNGeUWM0DAQCWTLYLelAIs1Mnciz0M/G2fGEV9Utgbjcd2gO/8p4vdt5gTERUIbNNKNAWbaY6ZK+HXqdtcCXgi9Z8jXXCCfBz+DtmCdToNOBgG8XJ2/XhhCBSpVemf0TCSUkmPvAP1po130JO/JP1P0gDxMiIIfn/VbCqOqHaXIRf725UtK1tZ5M9mD12wDP2mzt14WpXiwHC45XZCzzQPPt828YceTQYsLU0N+B3xM9xM1EzgQj1uYo41Rdn7C8pVJfvcPCy2WDyJAg6CNgJ6pY1EbT7nB4p4z3UcCMA73BjTkgzoBX3KMHdln3I8bz8bHucGda4omev1w60ZFbmgoZIcvBSnU35td/waAtdaH1pQaIs33lRRQ14/hY9JY3900yJKuGYvTKjpNvJCl7Fx8dnjp+OxhcfAlfCnzKj1P8Nvj+hypzjULU188nby8t07v59avszMEM3yqhBEluL04Yo9aAEaAE2qTFLXe/h1yKX5h61aFq6bBnnH/PA/XQWTDz8hwX3wyVZKWRcfnFCqlpg==]]></Encrypt>
</xml>

XML属性解释

属性 含义
routeStatus 访客退出时，此路由的状态
trackRecordId 此次浏览轨迹的ID，浏览记录唯一值
visitPageCount 访客退出时此次浏览页面的数量
visitTotalTime 此次浏览页面访客的总浏览时长 单位：秒
chatRecordId 整个会话范围过程产生的人工对话的ID、机器人对话的ID、留言对话的ID 列表
giveupRecordId 整个会话范围过程中，访客点击对话，弹出信息收集框但访客最终未进入对话的，放弃的记录ID，记录ID是点击的ID，和对话记录留言记录的ID不是同一个数据

3.4.3 轨迹数据
GET参数追加：dataType=visitorTrackPage
请求地址示例：

http://api.myserver.com/echatDataReceiver?timestamp=myTimestamp&nonce=myNonce&signature=81ceaac69a2f44be4f98d4adbea202d5792c62bb&dataType=visitorTrackPage

POST内容：对话评估的XML信息
明文XML示例：

<xml>
    <trackData>
        <trackRecordId>17949</trackRecordId>
        <visitPageDatas>
            <pageData>
                <visitTime><![CDATA[2018-01-31 10:51:34]]></visitTime>
                <pageUrl><![CDATA[http://www.echatsoft.com]]></pageUrl>
                <pageTitle><![CDATA[最近浏览]]></pageTitle>
                <pageUrlAlias><![CDATA[页面别名]]</pageUrlAlias>
            </pageData>
            <pageData>
                <visitTime><![CDATA[2018-01-31 10:51:36]]></visitTime>
                <pageUrl><![CDATA[http://www.echatsoft.com]]></pageUrl>
                <pageTitle><![CDATA[最近浏览]]></pageTitle>
            </pageData>
        </visitPageDatas>
    </trackData>
</xml>

密文XML示例：

<xml>
<Encrypt><![CDATA[pcf0D1yQAvtOjRmwjkxHLuIjUFmA3AP+A2YKXxIerq5p/lh7URAmAXsxXJUJ4wu8kOkW/JGB9dyf7qmJYXMmv2TIyWSmDhhK1GXhZUHHBTyyWHieZaBUBPkT5EG3Vb/vX5amZE63vJllzyvDB9JD5MLoOyCS8O5JkPAWrVBGdFoa8VAEjEJHdSlDabyJ8h7QxX40z7002eAbZjwPtschrtVQjZd5j4U1e/NE5ryXq2jwljAC1WZHJb2F1K3nv+tKZuYQDltFxcE1LMA1m/b62allzqZ0ChYPsonSVcT7WtGLZAKqZktjO922qmsmfMeLBW4mO2Nw+D767W+9BUnucA==]]></Encrypt>
</xml>

XML属性解释

属性 含义
trackRecordId 此次浏览轨迹的ID，浏览记录唯一值
visitPageDatas 此次浏览的页面轨迹列表

pageData(浏览页面的信息)

属性 含义
visitTime 访问时间 格式：yyyy-MM-dd HH:mm:ss
pageUrl 访问页面的地址
pageTitle 访问页面的标题
pageUrlAlias 此页面的别名

4. demo代码下载

说明：可下载对应语言的demo工程，直接在项目上修改即可快速实现会员接入以及业务系统对接。
4.1 JAVA demo下载
下载地址：java demo