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

前提条件

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

事件头示例

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

事件体示例

{
    "requestId": "03703d30-50f2-4103-bdb6-8aa331f36cc5", // 请求唯一标识符
    "businessType": 15009, // 业务类型代码

    "data": {
      "id": "visitor_001",
      "workSpaceId": "ws_abc", 
      "channelId": "ch_livechat_01",
      "name": "王小明",
      "email": "xiaoming.wang@example.com", 
      "phoneNumber": "+86-13800138000", 
      "language": "zh-CN", 
      "accountId": "acc_1001", 
      "lastVisitIp": "203.0.113.45", 
      "browserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)", 
      "fistTouch": "https://example.com/landing?utm=campaign", 
      "lastTouch": "https://example.com/product/1", 
      "externalReferrerLast": "google.com", 
      "landingPageLast": "/product/1", 
      "utmSourceLast": "newsletter", 
      "firstVisitTime": 1690000000, 
      "lastVisitTime": 1690003600, 
      "totalVisits": 5, 
      "externalUserId": "wo56kvDgAA5VmZqvgsX8d-cDmSDXCZXQ", 
      "botUserId": "abc@xinheyun.com", 
      "imBotId": "1688856053740892", 
      "orgId": "6887410937e2124b6d6265a1", 
      "createdTime": 1690000000, 
      "updatedTime": 1690003600, 
      "extendMap": { 
        "preferredContact": "email", 
        "customerTier": "gold" 
      }
    }
}

字段说明

字段名	字段值	字段类型	字段说明
id	visitor_001	字符串	访客标识，全局唯一
workSpaceId	ws_abc	字符串	工作空间ID
channelId	ch_livechat_01	字符串	渠道ID
name	王小明	字符串	访客名称
email	xiaoming.wang@example.com	字符串	访客邮箱
phoneNumber	+86-13800138000	字符串	访客电话
language	zh-CN	字符串	访客使用的语言
accountId	acc_1001	字符串	平台账号ID，不同渠道对应不同值：IM渠道代表IM平台的imContactId
lastVisitIp	203.0.113.45	字符串	访客最后访问的IP地址
browserAgent	Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)	字符串	访客浏览器的Agent信息
fistTouch	https://example.com/landing?utm=campaign	字符串	访客初次接触的URL（注：字段名疑似笔误，应为firstTouch）
lastTouch	https://example.com/product/1	字符串	访客最近接触的URL
externalReferrerLast	google.com	字符串	访客最近访问的外部来源
landingPageLast	/product/1	字符串	访客最近访问的落地页路径
utmSourceLast	newsletter	字符串	访客最近访问的UTM来源
firstVisitTime	1690000000	数字	访客首次访问时间（Unix时间戳，单位为秒）
lastVisitTime	1690003600	数字	访客最后访问时间（Unix时间戳，单位为秒）
totalVisits	5	数字	访客总访问次数
externalUserId	wo56kvDgAA5VmZqvgsX8d-cDmSDXCZXQ	字符串	IM平台专属：客户的企业微信externalUserId
botUserId	abc@xinheyun.com	字符串	IM平台专属：托管账号对应成员的系统wxid
imBotId	1688856053740892	字符串	IM平台专属：托管账号对应成员的系统wxid（注：与botUserId描述重复，需确认业务含义）
orgId	6887410937e2124b6d6265a1	字符串	IM平台专属：企业ID
extendMap	{}	对象	拓展自定义字段
createdTime	1690000000	数字	访客记录创建时间（Unix时间戳，单位为秒）
updatedTime	1690003600	数字	访客记录更新时间（Unix时间戳，单位为秒）

更新访客

前提条件#

事件头示例#

事件体示例#

字段说明#

前提条件

事件头示例

事件体示例

字段说明