1、在线客服消息推送
接入方式
登录云客服系统,进入“设置”-“对接中心”,选择“在线事件”,配置一条事件类型为“消息推送事件”的配置即可。
目前支持4类消息的推送:
序号 | 消息分类 | 说明 |
1 | 创建会话 | 用户发起一个新会话时,会推送此消息(包含来源、时间等信息) |
2 | 结束会话 | 座席完成一个会话时,会推送此消息(包含结束原因) |
3 | 消息给座席 | 包含客户和系统给座席发送的消息 |
4 | 消息给客户 | 包含座席和系统给客户发送的消息 |
推送格式
序号 | 字段 | 数据类型 | 名称 | 描述 |
1 | eventUniqueId | String | 消息唯一id | |
2 | msgTime | String | 消息时间 | 调用回调结果时,赋予的时间(格式:yyyy-MM-dd HH:mm:ss) |
3 | msgType | String | 消息类型 | createSession 创建会话closeSession 关闭会话msgToAgent 消息给座席msgToCustomer 消息给客户 |
4 | data | Object | 消息内容 | 分别对应msgType的4种类型 |
推送示例
{
"eventUniqueId": "66ad3a39-5749-4b3b-a3ef-a30d77584f0f",
"msgTime": "2025-07-15 15:48:32",
"msgType": "createSession",
"data": {
"sessionId": "2ad48ea5-fe9c-4e47-8aee-32121fad5c68",
"accountId": "1090",
"status": "deal",
"channelId": "KjWKrxa7bDfiQl1W",
// 其他字段(此处省略)
}
}
响应示例
{
"success": true,
"message": "200 ok!",
"code": "200",
"data": null,
"traceId": "580fa5201a4b45c1b0004d6e23c3c8bf"
}
说明:code为200时,表示接受方已受理成功。
2、会话纪要推送
该推送用于会话总结后将总结内容自动推送给第三方接口
字段说明
字段名 | 类型 | 说明 |
_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"}
3. 在线客服满意度结果推送
为了方便租户实时获取到在线会话的满意度评价结果,极简云客服支持将此类数据进行实时推送主要有1类消息:
序号 | 消息分类 | 说明 |
1 | 满意度评价 | 客户对一个会话完成评价后,系统将结果推送到指定的接口地址 |
推送格式
序号 | 字段 | 数据类型 | 名称 | 描述 |
1 | eventUniqueId | String | 消息唯一id | |
2 | msgTime | String | 消息时间 | 调用回调结果时,赋予的时间(格式:yyyy-MM-dd HH:mm:ss) |
3 | msgType | String | 消息类型 | satisfaction 满意度评价 |
4 | 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时,表示接受方已受理成功。