Mengambil transkrip

GET/<guild_id>/api/transcripts/<ticket_id>

Mengambil seluruh transkrip tiket yang sudah ditutup berdasarkan nomor tiket: metadata lengkap (pembuat, panel, penilaian, alasan penutupan, penangan, waktu), setiap pesan menurut urutan waktu, dan angka pesan per peserta. Cari tiketnya dulu lewat **Mencari Transkrip**, atau ambil arsip jadinya lewat **Mengambil HTML Transkrip**. Butuh izin `view_transcripts` (bawaannya mati).

Parameter kueri

Nama	Jenis	Wajib	Keterangan
limit	number	opsional	Jumlah pesan per halaman, 1-1000 (bawaan 500).
offset	number	opsional	Jumlah pesan yang dilewati untuk penomoran halaman (bawaan 0).

Isi messages dan participants berasal dari indeks transkrip, yang dibangun selama server punya Premium dan diisikan ke arsip lama Anda saat pertama kali berlangganan. Tiket yang ditutup sebelum berlangganan (atau ketika pengisian indeksnya masih berjalan) kembali dengan indexed: false dan larik messages kosong. Untuk yang seperti itu, pakai Mengambil HTML Transkrip atau transcript.TranscriptUrl. Gunakan objek pagination untuk menelusuri tiket yang panjang.

Contoh permintaan

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"

Contoh respons

{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "ClosedBy": "987654321",
    "ClaimedIds": ["987654321"],
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "indexed": true,
  "messages": [
    { "MessageId": "111", "AuthorId": "123456789", "AuthorUsername": "jane", "IsBot": false, "Content": "My login is broken", "CreatedAt": 1732200050 },
    { "MessageId": "112", "AuthorId": "987654321", "AuthorUsername": "staff", "IsBot": false, "Content": "Looking into it now!", "CreatedAt": 1732200110 }
  ],
  "participants": [
    { "UserId": "123456789", "Username": "jane", "IsBot": false, "MessageCount": 12, "FirstMessageAt": 1732200050, "LastMessageAt": 1732209900 }
  ],
  "pagination": { "total": 2, "limit": 500, "offset": 0, "returned": 2 }
}