获取沟通记录

更新时间:2023-06-15 05:13:03

本文介绍获取沟通记录的 API。

接口描述

根据工单 ID获取指定工单下的沟通记录。您也可以通过查询类型,更改查询范围。

接口地址

GET: /v1.0/iot-01/ticket/feedbacks/{feedback_id}/communications

请求参数

参数名 类型 参数位置 是否必填 说明
feedback_id String uri true 工单 ID
query_mode String query true 查询日志类型:
  • 0:所有记录
  • 1:仅包含沟通记录,不包含操作记录
page_no Integer query false 分页页码,默认值为 1
page_size Integer query false 分页页面大小,默认值为 10
is_asc Boolean query false 是否按操作时间升序排序。默认值为 False

返回参数

参数名 类型 说明
result PageVO

result 说明

参数名 类型 说明
total Integer 搜索命中总结果数
list List 分页数据
page_size Integer 分页大小
has_more Boolean 是否还有更多分页

list 说明

参数名 类型 说明
ticket_id String 工单 ID
account String 用户账号(B 端或者 C 端账号)
content Map 沟通内容
app_version String App 版本号
operate String 操作类型
operate_at String 操作时间
phone_language String 手机语言
operator_uid String 操作人 UID
phone_model String 手机型号
phone_system String 手机系统
time_zone String 时区
user_type String 用户类型
nick_name String 用户昵称(C 端用户的昵称)
company_name String 公司名称
account_nick_name String 账号昵称(B 端 IoT 群组设置 IoT 账号昵称)

请求示例

GET: GET:/v1.0/iot-01/ticket/feedbacks/Noxxxxx/communications?queryMode=1

返回示例

{ "result": { "data": [ { "account_nick_name": "", "ticket_id": "146****", "time_zone": "GMT+8", "content": { "state": { "new_val": "Finished", "old_val": "Processing" } }, "operate": "close", "operate_at": "1638253350631", "user_type": "2", "company_name": "", "operator_uid": "1111" } ], "page_no": 1, "total": 5, "has_more": true, "page_size": 10 }, "t": 1638431068200, "success": true }

错误码

参考 错误码