Dapatkan Detail Tiket | LiveDesk API Ticket Bahasa Indonesia

Mendapatkan detail tiket berdasarkan ID tiket.

Metode Permintaan

GET

URL Permintaan

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

Autentikasi

Untuk informasi selengkapnya, lihat petunjuk autentikasi di Ikhtisar API.

Permintaan

Contoh Permintaan

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)' \

Tampilkan blok kode ini di jendela mengambang

Parameter Jalur

Field	Tipe	Wajib	Deskripsi
ticket_id	String	Ya	ID tiket.

Respons

Contoh Respons

{ "code": 0, "message": "Berhasil", "data": { "ticket_id": "tk_20251104_789abc", "title": "Printer macet dan tidak dapat mencetak", "description": "Pelanggan melaporkan bahwa kertas A4 tersangkut di baki keluaran kertas dan memerlukan penanganan segera.", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "status": "open", "priority": "high", "ticket_type": "incident", "requester": { "euid": "contact_12345", "name": "Zhang San", "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": "Dukungan TI" }, "custom_fields": { "device_sn": "PRN-2024-001" }, "conversation_list": [ { "message_id": "msg_20251104_001", "sender": { "id": "u_12345", "type": "internal_member", "name": "Agen Dukungan Li" }, "content": "Kami telah menerima masukan Anda dan sedang memprosesnya.", "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", "perangkat keras"], "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": "Penanganannya sangat cepat", "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": "Berhasil",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "title": "Printer macet dan tidak dapat mencetak",
    "description": "Pelanggan melaporkan bahwa kertas A4 tersangkut di baki keluaran kertas dan memerlukan penanganan segera.",
    "attachments": [
      {
        "file_url": "https://example.com/files/error.jpg"
      }
    ],
    "status": "open",
    "priority": "high",
    "ticket_type": "incident",
    "requester": {
      "euid": "contact_12345",
      "name": "Zhang San",
      "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": "Dukungan TI"
    },
    "custom_fields": {
      "device_sn": "PRN-2024-001"
    },
    "conversation_list": [
      {
        "message_id": "msg_20251104_001",
        "sender": {
          "id": "u_12345",
          "type": "internal_member",
          "name": "Agen Dukungan Li"
        },
        "content": "Kami telah menerima masukan Anda dan sedang memprosesnya.",
        "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", "perangkat keras"],
    "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": "Penanganannya sangat cepat",
      "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
  }
}

Tampilkan blok kode ini di jendela mengambang

Parameter Respons

Field	Tipe	Wajib	Deskripsi
ticket_id	String	Ya	ID tiket unik.
title	String	Ya	Judul tiket.
description	String	Ya	Deskripsi tiket terperinci (mendukung Markdown).
attachments	Array	Tidak	Daftar lampiran tingkat tiket.
attachments.file_name	String	Ya	Nama file.
attachments.file_type	String	Ya	Jenis MIME.
attachments.file_url	String	Ya	URL file.
attachments.file_size	String	Ya	Ukuran file.
status	String	Ya	Status tiket, seperti `open`, `in_progress`, `resolved`, atau `closed`.
priority	String	Tidak	Prioritas: `low`, `medium`, `high`, atau `urgent`.
ticket_type	String	Tidak	Jenis tiket: `incident`, `question`, `problem`, atau `task`.
requester	Object	Ya	Informasi peminta.
requester.euid	String	Tidak	ID kontak unik.
requester.name	String	Tidak	Nama kontak.
requester.email	String	Tidak	Alamat email kontak.
requester.phone	String	Tidak	Nomor telepon kontak.
requester.channel_contacts	Object	Tidak	Informasi pemetaan kontak saluran (setidaknya satu `euid` harus ada).
requester.channel_contacts.channel_id	String	Ya	ID saluran.
requester.channel_contacts.contact_id	String	Ya	ID kontak saluran, seperti `chat_id` Telegram.
requester.channel_contacts.sub_contact_id	String	Tidak	ID subkontak saluran, seperti `topic_id` Telegram atau `thread_id` email.
requester.channel_contacts.followers	Array	Tidak	Informasi ID pengikut yang digunakan untuk push atau notifikasi dalam saluran, termasuk kolom `id` dan `name`.
submitter	Object	Tidak	Anggota internal yang mengirimkan tiket.
submitter.id	String	Ya	ID pengguna pengirim.
assignment_team	Object	Tidak	Informasi tim penugasan.
assignment_team.id	Integer	Ya	ID tim.
assignment_team.name	String	Ya	Nama tim.
custom_fields	Object	Tidak	Kolom khusus, seperti nomor seri perangkat dan nomor pesanan.
custom_fields.device_sn	String	Ya	Nomor seri perangkat.
conversation_list	Array	Ya	Riwayat pesan lengkap untuk tiket.
conversation_list.message_id	String	Ya	ID pesan unik.
conversation_list.sender	Object	Ya	Informasi pengirim.
conversation_list.sender.id	String	Ya	ID pengirim.
conversation_list.sender.type	String	Ya	Jenis pengirim: `internal_member`, `system`, atau `bot`.
conversation_list.sender.name	String	Tidak	Nama pengirim.
conversation_list.content	String	Tidak	Isi teks pesan.
conversation_list.content_type	String	Ya	Jenis konten: `text`, `image`, `file`, `audio`, atau `video`.
conversation_list.attachments	Array	Tidak	Daftar lampiran pesan.
conversation_list.attachments.file_type	String	Ya	Jenis MIME.
conversation_list.attachments.file_url	String	Ya	URL file.
conversation_list.sent_at	String	Ya	Waktu pengiriman (ISO 8601).
conversation_list.is_internal	Boolean	Ya	Menunjukkan apakah pesan merupakan pesan internal yang tidak terlihat oleh pelanggan.
status_changes	Array	Tidak	Catatan perubahan status tiket.
status_changes.to_status	String	Tidak	Status setelah perubahan, seperti `open`, `resolved`, atau kode khusus.
status_changes.changed_at	String	Tidak	Waktu perubahan (ISO 8601).
status_changes.changed_by_type	String	Tidak	Sumber perubahan: `user`, `system`, atau `bot`.
status_changes.changed_by_id	String	Tidak	Dikembalikan ketika `changed_by_type` adalah `user`.
tags	Array	Tidak	Tag tiket.
sla	Object	Tidak	Informasi SLA.
sla.first_response_due	String	Tidak	Batas waktu respons pertama.
sla.resolution_due	String	Tidak	Batas waktu penyelesaian.
sla.first_response_at	String	Tidak	Waktu respons pertama yang sebenarnya.
sla.breached	Boolean	Tidak	Menunjukkan apakah SLA telah dilanggar.
followers	Array	Tidak	Daftar pengikut.
satisfactions	Object	Tidak	Hasil survei kepuasan pelanggan.
satisfactions.rating	Integer	Tidak	Nilai dari 1 hingga 5.
satisfactions.feedback	String	Tidak	Masukan tertulis.
satisfactions.submitted_at	String	Tidak	Waktu pengiriman.
created_at	String	Ya	Waktu pembuatan tiket (ISO 8601).
updated_at	String	Ya	Waktu terakhir tiket diperbarui.
resolved_at	String	Tidak	Waktu penyelesaian (`null` jika belum diselesaikan).
closed_at	String	Tidak	Waktu penutupan (`null` jika belum ditutup).