Buat Tiket
Developer dapat membuat tiket melalui API. Setelah tiket dibuat, ID tiket akan dikembalikan.
Metode Permintaan
POST
Endpoint
https://livedesk-api.engagelab.com/api/v2/accounts/tickets
Autentikasi
Untuk detailnya, lihat panduan autentikasi di Ringkasan API.
Permintaan
Contoh Permintaan
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": "Kertas printer macet, tidak dapat mencetak",
"description": "Pelanggan melaporkan bahwa kertas A4 tersangkut di saluran keluar kertas dan memerlukan penanganan segera.",
"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": "Dukungan TI",
"priority": "high",
"ticket_type": "incident",
"custom_fields": {
"device_sn": "PRN-2024-001",
"location": "Kantor Pusat Beijing—Ruang Printer Lantai 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": "Kertas printer macet, tidak dapat mencetak",
"description": "Pelanggan melaporkan bahwa kertas A4 tersangkut di saluran keluar kertas dan memerlukan penanganan segera.",
"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": "Dukungan TI",
"priority": "high",
"ticket_type": "incident",
"custom_fields": {
"device_sn": "PRN-2024-001",
"location": "Kantor Pusat Beijing—Ruang Printer Lantai 3"
}
}'
Tampilkan blok kode ini di jendela mengambang
Header Permintaan
| Field | Type | Description |
|---|---|---|
| Authorization | string | Lakukan autentikasi menggunakan Authorization: Basic base64(API Key:API Secret). Buka halaman API Keys untuk memperoleh API key dan API secret, gabungkan keduanya dengan tanda titik dua, lalu enkode dalam Base64. |
| Content-Type | application/json | Tipe data. Nilainya harus application/json. |
Parameter Body Permintaan
| Field | Type | Required | Description |
|---|---|---|---|
| title | String | Yes | Judul tiket. |
| description | String | No | Deskripsi tiket. Mendukung format Markdown. |
| attachments | Array | No | Array lampiran. Unggah file melalui /upload terlebih dahulu. |
| file_url | String | Yes | URL file. |
| requester | Object | Yes | Informasi peminta. |
| euid | String | No | ID kontak unik. |
| channel_contacts | Object | No | Pemetaan kontak channel. Minimal salah satu dari euid atau field ini harus diberikan. |
| channel_id | String | Yes | ID channel. |
| contact_id | String | Yes | ID kontak channel, seperti ID chat Telegram. |
| sub_contact_id | String | No | ID subkontak channel, seperti ID topik Telegram atau ID rangkaian email. |
| followers | Array | No | Informasi ID pengikut yang digunakan untuk pengiriman dan notifikasi dalam channel, mencakup field id dan name.id: ID pengikut.name: Nama pengikut. |
| submitter | Object | No | Informasi pengirim, mencakup field id.id: ID pengirim. |
| assignment_team | String | No | Nama tim penugasan. Tim tersebut harus sudah ada. |
| priority | String | No | Prioritas: high, medium, atau low. Jika tidak diberikan, nilai default adalah medium. |
| ticket_type | String | No | Jenis tiket: problem, incident, question, task, atau none. Jika tidak diberikan, nilai default adalah none. |
| custom_fields | Object | No | Field kustom, seperti informasi sumber, dalam format key-value. |
Respons
Respons Berhasil
{
"code": 0,
"message": "Success",
"data": {
"ticket_id": "tk_20251104_789abc",
"message": "Ticket created successfully"
}
}
{
"code": 0,
"message": "Success",
"data": {
"ticket_id": "tk_20251104_789abc",
"message": "Ticket created successfully"
}
}
Tampilkan blok kode ini di jendela mengambang
Parameter Respons
| Field | Type | Required | Description |
|---|---|---|---|
| ticket_id | String | No | ID tiket. |
| message | String | No | Konten pesan yang dikembalikan. Contoh: "Ticket created successfully". |
