在线事件推送接口

一.在线客服状态变更推送接口

1、接口概述

当客服状态发生改变时，会触发系统推送至第三方接口，第三方可根据推送数据做业务逻辑处理

2、接口请求

请求方式：POST
请求体格式："Content-Type": "application/x-www-form-urlencoded"

3、请求参数

字段	类型	参数说明
exten	string	状态变更操作人工号
displayName	string	状态变更操作人昵称
update_exten	string	状态变更生效座席工号
update_displayName	string	状态变更生效座席昵称
when	string	变更时间
status_name_before	string	原状态编号
status_name_after	string	变更后状态编号

注意：状态变更因网络或系统异常导致，则【状态变更操作人姓名】为网络异常或系统【状态变更操作人工号】字段为空。

请求参数示例：

{
    "exten": "8998",
    "displayName": "test",
    "update_exten": "8998",
    "update_displayName": "test",
    "when": "2023-11-07 10:58:02",
    "status_name_before": "open",
    "status_name_after": "close"
}

二.访客离线消息推送接口

1、接口概述

访客离线后，坐席发送给访客的未读消息会触发系统推送至第三方接口，第三方可根据推送数据做业务逻辑处理

2、接口请求

请求方式：POST
请求体格式："Content-Type": "application/x-www-form-urlencoded"

3、请求参数

字段	类型	参数说明
when	string	时间
content	string	消息内容
contentType	string	消息类型
sid	string	访客id
toPeer	string	技能组
exten	string	坐席工号
im_icon	string	坐席头像
displayName	string	坐席姓名
accessId	string	渠道id
sessionId	string	会话ID
customerId	string	客户ID，如果该会话的访客绑定了客户，则推送客户ID，若无则为空

请求参数示例：

{
    "when": "2023-11-14 11:53:23",
    "content": "%E8%AE%BF%E5%AE%A2%E7%A6%BB%E5%BC%80%E4%BA%86",
    "contentType": "text",
    "sid": "9cabd048-1fe7-4091-9b99-0776be6c6509",
    "toPeer": "10058276",
    "exten": "8020",
    "im_icon": "",
    "accessId": "a4fb3e90-93db-11e8-8a23-4fdc28xxxxxx",
    "sessionId": "25bf1d11-c370-11ef-9133-e3f69xxxxx",
    "customerId": "",
    "displayName": "test"
}

三.坐席离线消息推送接口

1、接口概述

坐席离线后，访客发送给坐席的未读消息会触发系统推送至第三方接口，第三方可根据推送数据做业务逻辑处理

2、接口请求

请求方式：POST
请求体格式："Content-Type": "application/x-www-form-urlencoded"

3、请求参数

字段	类型	参数说明
when	string	时间
content	string	消息内容
contentType	string	消息类型
sid	string	访客id
toPeer	string	技能组
exten	string	坐席工号
im_icon	string	坐席头像
displayName	string	坐席昵称

请求参数示例：

{
    "when": "2023-11-14 11:53:23",
    "content": "%E8%AE%BF%E5%AE%A2%E7%A6%BB%E5%BC%80%E4%BA%86",
    "contentType": "text",
    "sid": "9cabd048-1fe7-4091-9b99-0776be6c6509",
    "toPeer": "10058276",
    "exten": "8020",
    "im_icon": "",
    "displayName": "test"
}

四.智能会话小结推送

1、接口概述

系统生成智能会话小结后，将小结的内容回推到客户的CRM系统

2、接口请求

请求方式：POST
请求体格式："Content-Type": "application/x-www-form-urlencoded"

3、请求参数

字段	类型	参数说明
pushTime	string	推送时间
pushData	string	推送内容
sessionId	string	会话id
name	string	后台配置的小结要点名称
content	string	大模型生成对应的要点内容

请求体参数示例：

{
    "pushTime": "2025-05-22 13:42:35",
    "pushData": "[
        {
          \"_id\": \"17718d5b-6206-4124-9451-fd59d180245a\",
          \"name\": \"会话小结\",
          \"content\": \"用户询问电脑、苹果16手机和耳机的价格，客服告知电脑价格为9999元，耳机价格为999元，对于苹果16手机价格表示去询问。\"
        },
        {
          \"_id\": \"a3623dd5-c6eb-4ea7-a563-386c6de1aad8\",
          \"name\": \"用户诉求\",
          \"content\": \"用户想了解电脑、苹果16手机和耳机的价格。\"
        },
        {
          \"_id\": \"6a7ae709-5112-472e-b85d-c052e058a18c\",
          \"name\": \"解决方案\",
          \"content\": \"对于电脑价格，客服直接告知为9999元；对于耳机价格，客服告知为999元；对于苹果16手机价格，客服表示去询问。\"
        },
        {
          \"_id\": \"f2529620-e8c9-424c-9426-0dc57a1d9601\",
          \"name\": \"是否解决问题\",
          \"content\": \"否\"
        },
        {
          \"_id\": \"d197dd43-ec1b-4e2a-86c2-f1d3463af9bf\",
          \"name\": \"未解决问题\",
          \"content\": \"苹果16手机的价格尚未得到确切回复。\"
        },
        {
          \"_id\": \"4cd40ecb-55bb-4ddc-ba37-c91409b41d1a\",
          \"name\": \"访客满意度\",
          \"content\": \"用户表示满意。\"
        }
    ]",
    "sessionId": "4b789810-36cf-11f0-9f9b-791102e9bd74"
}