客户档案和工单
查询和同步客户档案，从你的系统创建工单。
4.4 客户档案
同一个顾客的会话归到一份客户档案，会话里的 contact_id 指向它。识别规则：你签名的会员 ID（user_token 或 API 传的 user.id）> 渠道用户（如微信 openid）> 网页访客。匿名访客登录后并入会员的档案；两个不同会员不会自动合并，邮箱、手机相同的只在后台提示，由客服手动合并。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/contacts?user_id= 或 ?email= | 按你的会员 ID 或邮箱查客户档案 |
| GET | /v1/contacts/{id} | 客户档案：姓名、邮箱、手机、标签 tags、备注 notes、自定义字段 attributes、会话数、最近来访时间、会员 ID user_ids |
| PATCH | /v1/contacts/{id} | 从你的系统同步资料：name、phone、tags（最多 30 个）、notes、attributes（整体替换，最多 30 个字段）。只传要改的字段 |
4.5 工单
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/tickets | 建工单，比如网站的「联系我们」表单：subject、description、priority（urgent / high / normal / low）、顾客的 name / email / phone，可选关联 conversation_id 或 contact_id。有邮箱时客服的回复会发邮件给顾客 |
| GET | /v1/tickets/{id} | 工单和时间线（顾客留言、客服回复、状态变化；不含内部备注） |
工单状态：open 待处理、pending 等待顾客、resolved 已解决、closed 已关闭。处理时限按优先级在「机器人设置」里设置。
这篇文档有帮助吗？
最后更新:
