在线客服推送

接入方式

登录云客服系统，进入“设置”-“对接中心”，选择“在线事件”，配置一条事件类型为“消息推送事件”的配置即可。

目前支持6类消息的推送：

消息分类	说明
创建会话	用户发起一个新会话时，会推送此消息（包含来源、时间等信息）
结束会话	座席完成一个会话时，会推送此消息（包含结束原因）
消息给座席	包含客户和系统给座席发送的消息
消息给客户	包含座席和系统给客户发送的消息
系统消息	当系统发送消息给访客时产生的消息，如会话提示等
会话分配	会话转人工被座席接待时产生的消息，包含该会话的座席id、访客id等信息

推送格式

字段	数据类型	名称	描述
eventUniqueId	String	消息唯一id
msgTime	String	消息时间	调用回调结果时，赋予的时间（格式：yyyy-MM-dd HH:mm:ss）
msgType	String	消息类型	createSession 创建会话closeSession 关闭会话msgToAgent 消息给座席msgToCustomer 消息给客户systemMsg 系统消息assignSession 会话分配
data	Object	消息内容	会话 / 消息的详细业务数据，子字段根据 msgType不同而变化：通用子字段（所有类型共享） `accountId`：账户 ID `agentId`：坐席 ID `agentNumber`：坐席工号 `beFrom`：来源端（如PC电脑端）`channelId`：渠道 ID `sessionId`：会话 ID `visitorId`：访客唯一标识

创建会话推送示例

{"msgType":"createSession",

"data":{"setTopTimestamp":0,"visitorBreakTimestamp":0,
"showCustomerName":false,"participatePending":false,"systemPushCsr":false,
"createTimestamp":1768792232864,"newSession":true,"lastVisitorMsgTimestamp":0,
"agentPushCsr":false,"lock":false,"otherParams":{},"toGroup":"10004093",
"redisRecordDelayTimestamp":1768792232909,"area":"中国 四川省 成都市","leakNum":0,
"manualTimestamp":1768792232909,"agentReplyMessageCount":0,"ip":"xxx.xxx.xxx.xx",
"lastRedirectTimestamp":0,"agentNumber":"9020","priority":false,"accountId":"1019",
"leaveSession":false,"lastClaimTimestamp":0,"endTimestamp":0,"status":"deal",
"visitorId":"1019@no2k7aIxRfRcIpii@tkt96h52@web","agentId":"1011823285425180672",
"convertManualTime":"2026-01-19 11:10:32","lastMessageTimestamp":1768792232867,
"visitorBreak":false,"visitorParams":{},"pushNoAgentMsg":false,
"agentClaimTimestamp":1768792232909,"visitorMessageCount":0,
"visitorName":"loyeu75idls5","osInfo":"Win10","serviceMan":"manual",
"lastRedirectAgentTime":0,"browser":"Chrome 143.0.0.0",
"recordConvertManualTimestamp":1768792232909,"lastAgentMessageTimestamp":0,
"channelId":"no2k7aIxRfRcIpii","beFrom":"pc","newVisitor":false,
"sessionId":"f772982f-71b7-4e7d-b4b7-307266e6aadc","showAnnexUrl":false,
"convertManualTimestamp":1768792232909,"createTime":"2026-01-19 11:10:32",
"totalMsgCount":0,"currentNodeId":"startNode","agentClaimTime":"2026-01-19 11:10:32",
"initiating":true,"processNodeId":"553491bb-d989-4498-9715-2bd05cc70fd3",
"manualTime":"2026-01-19 11:10:32"},

"msgTime":"2026-01-19 11:10:32","eventUniqueId":"5a846390-b267-4297-ae26-9b0ac3834226"}

创建会话data子字段说明：

字段	数据类型	名称	描述
setTopTimestamp	Number	会话置顶时间戳	会话被置顶的毫秒级时间戳
visitorBreakTimestamp	Number	访客断开时间戳	访客断开连接的毫秒级时间戳
showCustomerName	Boolean	是否显示客户姓名	标识是否在坐席端显示访客姓名
participatePending	Boolean	是否参与排队	标识会话是否进入了坐席排队队列
systemPushCsr	Boolean	是否系统推送客服	标识是否由系统自动推送会话给坐席
createTimestamp	Number	会话创建时间戳	会话创建的毫秒级时间戳
newSession	Boolean	是否为新会话	标识是否为一个全新的会话
lastVisitorMsgTimestamp	Number	访客最后一条消息时间戳	访客发送最后一条消息的毫秒级时间戳
agentPushCsr	Boolean	是否座席推送客服	标识是否由坐席主动将会话推送给其他坐席或客服组
lock	Boolean	会话是否锁定	标识会话是否被锁定（锁定后无法被其他坐席认领）
otherParams	Object	其他扩展参数	预留的扩展参数对象，可存放自定义信息
toGroup	String	目标客服组 ID	会话被分配到的目标客服组 ID
redisRecordDelayTimestamp	Number	Redis 记录延迟时间戳	会话数据写入 Redis 的延迟时间戳
area	String	访客所属地区	访客 IP 对应的地区信息
leakNum	Number	会话漏接次数	会话被漏接的次数
manualTimestamp	Number	人工接入时间戳	人工服务开始的毫秒级时间戳
agentReplyMessageCount	Number	坐席回复消息数	坐席在会话中回复的消息数量
ip	String	访客 IP 地址	访客的 IP 地址
lastRedirectTimestamp	Number	最后转接时间戳	会话最后一次被转接的毫秒级时间戳
priority	Boolean	是否优先处理	标识会话是否被标记为优先处理
leaveSession	Boolean	是否离开会话	标识访客是否已离开会话
lastClaimTimestamp	Number	最后认领时间戳	会话最后一次被认领的毫秒级时间戳
endTimestamp	Number	会话结束时间戳	会话结束的毫秒级时间戳（创建时通常为 0）
status	String	会话状态	会话的当前状态，示例：deal（处理中、finish（已结束）
convertManualTime	String	转人工时间	会话从机器人转人工的时间，格式为yyyy-MM-dd HH:mm:ss
lastMessageTimestamp	Number	最后一条消息时间戳	会话内最后一条消息的毫秒级时间戳
visitorBreak	Boolean	访客是否断开连接	标识访客是否已断开连接
visitorParams	Object	访客参数	访客端传递的自定义参数对象
pushNoAgentMsg	Boolean	是否推送无坐席消息	标识当无坐席在线时，是否向访客推送提示消息
agentClaimTimestamp	Number	坐席认领时间戳	坐席认领会话的毫秒级时间戳
visitorMessageCount	Number	访客消息数	访客在会话中发送的消息数量
visitorName	String	访客名称	访客在会话中使用的名称或昵称
osInfo	String	访客操作系统信息	访客设备的操作系统，示例：win10
serviceMan	String	服务类型	会话的服务类型，示例：manual（人工）、robot（机器人）
lastRedirectAgentTime	Number	最后转接时间戳	会话最后一次被转接的毫秒级时间戳
browser	String	访客浏览器信息	访客使用的浏览器及版本
recordConvertManualTimestamp	Number	记录转人工时间戳	记录会话转人工操作的毫秒级时间戳
lastAgentMessageTimestamp	Number	坐席最后一条消息时间戳	坐席发送最后一条消息的毫秒级时间戳
newVisitor	Boolean	是否为新访客	标识访客是否为首次发起会话
showAnnexUrl	Boolean	是否显示附件 URL	标识是否在会话中显示附件下载 URL
convertManualTimestamp	Number	转人工时间戳	会话从机器人转人工的毫秒级时间戳
createTime	String	会话创建时间	会话创建的时间，格式为yyyy-MM-dd HH:mm:ss
totalMsgCount	Number	总消息数	会话内累计的消息总数
currentNodeId	String	渠道 ID	会话来源的渠道唯一标识
agentClaimTime	String	坐席认领时间	坐席认领会话的时间，格式为yyyy-MM-dd HH:mm:ss
initiating	Boolean	是否主动发起	标识会话是否由坐席主动发起
processNodeId	String	流程节点 ID	会话当前关联的流程节点 ID
manualTime	String	人工服务时间	人工服务开始的时间，格式为yyyy-MM-dd HH:mm:ss

会话分配推送示例：

{"msgType":"assignSession",
"data":
{"setTopTimestamp":0,"visitorBreakTimestamp":0,"seoSource":"其他网站",
"showCustomerName":false,"participatePending":false,"systemPushCsr":false,
"createTimestamp":1768794470603,"newSession":false,"lastVisitorMsgTimestamp":1768794470882,
"agentPushCsr":false,"lock":false,"otherParams":{},
"landingPageUrl":"https://im.useasy.cn/?channelId=no2k7aIxRfRcIpii&imUrlTitle=&imFromUrl",
"toGroup":"10004093","redisRecordDelayTimestamp":1768794470658,"area":"中国 湖南省 长沙市",
"leakNum":0,"manualTimestamp":1768794470882,"urlTitle":"1","visitorStartWaitTimestamp":1768794470882,
"agentReplyMessageCount":0,"ip":"220.168.85.121","lastRedirectTimestamp":0,"agentNumber":"9020",
"priority":false,"accountId":"1019","leaveSession":false,"_id":"d76953f9-04d8-4a57-8b66-f1a3c45b5f97",
"lastClaimTimestamp":0,"endTimestamp":0,"status":"deal","visitorId":"1019@no2k7aIxRfRcIpii@dag1kswz@web",
"agentId":"1011823285425180672","convertManualTime":"2026-01-19 11:47:50",
"lastMessageTimestamp":1768794470604,"visitorBreak":false,"seoKeywords":"未知","visitorParams":{},
"pushNoAgentMsg":false,"agentClaimTimestamp":1768794470882,"visitorMessageCount":0,
"visitorName":"se2huk5ca3sz","osInfo":"Win10","serviceMan":"manual","lastRedirectAgentTime":0,
"browser":"MicroMessenger 7.0.20.1781","recordConvertManualTimestamp":1768794470796,
"lastAgentMessageTimestamp":0,"channelId":"no2k7aIxRfRcIpii","queuePriority":0,"beFrom":"pc",
"newVisitor":false,"sessionId":"d76953f9-04d8-4a57-8b66-f1a3c45b5f97","showAnnexUrl":false,
"convertManualTimestamp":1768794470775,"referrer":"https://weixin110.qq.com/",
"createTime":"2026-01-19 11:47:50","totalMsgCount":0,
"fromUrl":"https://im.useasy.cn/?channelId=no2k7aIxRfRcIpii&imUrlTitle=&imFromUrl",
"currentNodeId":"8542c148d19542189fd0b0fb3e462efc","initiating":false,
"processNodeId":"553491bb-d989-4498-9715-2bd05cc70fd3","manualTime":"2026-01-19 11:47:50"},
"msgTime":"2026-01-19 11:47:50","eventUniqueId":"666ce112-6554-4af9-89d4-38df867999d5"}

会话分配推送data字段说明：

字段	数据类型	名称	描述
seoSource	String	SEO 来源	访客进入会话的 SEO 来源渠道，示例：其他网站
landingPageUrl	String	落地页 URL	访客进入会话的落地页完整链接
urlTitle	String	页面标题	访客进入会话时的页面标题
visitorStartWaitTimestamp	Number	访客开始等待时间戳	访客开始等待人工接待的毫秒级时间戳
visitorBreak	Boolean	访客是否断开连接	标识访客是否已断开连接（false 表示在线）
seoKeywords	String	SEO 关键词	访客进入会话的 SEO 关键词
queuePriority	Number	排队优先级	会话在排队队列中的优先级（0 为默认优先级）
showAnnexUrl	Boolean	是否显示附件 URL	标识是否在会话中显示附件下载 URL
referrer	String	来源页 URL	访客进入会话前的上一页链接
fromUrl	String	来源 URL	访客进入会话的来源链接（与落地页 URL 一致）
currentNodeId	String	当前流程节点 ID	会话当前所在的流程节点 ID
processNodeId	String	流程节点 ID	会话当前关联的流程节点 ID

关闭会话推送示例

{"msgType":"closeSession",
"data":
{"accountId":"1019","agentId":"1011823285425180672","finishKey":"system_auto_finish_session",
"visitorName":"loyeu75idls5","finishAgentId":"system","agentNumber":"9020",
"endTime":"2026-01-19 11:25:44","sessionId":"f772982f-71b7-4e7d-b4b7-307266e6aadc",
"endTimestamp":1768793144162,"toGroup":"10004093","visitorId":"1019@no2k7aIxRfRcIpii@tkt96h52@web"},
"msgTime":"2026-01-19 11:25:44","eventUniqueId":"20a2c82e-faa0-492c-b377-34283a28cc90"}

关闭会话data子字段说明：

字段名	数据类型	名称	描述
finishKey	String	结束原因标识	会话结束的原因编码
visitorName	String	访客名称	访客在会话中使用的名称或昵称
finishAgentId	String	结束操作者 ID	触发会话结束的操作者 ID
endTime	String	会话结束时间	会话结束的时间
endTimestamp	Number	会话结束时间戳	会话结束的毫秒级时间戳
toGroup	String	目标客服组 ID	会话被分配到的目标客服组 ID

发送消息给座席推送示例：

{"msgType":"msgToAgent",
"data"
:{"dealCustomerMsg":false,"showHtml":false,"beFrom":"pc",
"messageId":"e05d0fb6-d721-4ef1-8181-f796428aff46","revoke":0,
"sessionId":"d76953f9-04d8-4a57-8b66-f1a3c45b5f97","type":"in","content":"你好",
"createTimestamp":1768794474969,"accountId":"1019","hide":false,
"createTime":"2026-01-19 11:47:54","replyId":"","_id":"e05d0fb6-d721-4ef1-8181-f796428aff46",
"contentType":"text","channelId":"no2k7aIxRfRcIpii","videoPlay":"",
"visitorId":"1019@no2k7aIxRfRcIpii@dag1kswz@web"},"msgTime":"2026-01-19 11:47:54",
"eventUniqueId":"42dcb677-7a1e-4b3f-8394-b459aa6da211"}

发送消息给座席data子字段说明：

字段名	数据类型	名称	描述
dealCustomerMsg	Boolean	是否为访客处理消息	标识该消息是否由访客直接发送（通常为 false，机器人转发可能为 true）
showHtml	Boolean	是否显示 HTML 格式	标识消息内容是否以 HTML 格式展示
revoke	Number	是否撤回	标识消息是否被撤回，0 为未撤回，1 为已撤回
type	String	消息方向	消息的发送方向，in表示从访客端发出
content	String	消息内容	访客发送的具体文本内容
createTimestamp	Number	消息创建时间戳	消息创建的毫秒级时间戳
hide	Boolean	是否隐藏消息	标识该消息是否在坐席端隐藏展示
replyId	String	回复目标消息 ID	该消息所回复的目标消息 ID，为空表示不是回复消息
_id	String	数据记录 ID	消息记录在数据库中的唯一标识（通常与 messageId 相同）
contentType	String	内容类型	消息的内容类型
videoPlay	String	视频播放地址	视频消息的播放 URL，为空表示无视频内容

发送消息给客户推送示例：

{"msgType":"msgToCustomer",
"data":
{"showHtml":false,"agentHeadImg":"","agentId":"1011823285425180672","beFrom":"pc",
"dealAgent":"agent","robotMsgCanLike":false,"agentName":"LI",
"messageId":"c4218512-baed-4df1-830c-d9a0a0e325aa","msgId":"1768792963029kwnMLWh0",
"revoke":0,"agentNumber":"9020","sessionId":"f772982f-71b7-4e7d-b4b7-307266e6aadc",
"type":"out","content":"<p>1</p>","createTimestamp":1768792963029,"accountId":"1019",
"createTime":"2026-01-19 11:22:43","dealAgentMsg":false,"replyId":"",
"_id":"c4218512-baed-4df1-830c-d9a0a0e325aa","contentType":"text","channelId":"no2k7aIxRfRcIpii",
"videoPlay":"","visitorId":"1019@no2k7aIxRfRcIpii@tkt96h52@web"},
"msgTime":"2026-01-19 11:22:43","eventUniqueId":"1eb90ab7-91b1-498d-a4ad-5b292fc540b7"}

发送消息给客户data字段说明：

字段名	数据类型	名称	描述
showHtml	Boolean	是否显示 HTML 格式	标识消息内容是否以 HTML 格式展示
agentHeadImg	String	坐席头像地址	发送消息的坐席头像 URL，为空则使用默认头像
dealAgent	String	处理人类型	处理该消息的角色类型
robotMsgCanLike	Boolean	机器人消息是否可点赞	标识该消息是否为机器人发送且允许访客点赞
agentName	String	坐席名称	发送该消息的坐席姓名或昵称
revoke	Number	是否撤回	标识消息是否被撤回，0 为未撤回，1 为已撤回
type	String	消息方向	消息的发送方向，out表示从坐席端发出
content	String	消息内容	消息的具体内容，支持 HTML 标签，示例：`<p>1</p>`
dealAgentMsg	Boolean	是否为坐席处理消息	标识该消息是否由坐席直接处理并发送
replyId	String	回复目标消息 ID	该消息所回复的目标消息 ID，为空表示不是回复消息
_id	String	数据记录 ID	消息记录在数据库中的唯一标识（通常与 messageId 相同）
contentType	String	内容类型	消息的内容类型，示例：text（文本）、image（图片）
videoPlay	String	视频播放地址	视频消息的播放 URL，为空表示无视频内容

系统消息推送示例：

{"msgType":"systemMsg",
"data":
{"showHtml":false,"beFrom":"pc","messageId":"b9632541-c865-439a-939d-6c02d7229f39",
"revoke":0,"sessionId":"f772982f-71b7-4e7d-b4b7-307266e6aadc","type":"system",
"content":"您好，由于您长时间没有进行会话，系统将结束本次会话，如果需要，请您再次咨询，祝您生活愉快！",
"createTimestamp":1768793144203,"accountId":"1019","hide":false,
"createTime":"2026-01-19 11:25:44","_id":"b9632541-c865-439a-939d-6c02d7229f39",
"contentType":"autoClose","channelId":"no2k7aIxRfRcIpii",
"visitorId":"1019@no2k7aIxRfRcIpii@tkt96h52@web"},
"msgTime":"2026-01-19 11:25:44","eventUniqueId":"9e100c64-6719-443c-bb07-b95df73e2dba"}

系统消息推送data字段说明：

字段名	数据类型	名称	描述
showHtml	Boolean	是否显示 HTML格式	标识系统消息内容是否以 HTML 格式展示（通常为 false）
contentType	String	内容类型	系统消息的触发类型，示例：`autoClose`（自动关闭）

响应示例

{
    "success": true,
    "message": "200 ok!",
    "code": "200",
    "data": null,
    "traceId": "580fa5201a4b45c1b0004d6e23c3c8bf"
}

说明：code为200时，表示接受方已受理成功。

该推送用于会话总结后将总结内容自动推送给第三方接口

字段说明

字段名	类型	说明
_id	string	会话id
summary	array[]	用户诉求、问题、解决方案、特殊要求
keywords	array[]	会话关键词
createTime	string	会话创建时间
sentimentLevel	string	用户情绪
sentimentTrend	string	用户情绪描述
eventUniqueId	string	事件id

推送示例

{"summary":["诉求：咨询企业版本云客服","问题：无","解决方案：无","特殊要求：无"],"keywords":["云客服","企业版本"],"createTime":"2025-07-03 10:21:58","sentimentLevel":"中性","sentimentTrend":"","eventUniqueId":"953022124409008128","_id":"e8b7ebe7-d4e2-4b30-b073-8dac1ddad8f4"}

为了方便租户实时获取到在线会话的满意度评价结果，极简云客服支持将此类数据进行实时推送主要有1类消息：

序号	消息分类	说明
1	满意度评价	客户对一个会话完成评价后，系统将结果推送到指定的接口地址

推送格式

字段	数据类型	名称	描述
eventUniqueId	String	消息唯一id
msgTime	String	消息时间	调用回调结果时，赋予的时间（格式：yyyy-MM-dd HH:mm:ss）
msgType	String	消息类型	satisfaction 满意度评价
data	Object	消息内容	推送的内容

推送示例

{
    "eventUniqueId": "35a6a7cb-4d48-4174-b3e8-38078a5cf7ee",
    "msgTime": "2025-08-15 11:27:56",
    "msgType": "satisfaction",
    "data": {
        "sessionId": "4a9e4850-2a5c-4355-b8c2-98ed853101e9",
        "beFrom": "pc",
        "messageId": "4e0a3511-a1db-45a0-ad8c-cebec9a1cfaa",
        "satisfactionData": {
            "satisfactionType": "radioTagText",
            "satisfactionKey": "bc97dd74-5640-4464-823a-673287d85b45",
            "satisfactionName": "一般满意",
            "satisfactionReason": [
                "无效沟通"
            ],
            "satisfactionProposal": "第三方"
        },
        "accountId": "1090"
    }
}

响应示例

{
    "success": true,
    "message": "200 ok!",
    "code": "200",
    "data": null,
    "traceId": "580fa5201a4b45c1b0004d6e23c3c8bf"
}

说明：code为200时，表示接受方已受理成功。

2026-01-19

在线客服推送

1、在线客服消息推送

2、会话纪要推送

3. 在线客服满意度结果推送

本页目录