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

前提条件

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

事件头示例

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

事件体示例

{
    "requestId": "03703d30-50f2-4103-bdb6-8aa331f36cc5", 
    "businessType": 15016, 
    "data": {
        "id": "51901704862228480",
        "dataId": "7g0rzhgjp0a3xqpdd",
        "senderId": "51901681609007100",
        "workSpaceId": "a4872870-3cde-47f2-830f-a5f07801790b",
        "senderType": 1,
        "sendTime": 1770489117,
        "content": "介绍下你们的业务",
        "channelId": {
          "id": "d56sxkazsuqdqz0d5u",
          "viewKey": "butlerChannel"
        },
        "conversationId": {
          "id": "aqxqpddc36lyaeysxhhuekih",
          "viewKey": "butlerConversation"
        },
        "sessionId": {
          "id": "kiaa9exjdwdcnzrzqgjp0a32",
          "viewKey": "butlerSession"
        }, 
        "isEffectiveReply": true,
        "email": {
          "from": "abc@xinheyun.com",
          "fromName": "析建军",
          "to": [
            "abc@xinheyun.com",
            "abc@xinheyun.com",
            "abc@xinheyun.com"
          ],
          "cc": [
            "abc@xinheyun.com",
            "abc@xinheyun.com"
          ],
          "bcc": [
            "abc@xinheyun.com"
          ],
          "subject": "产品咨询"
        },
        "attachments": [
          {
            "key": "idolor",
            "name": "琴梓涵.png",
            "contentType": "image/png",
            "url": "https://mature-printer.com/",
            "size": 3132
          }
        ],
        "agentLogs": [
          {
            "type": "language",
            "message": "中文",
            "status": "certain",
            "timestamp": 1762915391425
          },
          {
            "type": "recall",
            "message": "记忆内容：1,2,3",
            "timestamp": 1762915391425
          },
          {
            "type": "task",
            "name": "查询订单",
            "timestamp": 1762915391425
          },
          {
            "type": "knowledge",
            "kb": [
              {
                "chunk_id": "7ae93248fe9",
                "content":"Q:测试公司是做什么的?\nA:测试公司提供面向企业测试服务",
                "created_at": 1763640658,
                "document_id": "dd06afb5-7e33-4953-9247-113879e4653",
                "document_name":"测试知识库.md",
                "enabled": true,
                "lang": "zh",
                "score": 0.7226141428807815,
                "source": "Document"
              }
            ],
            "timestamp": 1762915391425
          },
          {
            "type": "tool",
            "name": "新建订单",
            "costTime": 5,
            "timestamp": 1762915391425
          },
          {
            "type": "tool",
            "name": "新建订单",
            "costTime": 5,
            "status": "success",
            "timestamp": 1762915391425
          },
          {
            "type": "internalTool",
            "entity": {
              "name": "visitor",
              "values": ["小牙仔", "13812345678"]
            },
            "timestamp": 1762915391425
          },
          {
            "type": "systemTask",
            "name": "收集信息",
            "message": "记录xx,xx,xx",
            "timestamp": 1762915391425
          }
        ],
        "createdTime": 1770489117249,
        "updatedTime": 1747115523185,
        "thirdId": "external_message_id",
        "replyMessageId": "reply_message_id",
        "processedBy": 2
    }
}

字段说明

一、基础信息字段表

字段名	字段值	字段说明
id	51901704862228480	消息实体唯一ID
dataId	7g0rzhgjp0a3xqpdd	数据库 ID
senderId	51901681609007100	发送者ID，不同发送者类型对应不同含义： - senderType==1时，senderId为联系人id； - senderType==2时，senderId为平台发送者id； - senderType==3时，senderId为Agent智能体id
workSpaceId	a4872870-3cde-47f2-830f-a5f07801790b	工作空间ID
senderType	1	发送者类型（注：应为枚举字符串，非数字），枚举值定义： - -1=未知； - 0=系统消息； - 1=联系人； - 2=人工客服； - 3=AI客服
sendTime	1770489117	发送时间（Unix时间戳，单位为秒），该字段为必需字段
content	介绍下你们的业务	消息内容，格式符合SessionMessageDTO.content规范
channelId	{"id": "d56sxk7g0rzhazsuqdqz0d5u"}	渠道ID（注：应为字符串类型，非对象类型）
conversationId	{"id": "aqxqpddc36lyaeysxhhuekih"}	对话ID（注：应为字符串类型，非对象类型）
sessionId	{"id": "kiaa9exjdwdcnzrzqgjp0a32"}	会话ID（注：应为字符串类型，非对象类型）
isEffectiveReply	true	该消息是否为有效回复，true表示是有效回复
email	{ "from": "abc@xinheyun.com", "fromName": "析建军", "to": ["abc@xinheyun.com","abc@xinheyun.com","abc@xinheyun.com"], "cc": ["abc@xinheyun.com","abc@xinheyun.com"], "bcc": ["abc@xinheyun.com"], "subject": "产品咨询" }	邮件信息，包含子字段： - from：发件人邮箱； - fromName：发件人姓名； - to：收件人邮箱列表； - cc：抄送人邮箱列表； - bcc：密送人邮箱列表； - subject：邮件主题
attachments	[{ "key": "idolor", "name": "琴梓涵.png", "contentType": "image/png", "url": "https://mature-printer.com/", "size": 3132 }]	附件列表，数组中每个对象为单个附件信息，包含子字段： - key：附件唯一标识； - name：附件名称； - contentType：附件内容类型； - url：附件访问链接； - size：附件大小（单位为字节）
agentLogs	[{"type":"language","message":"中文","status":"certain","timestamp":1762915391425}, {"type":"recall","message":"记忆内容：1,2,3","timestamp":1762915391425}, {"type":"task","name":"查询订单","timestamp":1762915391425}, {"type":"knowledge","kb":[{"chunk_id":"7ae93248fe9","content":"Q:测试公司是做什么的?\nA:测试公司提供面向企业测试服务","created_at":1763640658,"document_id":"dd06afb5-7e33-4953-9247-113879e4653","document_name":"测试知识库.md","enabled":true,"lang":"zh","score":0.7226141428807815,"source":"Document"}],"timestamp":1762915391425}, {"type":"tool","name":"新建订单","costTime":5,"timestamp":1762915391425}, {"type":"tool","name":"新建订单","costTime":5,"status":"success","timestamp":1762915391425}, {"type":"internalTool","entity":{"name":"visitor","values":["小牙仔","13812345678"]},"timestamp":1762915391425}, {"type":"systemTask","name":"收集信息","message":"记录xx,xx,xx","timestamp":1762915391425}]	智能体执行日志记录，记录智能体处理消息过程中的各类操作，包含的日志类型及说明： - language：语言判断（status=certain表示确定语言，uncertain表示不确定）； - recall：记忆唤醒； - task：意图&task选择； - knowledge：知识库检索（包含检索结果的chunk、文档、评分等信息）； - tool：MCP tool调用（status=success表示执行成功，failed表示执行失败，costTime为耗时）； - internalTool：内部tool调用； - systemTask：特殊task执行；所有日志项均包含timestamp（时间戳，单位为毫秒）
createdTime	1770489117249	创建时间戳（单位为毫秒），格式符合SessionMessageDTO.createdTime规范
updatedTime	1747115523185	更新时间戳（单位为毫秒），格式符合SessionMessageDTO.updatedTime规范
thirdId	external_message_id	可选字段（原始JSON中不存在，SessionMessageDTO允许），表示第三方消息ID
replyMessageId	reply_message_id	可选字段（原始JSON中不存在，SessionMessageDTO允许），表示回复消息ID
processedBy	AI_AGENT	可选字段（原始JSON中不存在，SessionMessageDTO允许），标记回复该消息的类型： - 1=人工回复； - 2=AI回复； - 0=未标记

二、email 嵌套字段子表

子字段名	字段值	字段类型	字段说明
from	abc@xinheyun.com	字符串	发件人邮箱
fromName	析建军	字符串	发件人姓名
to	["abc@xinheyun.com","abc@xinheyun.com","abc@xinheyun.com"]	数组	收件人邮箱列表
cc	["abc@xinheyun.com","abc@xinheyun.com"]	数组	抄送人邮箱列表
bcc	["abc@xinheyun.com"]	数组	密送人邮箱列表
subject	产品咨询	字符串	邮件主题

三、attachments 附件数组子表（单条附件结构）

子字段名	字段值	字段类型	字段说明
key	idolor	字符串	附件唯一标识
name	琴梓涵.png	字符串	附件名称
contentType	image/png	字符串	附件内容类型
url	https://mature-printer.com/	字符串	附件访问链接
size	3132	数字	附件大小（单位为字节）

四、agentLogs 智能体执行日志子表

1. 日志通用字段说明

所有日志项均包含type（日志类型）和timestamp（日志时间戳，单位为毫秒）字段，不同类型日志有专属扩展字段。

2. 各类型日志专属字段表

日志类型	专属字段	字段值示例	字段说明
language	message	中文	识别出的语言
language	status	certain/uncertain	语言判断状态：certain为确定，uncertain为不确定
recall	message	记忆内容：1,2,3	唤醒的记忆内容
task	name	查询订单	选中的意图/任务名称
knowledge	kb	见下方知识库检索子表	知识库检索结果列表
tool	name	新建订单	调用的MCP工具名称
tool	costTime	5	工具调用耗时（单位为毫秒）
tool	status	success/failed	工具执行状态：success为成功，failed为失败
internalTool	entity	{"name":"visitor","values":["小牙仔","13812345678"]}	内部工具调用的实体信息，name为实体类型，values为实体值列表
systemTask	name	收集信息	执行的系统任务名称
systemTask	message	记录xx,xx,xx	系统任务执行的具体内容

3. knowledge 类型日志的 kb 子数组表（单条检索结果）

子字段名	字段值	字段类型	字段说明
chunk_id	7ae93248fe9	字符串	知识库片段ID
content	Q:测试公司是做什么的? A:测试公司提供面向企业测试服务	字符串	知识库片段内容
created_at	1763640658	数字	片段创建时间（Unix时间戳，单位为秒）
document_id	dd06afb5-7e33-4953-9247-113879e4653	字符串	所属文档ID
document_name	测试知识库.md	字符串	所属文档名称
enabled	true	布尔值	片段是否启用
lang	zh	字符串	片段语言
score	0.7226141428807815	数字	检索匹配得分
source	Document	字符串	片段来源类型

创建消息

前提条件#

事件头示例#

事件体示例#

字段说明#

一、基础信息字段表#

二、email 嵌套字段子表#

三、attachments 附件数组子表（单条附件结构）#

四、agentLogs 智能体执行日志子表#

1. 日志通用字段说明#

2. 各类型日志专属字段表#

3. knowledge 类型日志的 kb 子数组表（单条检索结果）#

前提条件

事件头示例

事件体示例

字段说明

一、基础信息字段表

二、email 嵌套字段子表

三、attachments 附件数组子表（单条附件结构）

四、agentLogs 智能体执行日志子表

1. 日志通用字段说明

2. 各类型日志专属字段表

3. knowledge 类型日志的 kb 子数组表（单条检索结果）