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

前提条件

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

事件头示例

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

事件体示例

{
  "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,
    "createdTime": 1690000000,
    "updatedTime": 1690003600,
    "extendMap": {
      "preferredContact": "email",
      "customerTier": "gold"
    }
  }
}

创建访客

前提条件#

事件头示例#

事件体示例#

前提条件

事件头示例

事件体示例