获取工单沟通记录

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTicketNotes

系统规定参数。取值:ListTicketNotes。

TicketId String 0005PYGCW

工单编号

返回数据

名称 类型 示例值 描述
Code Integer 0

接口请求结果返回码

Data Array of Data

返回值, 即指定工单的对话记录列表数据

CreateTime Long 1623396736000

工单创建时间的时间戳

Dialog Struct

工单沟通记录对象

Content String 你好, 我的ECS续费失败, 请问是什么原因

工单沟通内容

Schema String null

工单沟通记录系统卡片, 将来开放系统卡片对接能力时使用, 目前阶段用content取纯文本内容即可

DialogId Long 9999

对话记录唯一ID标识

Status Integer 6

工单状态字段, 参考值

1, "assigned", "待响应",

2, "dealing", "处理中",

3, "wait_feedback", "待反馈",

4, "feedback", "已反馈",

5, "wait_confirm", "待确认",

6, "confirmed", "已完成"

Tip String null

暂不使用的字段

Type Integer 1

对话类型

1 卡片, 即schema

2 文本, 即content

User Struct

对话的用户

Name String 工单小二

对话用户名称

Role Integer 3

对话用户角色, 区分小二和用户使用

2, 客服

3, 用户

Message String 入参非法

错误信息, 当success=false的时候, 可以取到message

RequestId String AC0AB2EC-AFBC-44BA-AE77-132A5A1EC0AD

接口请求的唯一ID, 每次调用requestID唯一

Success Boolean true

调用接口返回是否成功, true代表调用正常

示例

请求示例

http(s)://[Endpoint]/?Action=ListTicketNotes
&TicketId=0005PYGCW
&<公共请求参数>

正常返回示例

XML格式

<Message>入参非法</Message>
<RequestId>AC0AB2EC-AFBC-44BA-AE77-132A5A1EC0AD</RequestId>
<Data>
    <Status>6</Status>
    <Type>1</Type>
    <CreateTime>1623396736000</CreateTime>
    <DialogId>9999</DialogId>
    <Tip>null</Tip>
    <Dialog>
        <Content>你好, 我的ECS续费失败, 请问是什么原因</Content>
        <Schema>null</Schema>
    </Dialog>
    <User>
        <Role>3</Role>
        <Name>工单小二</Name>
    </User>
</Data>
<Code>0</Code>
<Success>true</Success>

JSON格式

{
    "Message": "入参非法",
    "RequestId": "AC0AB2EC-AFBC-44BA-AE77-132A5A1EC0AD",
    "Data": {
        "Status": 6,
        "Type": 1,
        "CreateTime": 1623396736000,
        "DialogId": 9999,
        "Tip": "null",
        "Dialog": {
            "Content": "你好, 我的ECS续费失败, 请问是什么原因",
            "Schema": "null"
        },
        "User": {
            "Role": 3,
            "Name": "工单小二"
        }
    },
    "Code": 0,
    "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
500 System.error An error occurred while processing your request. 系统出现未知错误,请重试

访问错误中心查看更多错误码。