Skip to content

同步访客咨询上下文

POST /visitor/data/contexts

替换当前访客的完整咨询上下文。适用于把商品、订单、当前页面等资料同步给客服工作台;本次未提交的旧上下文不会保留。

请求参数

字段位置类型必填用途
contextsbodyarray当前访客完整的上下文列表。

contexts[]

字段类型必填用途
keystring上下文唯一标识。
typestring上下文类型,未传时为 custom
titlestring客服侧展示标题。
urlstring关联页面或资源 URL。
fieldsarray上下文中的结构化字段。

contexts[].fields[]

字段类型用途
keystring字段机器名。
labelstring字段展示名称。
typestring字段类型,默认文本类型。
valuestring | number | boolean | null字段值。

成功响应

json
{
  "code": 0,
  "msg": "ok",
  "data": {
    "contexts": [
      {
        "key": "<上下文标识>",
        "type": "custom",
        "title": "<上下文标题>",
        "url": "<关联 URL>",
        "fields": []
      }
    ]
  }
}

data.contexts 为服务端保存后的完整上下文集。