同步访客咨询上下文

POST /visitor/data/contexts

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

上下文通常在获取访客基础数据后、发送消息前同步；Web Widget 的对应配置方式见Web / H5 接入。

请求参数

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

contexts[]

字段	类型	必填	用途
key	string	是	上下文唯一标识。
type	string	否	上下文类型，未传时为 custom。
title	string	否	客服侧展示标题。
url	string	否	关联页面或资源 URL。
fields	array	否	上下文中的结构化字段。

contexts[].fields[]

字段	类型	用途
key	string	字段机器名。
label	string	字段展示名称。
type	string	字段类型，默认文本类型。
value	string | number | boolean | null	字段值。

成功响应

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

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