跳至主要内容

事件类型

当前系统支持以下 Webhook 事件类型。

UNREPLIED - 访客消息未回复​

字段值
事件名称UNREPLIED
触发条件访客消息超时未回复
首次触发自定义
后续触发自定义
停止条件客服回复 或 推送次数 >= 4 次

content 字段说明​

参数名类型说明参数示例
subjectstring会话标题New Conversation
visitor_namestring访客姓名Visitor15
created_atnumber消息创建时间1765439652
message_contentstring消息内容1
property_namestring项目名称test
visitor_nicknamestring访客备注名VIP
sbsstring客户标识234442313
statusstring状态（1: 待回复 2: 排队中 3: 待处理 4: 已回复）1
push_timesnumber推送次数4
time_secnumber超时时间（秒）289
assigned_agent_nicknamestring服务客服名称ctccccd

完整示例​

{
  "created_at": 1765439941,
  "event": "UNREPLIED",
  "webhook_id": "58946f5f583edd94f5cf87e3534d04fb",
  "content": [
    {
      "subject": "New Conversation",
      "visitor_name": "Visitor15",
      "created_at": 1765439652,
      "message_content": "1",
      "property_name": "test",
      "visitor_nickname": "visitor nickname",
      "sbs": "",
      "status": "1",
      "push_times": 4,
      "time_sec": 289,
      "assigned_agent_nickname": "ctccccd"
    }
  ]
}

应用场景​

  • 访客发送消息后，若在预设时间（如5分钟）内未收到任何客服回复，系统自动将该会话的超时状态、访客消息及上下文信息推送至指定渠道（Slack、飞书、钉钉、企业微信及自定义Webhook地址）。

PRE_CHAT_FORM_SUBMIT - 会话前表单提交​

字段值
事件名称PRE_CHAT_FORM_SUBMIT
触发条件访客会话前表单提交

content 字段说明​

参数名类型说明参数示例
subjectstring会话标题New Conversation
visitor_namestring访客姓名Visitor15
created_atnumber表单创建时间1765439652
message_contentstring表单内容1
property_namestring项目名称test
visitor_nicknamestring访客备注名VIP
sbsstring客户标识234442313
assigned_agent_nicknamestring服务客服名称ctccccd

完整示例​

{
  "created_at": 1765439941,
  "event": "PRE_CHAT_FORM_SUBMIT",
  "webhook_id": "58946f5f583edd94f5cf87e3534d04fb",
  "content": [
    {
      "subject": "New Conversation",
      "visitor_name": "Visitor15",
      "created_at": 1765439652,
      "message_content": "1",
      "property_name": "test",
      "visitor_nickname": "visitor nickname",
      "sbs": "",
      "assigned_agent_nickname": "ctccccd"
    }
  ]
}

应用场景​

  • 访客在发起会话前，需按要求填写预置表单（如姓名、电话等字段）。表单提交后，系统自动将填写内容推送至指定渠道（Slack、飞书、钉钉、企业微信及自定义Webhook地址）。

OFFLINE_FORM_SUBMIT - 离线表单提交​

字段值
事件名称OFFLINE_FORM_SUBMIT
触发条件客服全员离线时访客有离线表单

content 字段说明​

参数名类型说明参数示例
subjectstring会话标题New Conversation
visitor_namestring访客姓名Visitor15
created_atnumber表单创建时间1765439652
message_contentstring表单内容1
property_namestring项目名称test
visitor_nicknamestring访客备注名VIP
sbsstring客户标识234442313
assigned_agent_nicknamestring服务客服名称ctccccd

完整示例​

{
  "created_at": 1765439941,
  "event": "OFFLINE_FORM_SUBMIT",
  "webhook_id": "58946f5f583edd94f5cf87e3534d04fb",
  "content": [
    {
      "subject": "New Conversation",
      "visitor_name": "Visitor15",
      "created_at": 1765439652,
      "message_content": "1",
      "property_name": "test",
      "visitor_nickname": "visitor nickname",
      "sbs": "",
      "assigned_agent_nickname": "ctccccd"
    }
  ]
}

应用场景​

  • 当访客发起会话时，若所有客服均处于离线状态，则引导访客填写留言表单（如姓名、电话等）。表单提交后，系统自动将留言内容及离线状态信息推送至指定渠道（Slack、飞书、钉钉、企业微信及自定义Webhook地址）。
提示

后续支持的事件类型会直接更新到本文档中。