获取沟通记录

更新时间：2023-06-20 12:34:12

本文介绍获取沟通记录的 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
}

错误码

参考错误码。

上一篇用户反馈管理

下一篇获取工单列表