สร้างใบงาน

นักพัฒนาสามารถสร้างทิคเก็ตผ่าน API ได้ เมื่อสร้างสำเร็จจะส่งคืน ID ของทิคเก็ต

วิธีคำขอ

POST

ที่อยู่เรียกใช้

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

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

ดูรายละเอียดที่ ภาพรวม API เกี่ยวกับวิธีการยืนยันตัวตน

คำขอ

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

curl -X POST 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \ -d '{ "title": "กระดาษติดในเครื่องพิมพ์ ไม่สามารถพิมพ์ได้", "description": "ลูกค้าแจ้งว่า A4 ติดที่ช่องออกกระดาษ ต้องการความช่วยเหลือด่วน", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "requester": { "euid": "contact_12345", "channel_contacts": { "channel_id": "inbox_100", "contact_id": "-1001234567890", "sub_contact_id": "23232323", "followers": [ { "id": "7562646527", "name": "Zhang San" } ] } }, "submitter": { "id": "u_12345" }, "assignment_team": "ฝ่าย IT สนับสนุน", "priority": "high", "ticket_type": "incident", "custom_fields": { "device_sn": "PRN-2024-001", "location": "สำนักงานใหญ่ปักกิ่ง — ห้องพิมพ์ ชั้น 3" } }'

              
              curl -X POST 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
  "title": "กระดาษติดในเครื่องพิมพ์ ไม่สามารถพิมพ์ได้",
  "description": "ลูกค้าแจ้งว่า A4 ติดที่ช่องออกกระดาษ ต้องการความช่วยเหลือด่วน",
  "attachments": [
    {
      "file_url": "https://example.com/files/error.jpg"
    }
  ],
  "requester": {
    "euid": "contact_12345",
    "channel_contacts": {
      "channel_id": "inbox_100",
      "contact_id": "-1001234567890",
      "sub_contact_id": "23232323",
      "followers": [
        {
          "id": "7562646527",
          "name": "Zhang San"
        }
      ]
    }
  },
  "submitter": {
    "id": "u_12345"
  },
  "assignment_team": "ฝ่าย IT สนับสนุน",
  "priority": "high",
  "ticket_type": "incident",
  "custom_fields": {
    "device_sn": "PRN-2024-001",
    "location": "สำนักงานใหญ่ปักกิ่ง — ห้องพิมพ์ ชั้น 3"
  }
}'

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

ส่วนหัวคำขอ

ฟิลด์	ชนิด	คำอธิบาย
Authorization	string	ใช้ `Authorization: Basic base64(API Key:API Secret)` สำหรับการยืนยัน โปรดไปที่หน้าคีย์ API เพื่อรับ API Key และ API Secret และเชื่อมทั้งสองด้วยโคลอนก่อนเข้ารหัส Base64
Content-Type	application/json	ประเภทข้อมูล ใช้ค่า `application/json`

พารามิเตอร์ในคำขอ

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
title	String	ใช่	ชื่อทิคเก็ต
description	String	ไม่	คำอธิบายเนื้อหาทิคเก็ต รองรับรูปแบบ md
attachments	Array	ไม่	อาร์เรย์ไฟล์แนบ ต้องอัปโหลดผ่าน `/upload` ก่อน
file_url	String	ใช่	ที่อยู่ไฟล์
requester	Object	ใช่	ข้อมูลผู้ร้องขอ
euid	String	ไม่	ID เฉพาะของผู้ติดต่อ
channel_contacts	Object	ไม่	การแมปผู้ติดต่อในช่องทาง (ต้องมีอย่างน้อยหนึ่งระหว่าง euid และ channel_contacts)
channel_id	String	ใช่	ID ช่องทาง
contact_id	String	ใช่	ID ผู้ติดต่อในช่องทาง (เช่น chat_id ของ TG)
sub_contact_id	String	ไม่	ID ผู้ติดต่อย่อย (เช่น topic_id ของ TG / thread_id ของ Email)
followers	Array	ไม่	ข้อมูลผู้ติดตาม (ใช้สำหรับการแจ้งในช่องทาง) รวมฟิลด์ id และ name
submitter	Object	ไม่	ID ผู้ส่งคำขอ (บัญชีสมาชิกภายใน) มีฟิลด์ id id: ID ผู้ส่งคำขอ
assignment_team	String	ไม่	ชื่อทีมที่ได้รับมอบหมาย (ต้องมีอยู่ก่อน)
priority	String	ไม่	ระดับความสำคัญ: high/medium/low ค่าเริ่มต้น `medium`
ticket_type	String	ไม่	ประเภททิคเก็ต: problem/incident/question/task/None ค่าเริ่มต้น `None`
custom_fields	Object	ไม่	ฟิลด์กำหนดเอง (เช่นข้อมูลแหล่งที่มา) ใช้รูปแบบ key-value

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

ตอบกลับสำเร็จ

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "message": "สร้างทิคเก็ตสำเร็จ" } }

              
              {
  "code": 0,
  "message": "Success",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "message": "สร้างทิคเก็ตสำเร็จ"
  }
}

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

คำอธิบายพารามิเตอร์ตอบกลับ

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
ticket_id	String	ไม่	ID ทิคเก็ต
message	String	ไม่	ข้อความตอบกลับ เช่น "สร้างทิคเก็ตสำเร็จ"