入门
特色功能
免费私有化部署 👈
配置文件修改说明
部署新服务器 👈
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
Docker
Linux 服务器
宝塔面板
Windows Docker Desktop
发布客服端程序
升级现有服务器
服务器维护
开通自动翻译服务
配置文件存储
公告
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
准备使用客服端软件
站点管理
客服账号管理
基础会话功能
辅助会话功能
个性化站点配置
访客管理
访客留言
集成及二次开发

接收客服消息推送的消息


在 Open Api 配置中填写回调地址后,客服将向回调地址 POST 以下 JSON 字符串。

注意:客服系统推送的消息 ContentType = "text/plain"

您的接口只需返回 HTTP 200 即可,如果需要给访客回复消息,需要另行调用 PushDialogMessage 接口。 如果接口是耗时计算,可先行返回,待后台处理完毕后再调用 PushDialogMessage 接口推送消息。

CustomerOnline

访客上线。

{
  "siteCode": "站点代码",
  "action": "CustomerOnline",
  "data": 
  {
    "customerId": "4226a1cb-953e-480a-8954-6343e8f56315",
    "externalId": null
  }
}

CustomerDialogMessage

访客发送了聊天消息。

{
  "siteCode": "站点代码",
  "action": "CustomerDialogMessage",
  "data": 
  {
    "customerStatus": 1,
    "customerId": "4226a1cb-953e-480a-8954-6343e8f56315",
    "externalId": null,
    "content": "你好",
    "type":0,
    "sentTime": "2024/12/15 10:43:39"
  }
}

customerStatus 表示访客当前的状态:1 普通在线,尚未进入工人会话流程, 2 已进入人工会话流程,等待应答中,3 正在与客服进行会话。
type 表示消息类型,0 表示普通消息,2 表示扩展消息。

扩展消息

当 type 为 2 时,content 将表示为不同的 json 字符串。

注意: content 字段中存放的是 json 字符串,不是 json 对象。

图片:
{"type":"image","url":"https://name.com/image.jpg"}

文件:
{"type":"file","name":"文件名","size":0.69,"url":"https://name.com/file.zip"}

访客发送图片时的完整示例:

{
  "siteCode": "站点代码",
  "action": "CustomerDialogMessage",
  "data": 
  {
    "customerStatus": 1,
    "customerId": "4226a1cb-953e-480a-8954-6343e8f56315",
    "externalId": null,
    "content": "{\"type\":\"image\",\"url\":\"https://name.com/image.jpg\"}",
    "type":0,
    "sentTime": "2024/12/15 10:43:39"
  }
}

目录

入门
特色功能
免费私有化部署 👈
配置文件修改说明
部署新服务器 👈
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
Docker
Linux 服务器
宝塔面板
Windows Docker Desktop
发布客服端程序
升级现有服务器
服务器维护
开通自动翻译服务
配置文件存储
公告
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
准备使用客服端软件
站点管理
客服账号管理
基础会话功能
辅助会话功能
个性化站点配置
访客管理
访客留言
集成及二次开发
对接及二次开发
Open Api 开放接口