Create Ticket

Pengembang dapat membuat tiket melalui API. Setelah tiket berhasil dibuat, ID tiket akan dikembalikan.

Metode Permintaan

POST

URL Permintaan

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

Autentikasi

Silakan lihat penjelasan autentikasi di Gambaran Umum API untuk detail lebih lanjut.

Permintaan

Contoh Permintaan

curl -X POST 'https://livedesk-api.engagelab.com/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 kertas A4 macet di baki keluaran, membutuhkan 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": "IT Support", "priority": "high", "ticket_type": "incident", "custom_fields": { "device_sn": "PRN-2024-001", "location": "Kantor Pusat Beijing - Ruang Print Lantai 3" } }'

              
              curl -X POST 'https://livedesk-api.engagelab.com/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 kertas A4 macet di baki keluaran, membutuhkan 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": "IT Support",
  "priority": "high",
  "ticket_type": "incident",
  "custom_fields": {
    "device_sn": "PRN-2024-001",
    "location": "Kantor Pusat Beijing - Ruang Print Lantai 3"
  }
}'

Tampilkan blok kode ini di jendela mengambang

Header Permintaan

Field	Tipe	Deskripsi
Authorization	string	Gunakan `Authorization: Basic base64(API Key:API Secret)` untuk autentikasi. Silakan kunjungi halaman API Key untuk mendapatkan API Key dan API Secret, lalu gabungkan dengan tanda titik dua sebelum melakukan encoding Base64.
Content-Type	application/json	Tipe data, nilainya adalah application/json.

Parameter Body

Field	Tipe	Wajib	Deskripsi
title	String	Ya	Judul tiket.
description	String	Tidak	Deskripsi isi tiket, mendukung format md.
attachments	Array	Tidak	Array lampiran, perlu diunggah melalui /upload terlebih dahulu.
file_url	String	Ya	Alamat file.
requester	Object	Ya	Informasi pemohon.
euid	String	Tidak	ID unik kontak.
channel_contacts	Object	Tidak	Pemetaan kontak channel (minimal salah satu dengan euid ada).
channel_id	String	Ya	ID channel.
contact_id	String	Ya	ID kontak channel (misal, TG chat_id).
sub_contact_id	String	Tidak	ID sub-kontak channel (misal, TG topic_id / Email thread_id).
followers	Array	Tidak	Informasi ID pengikut (untuk notifikasi/push dalam channel), termasuk field id dan name. id: ID pengikut. name: Nama pengikut.
submitter	Object	Tidak	ID pengirim (ID akun anggota internal), termasuk field id. id: ID pengirim.
assignment_team	String	Tidak	Nama tim yang ditugaskan (harus sudah ada).
priority	String	Tidak	Prioritas: high/medium/low, default medium jika tidak diisi.
ticket_type	String	Tidak	Tipe tiket: problem/incident/question/task/None, default None jika tidak diisi.
custom_fields	Object	Tidak	Field kustom (informasi sumber, dll), menggunakan format key-value.

Contoh Respons

Respons Berhasil

{ "code": 0, "message": "Sukses", "data": { "ticket_id": "tk_20251104_789abc", "message": "Tiket berhasil dibuat" } }

              
              {
  "code": 0,
  "message": "Sukses",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "message": "Tiket berhasil dibuat"
  }
}

Tampilkan blok kode ini di jendela mengambang

Parameter Respons

Field	Tipe	Wajib	Deskripsi
ticket_id	String	Tidak	ID tiket.
message	String	Tidak	Isi pesan balasan. Contoh: "Tiket berhasil dibuat"