ดูรายละเอียดทิกเก็ต

ดูรายละเอียดทิกเก็ตโดยใช้ Ticket ID

เมธอดคำขอ

GET

URL คำขอ

https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id

การยืนยันตัวตน

สำหรับรายละเอียดเพิ่มเติม โปรดดูคำแนะนำเกี่ยวกับการยืนยันตัวตนใน API Overview

คำขอ

ตัวอย่างคำขอ

curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \
              
              curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์ Path

Field Type Required Description
ticket_id String Yes Ticket ID

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "title": "Printer jammed and unable to print", "description": "The customer reported that A4 paper is stuck at the paper output tray and requires urgent attention.", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "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 Support" }, "custom_fields": { "device_sn": "PRN-2024-001" }, "conversation_list": [ { "message_id": "msg_20251104_001", "sender": { "id": "u_12345", "type": "internal_member", "name": "เจ้าหน้าที่ฝ่ายสนับสนุนหลี่" }, "content": "We have received your feedback and are processing it.", "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": "Very fast handling", "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": "Printer jammed and unable to print",
    "description": "The customer reported that A4 paper is stuck at the paper output tray and requires urgent attention.",
    "attachments": [
      {
        "file_url": "https://example.com/files/error.jpg"
      }
    ],
    "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 Support"
    },
    "custom_fields": {
      "device_sn": "PRN-2024-001"
    },
    "conversation_list": [
      {
        "message_id": "msg_20251104_001",
        "sender": {
          "id": "u_12345",
          "type": "internal_member",
          "name": "เจ้าหน้าที่ฝ่ายสนับสนุนหลี่"
        },
        "content": "We have received your feedback and are processing it.",
        "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": "Very fast handling",
      "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
  }
}

            
โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์การตอบกลับ

Field Type Required Description
ticket_id String Yes Ticket ID ที่ไม่ซ้ำกัน
title String Yes ชื่อทิกเก็ต
description String Yes รายละเอียดทิกเก็ตโดยละเอียด (รองรับ Markdown)
attachments Array No รายการไฟล์แนบระดับทิกเก็ต
attachments.file_name String Yes ชื่อไฟล์
attachments.file_type String Yes ประเภท MIME
attachments.file_url String Yes URL ของไฟล์
attachments.file_size String Yes ขนาดไฟล์
status String Yes สถานะทิกเก็ต เช่น open, in_progress, resolved หรือ closed
priority String No ระดับความสำคัญ: low, medium, high หรือ urgent
ticket_type String No ประเภททิกเก็ต: incident, question, problem หรือ task
requester Object Yes ข้อมูลผู้ส่งคำขอ
requester.euid String No Contact ID ที่ไม่ซ้ำกัน
requester.name String No ชื่อผู้ติดต่อ
requester.email String No อีเมลของผู้ติดต่อ
requester.phone String No หมายเลขโทรศัพท์ของผู้ติดต่อ
requester.channel_contacts Object No ข้อมูลการแมปผู้ติดต่อของช่องทาง (ต้องมี euid อย่างน้อยหนึ่งรายการ)
requester.channel_contacts.channel_id String Yes Channel ID
requester.channel_contacts.contact_id String Yes Channel Contact ID เช่น chat_id ของ Telegram
requester.channel_contacts.sub_contact_id String No Channel Sub-contact ID เช่น topic_id ของ Telegram หรือ thread_id ของอีเมล
requester.channel_contacts.followers Array No ข้อมูล Follower ID ที่ใช้สำหรับการพุชหรือการแจ้งเตือนภายในช่องทาง ซึ่งประกอบด้วยฟิลด์ id และ name
submitter Object No สมาชิกภายในที่ส่งทิกเก็ต
submitter.id String Yes User ID ของผู้ส่ง
assignment_team Object No ข้อมูลทีมที่ได้รับมอบหมาย
assignment_team.id Integer Yes Team ID
assignment_team.name String Yes ชื่อทีม
custom_fields Object No ฟิลด์ที่กำหนดเอง เช่น หมายเลขซีเรียลของอุปกรณ์และหมายเลขคำสั่งซื้อ
custom_fields.device_sn String Yes หมายเลขซีเรียลของอุปกรณ์
conversation_list Array Yes ประวัติข้อความทั้งหมดของทิกเก็ต
conversation_list.message_id String Yes Message ID ที่ไม่ซ้ำกัน
conversation_list.sender Object Yes ข้อมูลผู้ส่ง
conversation_list.sender.id String Yes Sender ID
conversation_list.sender.type String Yes ประเภทผู้ส่ง: internal_member, system หรือ bot
conversation_list.sender.name String No ชื่อผู้ส่ง
conversation_list.content String No เนื้อหาข้อความ
conversation_list.content_type String Yes ประเภทเนื้อหา: text, image, file, audio หรือ video
conversation_list.attachments Array No รายการไฟล์แนบของข้อความ
conversation_list.attachments.file_type String Yes ประเภท MIME
conversation_list.attachments.file_url String Yes URL ของไฟล์
conversation_list.sent_at String Yes เวลาที่ส่ง (ISO 8601)
conversation_list.is_internal Boolean Yes ระบุว่าข้อความนี้เป็นข้อความภายในที่ลูกค้ามองไม่เห็นหรือไม่
status_changes Array No บันทึกการเปลี่ยนสถานะทิกเก็ต
status_changes.to_status String No สถานะหลังการเปลี่ยนแปลง เช่น open, resolved หรือรหัสที่กำหนดเอง
status_changes.changed_at String No เวลาที่เปลี่ยนแปลง (ISO 8601)
status_changes.changed_by_type String No แหล่งที่มาของการเปลี่ยนแปลง: user, system หรือ bot
status_changes.changed_by_id String No ส่งคืนเมื่อ changed_by_type เป็น user
tags Array No แท็กของทิกเก็ต
sla Object No ข้อมูล SLA
sla.first_response_due String No กำหนดเวลาการตอบกลับครั้งแรก
sla.resolution_due String No กำหนดเวลาแก้ไขปัญหา
sla.first_response_at String No เวลาที่ตอบกลับครั้งแรกจริง
sla.breached Boolean No ระบุว่า SLA ถูกละเมิดหรือไม่
followers Array No รายการผู้ติดตาม
satisfactions Object No ผลการสำรวจความพึงพอใจของลูกค้า
satisfactions.rating Integer No คะแนนตั้งแต่ 1 ถึง 5
satisfactions.feedback String No ความคิดเห็นแบบข้อความ
satisfactions.submitted_at String No เวลาที่ส่ง
created_at String Yes เวลาที่สร้างทิกเก็ต (ISO 8601)
updated_at String Yes เวลาที่อัปเดตทิกเก็ตล่าสุด
resolved_at String No เวลาที่แก้ไขเสร็จ (null หากยังไม่ได้แก้ไข)
closed_at String No เวลาที่ปิด (null หากยังไม่ปิด)
Icon Solid Transparent White Qiyu
ติดต่อฝ่ายขาย