Appearance
同步访客咨询上下文
POST /visitor/data/contexts
替换当前访客的完整咨询上下文。适用于把商品、订单、当前页面等资料同步给客服工作台;本次未提交的旧上下文不会保留。
请求参数
| 字段 | 位置 | 类型 | 必填 | 用途 |
|---|---|---|---|---|
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 | 字段值。 |
成功响应
json
{
"code": 0,
"msg": "ok",
"data": {
"contexts": [
{
"key": "<上下文标识>",
"type": "custom",
"title": "<上下文标题>",
"url": "<关联 URL>",
"fields": []
}
]
}
}data.contexts 为服务端保存后的完整上下文集。