1. 使用说明

欢迎使用“AICC”的在线客服事件推送服务。开发者可以通过配置事件推送，在平台触发指定事件时，将相关事件内容推送到指定的地址。

2. 推送设置

名称 描述

推送地址

事件内容推送的目的地址。

推送类型

推送的事件类型，即触发推送的时机，推送类型。

超时时间

根据需要设置超时时间，超时之后会认为请求失败。

重试次数

失败后重试次数，当为0时表示不进行重试。

推送方式

HTTP请求方式，支持GET、POST两种方式。

推送参数

推送的事件中的具体参数信息。

配置示例

image

3. 推送类型

类型 描述

会话开始

会话开始时触发该事件推送。

接通客服

接通座席时触发该事件推送。

会话结束（即将下线）

会话结束时触发该事件推送。

进入排队

会话进入排队时触发该事件推送。

排队位置

排队位置变更时触发该事件推送。

留言事件

进入留言时触发该事件推送。

邀请评价

邀请评价时触发该事件推送。

消息事件

座席或访客发送消息时触发该事件推送。

座席状态

座席状态发生变化时触发该事件推送。

接入机器人

会话接入机器人时触发该事件推送。

分支节点

会话路由进入分支节点时触发该事件推送。

已读事件

会话消息已读时触发该事件推送。

视频客服

视频客服接通、挂断、生成视频记录时触发该事件推送。

座席工作台客户资料保存

座席工作台客户资料保存时触发该事件推送。

从会话事件

会话接入机器人或人工座席时触发该事件推送。

会话结束（新）

会话结束时触发该事件推送。

4. 推送参数

4.1. 会话开始

推送参数

名称

类型

描述

enterpriseId

Integer

企业ID，租户唯一标识。
示例: 8888888

appId

String

接入号ID，说明参见: 通用参数。
示例: "d51d8423-*-***-8ced-6bf09b814040"

appName

String

接入号名称，与appId对应。
示例: "测试网页"

contactType

Integer

接入渠道，说明参见: 通用参数。
示例: 2

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

cno

String

座席号，坐席主动发起会话时才有该字段。
示例: "0001"

clientName

String

座席名称，坐席主动发起会话时才有该字段。
示例: "售后服务咨询专员"

visitorId

String

访客ID，访客唯一标识ID。
示例: "0001"

visitorName

String

访客姓名。
示例: "访客"

externalRoomId

String

企微外部群ID/企微联系人openId，只在企微渠道生效。
示例: "wo6302C****S5893IA"

qwkfChatType

Integer

企微客服会话方式，只在企微渠道生效。1：单聊、2：群聊。
示例: 1

推送示例

{
    "visitorName": "访客",
    "appName": "测试网页",
    "appId": "d51d8423-****-***-8ced-6bf09b814040",
    "contactType": 2,
    "enterpriseId": 8888888,
    "sessionId": "182106e5-****-****-55c119928486.1688990235",
    "visitorId": "0001",
    "cno": "0001",
    "clientName": "售后服务咨询专员"
}

4.2. 会话结束（即将下线）

推送参数

名称 类型 描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

closeType

Integer

会话关闭类型，1：系统关闭、2：座席关闭、3：访客关闭。 示例: 2

reason

Integer

会话结束原因，说明参见: 通用参数。
示例: 5

contactType

Integer

接入渠道，说明参见: 通用参数。
示例: 2

appName

String

接入号名称，与appId对应。
示例: "测试网页"

startTime

Long

会话开始时间戳（单位: 秒）。
示例: 1713775681

endTime

Long

会话结束时间戳（单位: 秒）。
示例: 1713775815

visitorId

String

访客ID，访客唯一标识ID。
示例: "0001"

visitorName

String

访客姓名。
示例: "访客"

robotId

String

机器人客服ID。
示例: "0001"

robotName

String

机器人客服名称。
示例: "售后咨询机器人客服"

robotStartTime

Long

机器人客服接入会话时间戳（单位: 秒）。
示例: 1713775707

robotEndTime

Long

机器人客服结束会话时间戳（单位: 秒）。
示例: 1713775721

qno

String

接入队列号。
示例: "0001"

queueName

String

队列名称。
示例: "售后服务咨询队列"

cno

String

接待座席号。
示例: "0001"

clientName

String

座席名称。
示例: "售后服务咨询专员"

joinQueueTime

Long

访客进入队列时间戳（单位: 秒）。
示例: 1713773808

bridgeTime

Long

座席接入会话时间戳（单位: 秒）。
示例: 1713775721

keys

Integer

满意度评价，满意度评价值-根据满意度配置，取值范围1-5，表示一星、二星等。
示例: 5

remark

String

满意度评价备注，评价满意度时，访客进行的备注内容。
示例: "您的服务真棒！"

ip

String

访客IP，访客发起会话时所获取的IP值。
示例: "127.0.0.1"

customerRegion

String

访问地区，进行解析获得。
示例: "四川.成都"

chatTimes

Long

会话次数，该访客在过去半年内进行过会话的次数，按照当前会话开始时间之前计算。
示例: 14

invitedTimes

Long

被邀请次数，该访客在过去半年内被邀请会话次数，按照当前会话开始时间之前计算。
示例: 0

searchWord

String

搜索词，通过对来源页解析，获取搜索参数参数。
示例: "售后服务"

sessionType

Integer

会话类型，1：未接入会话、2：有效会话、3：无效会话、4：留言会话。
示例：2

durationType

String

会话接待类型描述，如人工独立接待、机器人转人工等，说明参见: 通用参数。
示例: "人工独立接待"

os

String

操作系统，参看eu.bitwalker.useragentutils.OperatingSystem。
示例: "Windows 10"

browser

String

浏览器型号，参看eu.bitwalker.useragentutils.OperatingSystem。
示例: "Chrome 113.0.0.0"

refererName

String

访客来源，通过对来源页解析，获取搜索引擎。
取值: 360搜索、百度、必应、谷歌、MSN、搜狗、雅虎、神马
示例: "必应"

refererUrl

String

来源页，访客通过其他页面跳转到在线客服页面，获取的这次请求原地址及参数信息。
示例: "https://cn.bing.com?q=售后服务"

firstVisitPageUrl

String

着陆页，访客在浏览嵌入在线客服网页渠道页面时，当前浏览器地址框地址。
示例: "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN
&visitorId=001&visitorExtraInfo=\{\"客户名称\":\"测试\",\"电话\":\"157****5411\"}"

initiationPageUrl

String

会话发起页，访客从某个页面发起会话时，当前页面浏览框地址。
示例: "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN
&visitorId=0001&visitorExtraInfo=%5C%7B%5C%22%E5%AE%A2%E6%88%B7%E5
%90%8D%E7%A7%B0%5C%22:%5C%22%E6%B5%8B%E8%AF%95%5C%22,%5C%22%E7%94
%B5%E8%AF%9D%5C%22:%5C%22157****5411%5C%22%7D" "

taskEngineTags

String

机器人标签，配置指定的机器人标签后，如果命中则解析后推送。 示例: "VIP客户"

visitorExtroInfo

String

自定义参数，会根据自定义参数从visitorExtraInfo中解析后推送。 示例: 配置参数名和参数遍历为"客户名称"，则推送"客户名称": "测试"

repeatVisit

Integer

重复进线，24：24小时内重复进线、48：48小时内重复进线 72：72小时内重复进线。 示例: 24

推送示例

{
    "reason": 5,
    "repeatVisit": 24,
    "clientName": "售后服务咨询专员",
    "keys": 5,
    "robotStartTime": 1713775707,
    "contactType": 2,
    "remark": "您的服务真棒",
    "refererUrl": "https://cn.bing.com?q=售后服务",
    "durationType": "机器人转人工",
    "visitorName": "访客",
    "joinQueueTime": 1713775721,
    "browser": "Chrome 113.0.0.0",
    "sessionType": 2,
    "startTime": 1713775681,
    "initiationPageUrl": "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN&visitorId=001&visitorExtraInfo=%5C%7B%5C%22%E5%AE%A2%E6%88%B7%E5%90%8D%E7%A7%B0%5C%22:%5C%22%E6%B5%8B%E8%AF%95%5C%22,%5C%22%E7%94%B5%E8%AF%9D%5C%22:%5C%22157****5411%5C%22",
    "os": "Windows 10",
    "cno": "0001",
    "robotName": "售后咨询机器人客服",
    "appName": "测试网页",
    "ip": "127.0.0.1",
    "customerRegion": "四川.成都",
    "sessionId": "182106e5-***-***-55c119928486.1688990235",
    "invitedTimes": 0,
    "closeType": 2,
    "robotId": "0001",
    "bridgeTime": 1713775721,
    "qno": "0001",
    "queueName": "售后服务咨询队列",
    "客户名称": "测试",
    "endTime": 1713775815,
    "firstVisitPageUrl": "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN&visitorId=001&visitorExtraInfo={\"客户名称\":\"测试\",\"电话\":\"157****5411\"}",
    "robotEndTime": 1713775721,
    "chatTimes": 14,
    "visitorId": "0001"
}

4.3. 分支节点

推送参数

名称 类型 描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

content

String

分支节点引导语拼接配置的变量列表名称
示例: "欢迎咨询，请问您有什么疑问？\n1、售后服务咨询队列\n2、售前服务咨询队列\n3、留言"

switchValue

List<Node>

分支节点配置的变量列表
示例: "[{"id":1,"value":"售后服务咨询队列","next":"xxxxx"}]"

Node详解

名称 类型 描述

id

Long

分支节点选项id。
示例值: 1

value

String

分支节点选项名称。
示例值: "售后服务咨询队列"

next

String

分支节点选项出口路由节点编号。
示例值: "xxxxx"

推送示例

{
    "switchValue": [
        {
            "id": 1,
            "value": "售后服务咨询队列",
            "next": "xxxxx"
        },
        {
            "id": 2,
            "value": "售前服务咨询队列",
            "next": "yyyyy"
        },
        {
            "id": 3,
            "value": "留言",
            "next": "zzzzz"
        }
    ],
    "sessionId": "182106e5-***-***-55c119928486.1688990235",
    "content": "欢迎咨询，请问您有什么疑问？\n1、售后服务咨询队列\n2、售前服务咨询队列\n3、留言"
}

4.4. 进入排队

推送参数

名称 类型 描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

qno

String

接入队列号。
示例: "0001"

queueName

String

队列名称。
示例: "售后服务咨询队列"

joinQueueTime

Long

访客进入队列时间戳（单位: 秒）。
示例: 1714976239

location

String

当前排队位置。 示例: "2"

onlineStatus

Integer

访客在线状态，1：在线、0：离线。 示例: 1

推送示例

{
    "qno": "0001",
    "queueName": "售后服务咨询队列",
    "joinQueueTime": 1714976239,
    "location": "2",
    "sessionId": "182106e5-***-***-55c119928486.1688990235"
}

4.5. 接入机器人

推送参数

名称

类型

描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

robotId

String

机器人客服ID。
示例: "0001"

robotNickName

String

机器人客服名称。
示例: "售后咨询机器人客服"

推送示例

{
    "robotNickName": "售后咨询机器人客服",
    "sessionId": "182106e5-***-***-55c119928486.1688990235",
    "robotId": "0001"
}

4.6. 接通客服

推送参数

名称

类型

描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

appId

String

接入号ID，说明参见: 通用参数。
示例: "d51d8423-*-***-8ced-6bf09b814040"

appName

String

接入号名称，与appId对应。
示例: "测试网页"

contactType

Integer

接入渠道，说明参见: 通用参数。
示例: 2

visitorId

String

访客ID，访客唯一标识ID。
示例: "0001"

visitorName

String

访客姓名。
示例: "访客"

qno

String

接入队列号。
示例: "0001"

queueName

String

队列名称。
示例: "售后服务咨询队列"

cno

String

接待座席号。
示例: "0001"

clientName

String

座席名称。
示例: "售后服务咨询专员"

startTime

Long

会话开始时间戳（单位: 秒）。
示例: 1714983583

clientStartTime

Long

坐席接通会话开始时间戳（单位: 秒）。
示例: 1714983587

onlineStatus

String

访客在线状态 1：在线、0：离线。
示例: 1

headerUrl

String

访客头像地址，非网页渠道时存在该字段，如企微客服、微信客服等渠道。
示例: "http://wx.qlogo.cn/mmhead/xxx/0"

推送示例

{
    "cno": "0001",
    "clientName": "售后服务咨询专员",
    "appName": "测试网页",
    "contactType": 2,
    "sessionId": "182106e5-***-***-55c119928486.1688990235",
    "visitorName": "访客",
    "qno": "0001",
    "queueName": "售后服务咨询队列",
    "clientStartTime": 1714983587,
    "appId": "d51d8423-***-***-8ced-6bf09b814040",
    "startTime": 1714983583,
    "visitorId": "0001"
}

4.7. 邀请评价

推送参数 参数变量 参数说明

sessionId

sessionId

会话ID

sessionDetailUniqueId

sessionDetailUniqueId

从会话ID

enabled

enabled

满意度开启状态，0：关闭 1：开启

welcome

welcome

满意度引导语

starType

starType

星级描述类型 2:二级 3:三级 4:四级 5:五级(默认)

wxwbEvaluationType

wxwbEvaluationType

微信微博评价展示方式 1：h5页面（默认）2：数字回复

star

star

满意度星级描述（对象数组类型）

chatSatisNumEvaluation

chatSatisNumEvaluation

满意度数字回复配置

content

content

满意度多维度选项内容

remark

remark

是否打开评价备注,0：关、1：开

remarkContent

remarkContent

评价备注提示内容

evaluationType

evaluationType

评价方式，1：对话结束后弹出、2：客服主动发起邀请 3：必定发送满意度调查（包含前面两种情况，如果客服没有主动邀请，则在会话结束后自动弹出）

chatSatisSolveState

chatSatisSolveState

解决状态配置

star对象

推送参数 参数变量 参数说明

star

star

星级，1对应一星

desc

desc

星级描述

chatSatisNumEvaluation对象

推送参数 参数变量 参数说明

scoreOrder

scoreOrder

1、分值越小代表越满意(如1分代表非常满意）2、分值越大代表越满意(如5分代表非常满意)

descOrder

descOrder

1、由满意到不满意进行展示和选择 2、由不满意到满意进行展示和选择

content对象

推送参数 参数变量 参数说明

name

name

满意度名称

star

star

星级配置

chatSatisSolveState对象

推送参数 参数变量 参数说明

enabled

enabled

是否启用，0：否、1：是，默认值：0

required

required

是否必填，0：否、1：是，默认值：0

4.8. 留言事件

推送参数 参数变量 参数说明

sessionId

sessionId

会话ID

content

content

留言提示消息

4.9. 消息事件

推送参数 参数变量 参数说明

sessionId

sessionId

会话ID

sender

sender

消息发送人

sendName

sendName

消息发送人名称

senderType

senderType

消息发送人类型

sendStatus

sendStatus

消息发送状态。1：正常、2：包含敏感词、4：发送失败、5：离线推送

messageId

messageUniqueId

消息唯一标识ID

messageType

messageType

消息类型

content

content

文本消息内容

fileUrl

fileUrl

文件类型消息文件访问地址

enterpriseId

enterpriseId

企业ID

createTime

createTime

消息时间

recipient

recipient

消息接收人

recipientName

recipientName

消息接收人名称

sensitiveWord

sensitiveWord

包含敏感词内容

4.10. 座席工作台保存客户资料

推送参数 参数变量 参数说明

id

id

客户名称

name

name

客户名称

tel

tel

客户号码

level

level

客户登记，0:普通，1:VIP

shareType

shareType

归属类型，0：全体共享、1：队列共享、2：座席私有、3：无归属

share

share

客户归属，当为队列共享时为队列号，当为座席私有时为座席号，队列共享或者座席私有时必传

sex

sex

客户性别,0：男 ，1女

email

email

邮箱

cRemark

cRemark

备注

address

address

地址

mainUniqueId

mainUniqueId

会话ID

contactType

contactType

接入渠道 1：微信、2：网页、3：座席、4：小程序、5：微博、6：企业微信、7：百度营销、8：SDK、9：微信客服（独立版）、10：第三方接入、11：移动端、12：企微客服渠道、13：飞书渠道、19：微信客服（联合版）

appName

appName

接入渠道名称

startTime

startTime

会话开始时间

visitorId

visitorId

访客ID

visitorName

visitorName

访客姓名

robotId

robotId

机器人客服ID

robotName

robotName

机器人客服名称

robotStartTime

robotStartTime

机器人客服接入时间

robotEndTime

robotEndTime

机器人客服关闭时间

qno

qno

队列号

queueName

queueName

队列名称

cno

cno

座席号

clientName

clientName

座席名称

joinQueueTime

joinQueueTime

转接队列时间

bridgeTime

bridgeTime

接入时间

keys

keys

满意度评价

remark

remark

满意度评价备注

ip

ip

访客IP

customerRegion

customerRegion

访问地区

chatTimes

chatTimes

会话次数

invitedTimes

invitedTimes

被邀请次数

searchWord

searchWord

搜索词

os

os

操作系统

browser

browser

浏览器型号

refererName

refererName

访客来源

refererUrl

refererUrl

来源页

firstVisitPageUrl

firstVisitPageUrl

着陆页

initiationPageUrl

initiationPageUrl

会话发起页

visitorExtraInfo

visitorExtraInfo

自定义字段

4.11. 座席超时未回复告警

推送参数 参数变量 参数说明

queueName

queueName

告警队列

clientName

clientName

接待座席

clientAlarmField

clientAlarmField

告警字段

mainUniqueId

mainUniqueId

会话ID

clientAlarmThreshold

clientAlarmThreshold

告警阈值

clientAlarmNowValue

clientAlarmNowValue

现数值

clientTimeoutTime

clientTimeoutTime

开始时间

alertText

alertText

告警内容

4.12. 已读事件

推送参数 参数变量 参数说明

mainUniqueId

mainUniqueId

会话ID

messageUniqueIds

messageUniqueIds

消息事件唯一标识ID集合 例：messageUniqueIds：["5abeb5d1-0fc6-4c97-8d6d-0df781fe4c98","89e79735-ee4a-4f83-9c50-7784f73582f4"]

enterpriseId

enterpriseId

企业ID

appId

appId

接入号ID

appName

appName

接入号名称

contactType

contactType

接入渠道类型

contactName

contactName

接入渠道名称

readTime

readTime

已读时间（毫秒值）

4.13. 从会话事件

推送参数 参数变量 参数说明

mainUniqueId

mainUniqueId

主会话 ID

uniqueId

uniqueId

从会话id

chatDetailType

chatDetailType

从会话类型

cno

cno

座席号 若从会话类型为机器人，该字段为机器人ID

clientName

clientName

受理座席名称 若从会话类型为机器人，该字段为机器人名称

inviteeCno

inviteeCno

被邀请座席

inviteeName

inviteeName

被邀请座席名称

startTime

startTime

从会话开始时间 秒级时间戳 例：1692784198

endTime

endTime

从会话结束时间 秒级时间戳 例：1692784198

receiveDuration

receiveDuration

从会话接待时长 秒

4.14. 座席状态事件

推送参数 参数变量 参数说明

enterpriseId

enterpriseId

企业 ID

cno

cno

座席号

clientName

clientName

座席姓名

status

status

座席状态 1: 空闲, 2:置忙 4:离开 0: 离线

statusBeginTime

statusBeginTime

状态开始时间，时间戳，精确到秒

pauseType

pauseType

座席置忙类型 1:置忙, 2:休息, 3:IM, 4:强制, 5:企微同步 6:审批；可能为空

pauseDescription

pauseDescription

座席置忙状态描述，只有置忙状态值才有值；可能为空

lastStatus

lastStatus

上一次座席状态。多保留 30 天，超出 30 天返回空；可能为空

lastPauseDescription

lastPauseDescription

上一次座席置忙状态描述。可能为空，最多保留 30 天，超出 30 天返回空

lastPauseType

lastPauseType

上一次座席置忙类型。可能为空，最多保留 30 天，超出 30 天返回空

lastStatusBeginTime

lastStatusBeginTime

上一次座席状态开始时间，时间戳，精确到秒。可能为空，最多保留 30 天，超出 30 天返回空

lastStatusDuration

lastStatusDuration

上一次状态持续时长，单位秒；可能为空

4.15. 排队位置

推送参数

名称 类型 描述

sessionId

String

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

location

String

当前排队位置。 示例: "2"

locationText

String

提示文案。 示例: "排队中，您当前排在第几位，排到将自动接入"

推送示例

{
    "locationText": "排队中，您当前排在第2位，排到将自动接入",
    "location": "2",
    "sessionId": "182106e5-***-***-55c119928486.1688990235"
}

4.16. 会话结束（新）

推送参数

名称 类型 可空 描述

mainUniqueId

String

否     

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

closeReason

Integer

否

结束原因，说明参见: 通用参数。
示例: 6

contactType

Integer

否

来源渠道，说明参见: 通用参数。
示例: 2

appName

String

否

接入号名称，与appId对应。
示例: "测试网页"

startTime

Long

否

会话开始时间戳（单位: 秒）。
示例: 1713775681

endTime

Long

否

会话结束时间戳（单位: 秒）。
示例: 1713775815

visitorId

String

否

访客ID。
示例: "0001"

visitorName

String

否

访客名称。
示例: "访客"

firstQno

String

是

首次进线队列编号。
示例: "0001"

firstQname

String

是

首次进线队列名称。
示例: "售后服务咨询队列"

firstCno

String

是

首次接待座席工号。
示例: "0001"

firstCname

String

是

首次接待座席名称。
示例: "售后服务咨询专员"

ip

String

是

IP地址，访客发起会话时所获取的IP值。
示例: "127.0.0.1"

province

String

是

省份，访客访问省份，进行解析获得。
示例: "四川"

city

String

是

城市，访客访问城市，进行解析获得。
示例: "成都"

searchWord

String

是

搜索词，通过对来源页解析，获取搜索参数参数。
示例: "售后服务"

operatingSystem

String

是

操作系统，参看eu.bitwalker.useragentutils.OperatingSystem。
示例: "Windows 10"

browser

String

是

浏览器型号，参看eu.bitwalker.useragentutils.OperatingSystem。
示例: "Chrome 113.0.0.0"

searchEngine

String

是

访客来源，通过对来源页解析，获取搜索引擎。
取值: 360搜索、百度、必应、谷歌、MSN、搜狗、雅虎、神马
示例: "必应"

refererUrl

String

是

来源页，访客通过其他页面跳转到在线客服页面，获取的这次请求原地址及参数信息。
示例: "https://cn.bing.com?q=售后服务"

firstVisitPageUrl

String

是

着陆页，访客在浏览嵌入在线客服网页渠道页面时，当前浏览器地址框地址。
示例: "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN
&visitorId=001&visitorExtraInfo=\{\"客户名称\":\"测试\",\"电话\":\"157****5411\"}"

initiationPageUrl

String

是

会话发起页，访客从某个页面发起会话时，当前页面浏览框地址。
示例: "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN
&visitorId=0001&visitorExtraInfo=%5C%7B%5C%22%E5%AE%A2%E6%88%B7%E5
%90%8D%E7%A7%B0%5C%22:%5C%22%E6%B5%8B%E8%AF%95%5C%22,%5C%22%E7%94
%B5%E8%AF%9D%5C%22:%5C%22157****5411%5C%22%7D" "

repeatVisit

Integer

否

重复进线，0：未重复进线、24：24小时内重复进线、48：48小时内重复进线 72：72小时内重复进线。 示例: 24

receiveType

Integer

否

接待类型，0：流失会话、1：仅机器人、2：仅人工客服、3：机器人转人工
示例: 3

visitorExtraInfo

String

是

访客扩展信息，json字符串类型
示例: '\{"访客ID":"0001","phone":"138xxxxxxxx","访客名称":"四川成都0001"\}'

推送示例

{
    "firstCname": "售后服务咨询专员",
    "repeatVisit": 24,
    "city": "成都",
    "contactType": 2,
    "refererUrl": "https://cn.bing.com?q=售后服务",
    "operatingSystem": "Windows 10",
    "firstQname": "售后服务咨询队列",
    "visitorName": "访客",
    "province": "四川",
    "browser": "Chrome 113.0.0.0",
    "startTime": 1713775681,
    "visitorExtraInfo": {
        "访客ID": "0001",
        "phone": "138xxxxxxxx",
        "访客名称": "访客"
    },
    "firstQno": "0001",
    "closeReason": 6,
    "receiveType": 3,
    "initiationPageUrl": "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN&visitorId=0001&visitorExtraInfo=%5C%7B%5C%22%E5%AE%A2%E6%88%B7%E5%90%8D%E7%A7%B0%5C%22:%5C%22%E6%B5%8B%E8%AF%95%5C%22,%5C%22%E7%94%B5%E8%AF%9D%5C%22:%5C%22157****5411%5C%22%7D",
    "searchEngine": "必应",
    "appName": "测试网页",
    "ip": "127.0.0.1",
    "firstCno": "0001",
    "mainUniqueId": "182106e5-***-***-55c119928486.1688990235",
    "searchWord": "售后服务",
    "endTime": 1713775815,
    "firstVisitPageUrl": "https://www.xxxx.com/xxx.html?accessId=xxxx&language=zh_CN&visitorId=001&visitorExtraInfo={\"客户名称\":\"测试\",\"电话\":\"157****5411\"}",
    "visitorId": "0001"
}

4.17. 咨询流程

推送参数

名称 类型 可空 描述

mainUniqueId

String

否     

在线客服会话ID，同"mainUniqueId"，说明参见: 通用参数。
示例: "182106e5-*-***-55c119928486.1688990235"

ivrName

String

否     

在线客服路由导航名称 示例: "测试网页导航"

routes

List<Node>

否     

访客咨询流程列表。 示例: "[{"data":{"机器人ID":"0001","机器人名称":"售后咨询机器人客服"},"outRouteName":"TRANSFER0",
"startTime":1731463548959,"endTime":1731463565097,"routeType":4,"routeName":"售后咨询机器人"}]"

Node详解

名称 类型 可空 描述

routeName

String

否     

节点名称。 示例: "售后咨询机器人"

routeType

Integer

否     

节点类型。说明参见: 通用参数。
示例: 4

data

json字符串

是     

结果内容。 示例: "{"机器人ID":"0001","机器人名称":"售后咨询机器人客服"}"

outRouteName

String

是     

出口节点名称 。 示例: "TRANSFER0"

startTime

Long

否     

节点开始时间戳（单位: 毫秒）。
示例: 1731463548959

endTime

Long

否     

节点结束时间戳（单位: 毫秒）。
示例: 1731463565097

推送示例

{
    "routes": [
        {
            "data": {},
            "outRouteName": "",
            "startTime": 1731463548906,
            "endTime": 1731463548922,
            "routeType": 0,
            "routeName": "开始"
        },
        {
            "data": {
                "机器人ID": "0001",
                "机器人名称": "售后咨询机器人客服"
            },
            "outRouteName": "TRANSFER0",
            "startTime": 1731463548959,
            "endTime": 1731463565097,
            "routeType": 4,
            "routeName": "售后咨询机器人"
        },
        {
            "data": {
                "队列号": "0001",
                "队列名称": "售后服务咨询队列"
            },
            "outRouteName": "",
            "startTime": 1731463565120,
            "endTime": 1731464166608,
            "routeType": 1,
            "routeName": "售后服务咨询队列"
        }
    ],
    "ivrName": "测试网页导航",
    "mainUniqueId": "182106e5-***-**-55c119928486.1688990235"
}

5. 字段值说明

5.1. 渠道类型-contactType

值 描述

1

微信公众号渠道

2

网页渠道

4

微信小程序渠道

5

微博渠道

6

企业微信渠道

7

百度营销渠道

8

自定义渠道

9

微信客服（独立版）渠道

10

第三方接入渠道

11

APP渠道

12

企微客服渠道

13

飞书渠道

14

抖音企业号渠道

15

小红书

19

微信客服（联合版）渠道

5.2. 会话关闭类型-closeType

值 描述

1

系统关闭

2

座席关闭

3

访客关闭

4

机器人关闭

5.3. 会话关闭原因-reason

值 描述

1

队列已满

2

无可用座席

3

留言结束

4

满意度结束

5

座席关闭

6

访客关闭

7

系统超时关闭

8

非工作时间关闭

9

机器人关闭

10

系统关闭

11

排队放弃关闭

12

排队超时关闭

5.4. 消息发送人类型-senderType

值 描述

1

座席消息

2

访客消息

3

系统消息 注：欢迎语、介绍语、座席锁定会话超时自动应答语、排队安抚语、满意度邀请

4

机器人消息

6

引导语消息

5.5. 消息类型-messageType

值 描述

1

文字

2

图片

3

文件

4

视频

5

html富文本

6

机器人按钮-选项

7

语音

8

知识库文件

10

商品卡片

11

订单卡片

12

留言

13

小程序链接卡片

14

机器人组合消息

15

机器人相关问

16

机器人猜你想问

17

机器人常见问

18

机器人近似问

19

机器人推荐问

20

机器人常见问（分类）

26

菜单消息

27

满意度消息

28

满意度评价结果

29

机器人订单卡片消息

30

机器人快捷回复消息

31

机器人热点问题纵向

32

机器人图文消息

5.6. 重复进线-repeatVisit

值 描述

0

未重复进线

24

24h有效会话的重复进线

48

48h有效会话的重复进线

72

72h有效会话的重复进线

5.7. 从会话类型-chatDetailType

值 描述

1

直接接通

2

转移座席

5

机器人

6

群聊/三方

7

排队面板处理

8

排队面板分配

9

超时自动转移

10

机器人面板处理

11

强制转移

12

座席主动发起会话