获取工单详情

提供获取工单详情的功能.

地址

GET /v2/accounts/tickets/:ticket_id

鉴权

Authorization: Bearer base64(api_key:api_secret)

请求头

curl --request GET \ --url https://livedesk.engagelab.com/v2/accounts/tickets/:ticket_id \ --H "Content-Type: application/json" \ --H "Authorization: Bearer base64(api_key:api_secret)"
              
              curl --request GET \
  --url https://livedesk.engagelab.com/v2/accounts/tickets/:ticket_id \
  --H "Content-Type: application/json" \
  --H "Authorization: Bearer base64(api_key:api_secret)" 

            
このコードブロックはフローティングウィンドウ内に表示されます

路径参数

字段 类型 必填 描述
ticket_id String 工单ID。

响应示例

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "title": "打印机卡纸,无法打印", "description": "客户反映A4纸卡在出纸口,急需处理。", "attachments": [ { "file_name": "error-photo.jpg", "file_type": "image/jpeg", "file_url": "https://example.com/files/error.jpg", "file_size": 1220 } ], "status": "open", "priority": "high", "ticket_type": "incident", "requester": { "euid": "contact_12345", "name": "张三", "email": "zhangsan@example.com", "phone": "+8613900000000", "channel_contacts": { "channel_id": "inbox_100", "contact_id": "-1001234567890", "sub_contact_id": "23232323", "followers": ["u_12345", "u_67890"] } }, "submitter": { "id": "u_99999" } "assignment_team": { "id": 5, "name": "IT支持" }, "custom_fields": { "device_sn": "PRN-2024-001" }, "conversation_list": [ { "message_id": "msg_20251104_001", "sender": { "id": "u_12345", "type": "internal_member", "name": "客服小李" }, "content": "我们已收到你的反馈,正在处理。", "content_type": "text", "attachments": [ { "file_type": "image/jpeg", "file_url": "https://example.com/files/progress.jpg" }, { "file_type": "application/pdf", "file_url": "https://example.com/files/report.pdf" } ], "sent_at": "2025-11-19T05:55:25Z", "is_internal": false } ], "status_changes": [ { "to_status": "in_progress", "changed_at": "2025-11-04T09:25:00+08:00", "changed_by_type": "user", "changed_by_id": "u_12345" }, { "to_status": "resolved", "changed_at": "2025-11-04T10:30:00+08:00", "changed_by_type": "system" } ], "tags": ["printer", "hardware"], "sla": { "first_response_due": "2025-11-04T10:00:00+08:00", "resolution_due": "2025-11-05T18:00:00+08:00", "first_response_at": "2025-11-04T09:20:00+08:00", "breached": false }, "followers": [ {"id": "u_12345"}, {"id": "u_67890"} ], "satisfactions": { "rating": 5, "feedback": "处理很快", "submitted_at": "2025-11-05T09:20:00+08:00" }, "created_at": "2025-11-04T09:15:22+08:00", "updated_at": "2025-11-04T09:18:45+08:00", "resolved_at": null, "closed_at": null } }
              
              {
  "code": 0,
  "message": "Success",
  "data": {
    "ticket_id": "tk_20251104_789abc",                     
    "title": "打印机卡纸,无法打印",                       
    "description": "客户反映A4纸卡在出纸口,急需处理。",      
    "attachments": [                                      
      {
        "file_name": "error-photo.jpg",                    
        "file_type": "image/jpeg",                         
        "file_url": "https://example.com/files/error.jpg", 
        "file_size": 1220                                  
      }
    ],
    "status": "open",                                      
    "priority": "high",                                    
    "ticket_type": "incident",                             
    "requester": {                                         
      "euid": "contact_12345",                             
      "name": "张三",                                      
      "email": "zhangsan@example.com",                     
      "phone": "+8613900000000",                           
      "channel_contacts": {                                
        "channel_id": "inbox_100",                         
        "contact_id": "-1001234567890",                    
        "sub_contact_id": "23232323",                      
        "followers": ["u_12345", "u_67890"]                
      }
    },
    "submitter": {                                         
      "id": "u_99999"                                      
    }
    "assignment_team": {                                  
      "id": 5,
      "name": "IT支持"
    },
    "custom_fields": {                                     
      "device_sn": "PRN-2024-001"
    },
    "conversation_list": [                                 
      {
        "message_id": "msg_20251104_001",                  
        "sender": {
          "id": "u_12345",                                 
          "type": "internal_member",                      
          "name": "客服小李"                                 
        },
        "content": "我们已收到你的反馈,正在处理。",            
        "content_type": "text",                             
        "attachments": [                                    
          {
            "file_type": "image/jpeg",                    
            "file_url": "https://example.com/files/progress.jpg" 
          },
          {
            "file_type": "application/pdf",
            "file_url": "https://example.com/files/report.pdf"
          }
        ],
        "sent_at": "2025-11-19T05:55:25Z",
        "is_internal": false                               
      }
    ],
    "status_changes": [                                    
      {
        "to_status": "in_progress",                         
        "changed_at": "2025-11-04T09:25:00+08:00",          
        "changed_by_type": "user",                          
        "changed_by_id": "u_12345"                          
      },
      {
        "to_status": "resolved",
        "changed_at": "2025-11-04T10:30:00+08:00",
        "changed_by_type": "system"                         
      }
    ],
    "tags": ["printer", "hardware"],                      
    "sla": {                                               
      "first_response_due": "2025-11-04T10:00:00+08:00",   
      "resolution_due": "2025-11-05T18:00:00+08:00",       
      "first_response_at": "2025-11-04T09:20:00+08:00",    
      "breached": false                                    
    },
    "followers": [                                         
      {"id": "u_12345"},
      {"id": "u_67890"}
    ],
    "satisfactions": {                                     
      "rating": 5,                                         
      "feedback": "处理很快",                                
      "submitted_at": "2025-11-05T09:20:00+08:00"          
    },
    "created_at": "2025-11-04T09:15:22+08:00",             
    "updated_at": "2025-11-04T09:18:45+08:00",             
    "resolved_at": null,                                   
    "closed_at": null                                      
  }
}

            
このコードブロックはフローティングウィンドウ内に表示されます

响应参数

字段 类型 必填 描述
ticket_id String 工单唯一ID
title String 工单标题
description String 工单详细描述(支持 Markdown
attachments Array 工单级附件列表
status String 工单状态:open/in_progress/resolved/closed 等。
priority String 优先级:low/medium/high/urgent。
ticket_type String 工单类型:incident/question/problem/task
requester Object 请求人(客户)信息
submitter Object 提交人工单的内部成员。
assignment_team Object 分配团队信息。
custom_fields Object 自定义字段(如设备序列号、订单号等)。
conversation_list Array 工单内所有消息历史。
status_changes Array 工单状态变更记录。
tags Array 工单标签。
sla Object SLA 服务水平协议信息。
followers Array 关注者列表。
satisfactions Object 满意度调查结果。
created_at String 工单创建时间(ISO8601。
updated_at String 工单最后更新时间。
resolved_at String 解决时间(未解决为 null)。
closed_at String 关闭时间(未关闭为 null)。

attachments

字段 类型 必填 描述
file_name String 文件名。
file_type String MIME。
file_url String 文件地址。
file_size String 大小。

requester

字段 类型 必填 描述
euid String 联系人唯一ID。
name String 姓名。
email String 邮箱。
phone String 电话。
channel_contacts Object 渠道联系人映射(与 euid 至少存在一个)。

submitter

字段 类型 必填 描述
submitter.id String 提交者用户 ID 。

assignment_team

字段 类型 必填 描述
id Integer 团队 ID 。
name String 团队名称。

custom_fields

字段 类型 必填 描述
device_sn String 关注者ID。
location String 关注者名称。

conversation_list

字段 类型 必填 描述
message_id String 消息唯一 ID。
sender Object 发送者信息
content String 消息文本内容
content_type String 内容类型:text/image/file/audio/video
attachments Array[Object] 消息附件列表
sent_at String 发送时间(ISO8601)
is_internal boolean 是否为内部消息(客户不可见)
sender
字段 类型 必填 描述
id String 发送者 ID 。
type String 发送者类型:internal_member/system/bot。
name String 发送者名称。

status_changes

字段 类型 必填 描述
to_status String 关注者ID.变更后的状态(open/resolved 或自定义代码)。
changed_at String 变更时间(ISO8601)。
changed_by_type String 变更来源:user/system/bot。
changed_by_id String 当 changed_by_type 为 user 时返回。

sla

字段 类型 必填 描述
first_response_due String 首响截止时间。
resolution_due String 解决截止时间。
first_response_at String 实际首响时间。
sla.breached boolean 是否违约。

satisfactions

字段 类型 必填 描述
rating Integer 评分 1-5 。
feedback String 文字反馈。
submitted_at String 提交时间 。
icon
お問い合わせ