ดูรายละเอียดทิกเก็ต
ดูรายละเอียดทิกเก็ตโดยใช้ 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 หากยังไม่ปิด) |










