当应用订阅此事件后，如果在 3chat 中关闭了对话，则会调用 Webhook 推送该事件至响应的开发者服务器。

前提条件

在应用配置中添加订阅事件 BUTLER_CONVERSATION_CLOSED.

事件头示例

{
  "headers":{
     // 租户ID
    "TENANT_ID":[
        "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"  
    ]
    "STAFF_ID":[
        "123123"    
    ]
     // 时间戳
    "x-nct-time":[
        "1750351569887"   
    ]
     // 业务类型代码
    "business-type":[
        "15003"  
    ] 
}

事件体示例

{
  "requestId": "f91692b3-f35c-4f3d-b398-e6f34491d3ce",
  "businessType": 15003,
  "data": {
    "summary": "用户咨询小米15手机的使用体验和购买建议，AI客服在了解其关注点后协助转接人工服务，并确认了联系方式以便顾问跟进。",
    "convStatus": 3,
    "updatedTime": 1765466070910,
    "completedTime": 1765466070908,
    "replyStrategy": 2,
    "solved": false,
    "sessionId": {
      "id": "mz43k5my686kjsfkfpzqkup6",
      "viewKey": "butlerSession"
    },
    "lookup_3g71fgh5f5": "张三",
    "dataId": "uu5cha880vvk8tbw6e4hmv0i",
    "userAccountId": "2ce63138-344c-40fe-976b-8f19d3d3d2fa",
    "extendMap": {},
    "createdTime": 1765465932005,
    "lookup_h70b811f83": 102,
    "id": "1448693862208901600",
    "visitorId": {
      "id": "ailfxvj0qyhbyy5vryljrz4k",
      "viewKey": "butlerVisitor"
    }
  }
}

字段说明

字段名	字段值	字段说明
summary	用户咨询小米15手机的使用体验和购买建议，AI客服在了解其关注点后协助转接人工服务，并确认了联系方式以便顾问跟进	会话内容的核心摘要，概括本次客服咨询的主要业务场景和处理流程
convStatus	3	会话状态标识，3 对应完成（业务字典定义：活跃 = 2、完成 = 3）
updatedTime	1765466070910	会话数据最后更新的时间戳（单位为毫秒）
completedTime	1765466070908	会话结束完成的时间戳（单位为毫秒）
replyStrategy	2	客服回复策略标识，2 对应 AI 客服（业务字典定义：人工客服 = 1、AI 客服 = 2、联系人 = 3）
solved	false	会话问题是否已解决，false表示未解决
sessionId	{"id": "mz43k5my686kjsfkfpzqkup6", "viewKey": "butlerSession"}	会话唯一标识对象，包含会话ID、实体标识等关联信息
lookup_3g71fgh5f5	张三	业务关联的分类/联系人名称
dataId	uu5cha880vvk8tbw6e4hmv0i	数据库id
userAccountId	2ce63138-344c-40fe-976b-8f19d3d3d2fa	用户账号的唯一UUID标识
extendMap	{}	自定义字段key-value
createdTime	1765465932005	会话创建的时间戳（单位为毫秒）
lookup_h70b811f83	102	业务关联的分类/渠道类型，参考: https://open.xinheyun.com/api-346934773
id	1448693862208901600	本条会话记录的全局唯一ID
visitorId	{"id": "ailfxvj0qyhbyy5vryljrz4k", "viewKey": "butlerVisitor"}	访客唯一标识对象，关联访客的业务视图标识

关闭对话

前提条件#

事件头示例#

事件体示例#

字段说明#

前提条件

事件头示例

事件体示例

字段说明