Dokumentasi

Kuasai TicketsX lebih cepat

Panduan pemasangan, daftar lengkap perintah, fitur Premium, dan REST API dalam satu tempat.

13.15

Mengganti panel tiket

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

Memindahkan tiket ke panel tunggal lain. Ini padanan perintah /switchpanel lewat API. Tiketnya dinamai ulang mengikuti pola nama panel baru, dipindahkan ke kategorinya (untuk tiket berbentuk kanal), dan tim dukungan panel baru mendapat akses. Butuh izin `switch_panel` (bawaannya mati).

Isi permintaan

NamaJenisWajibKeterangan
panel_idnumber
wajib
ID panel tunggal tujuan perpindahan tiket (lihat Daftar Panel).
keep_permissionsboolean
opsional
Mempertahankan izin peran yang sekarang ada di kanal selain tim panel baru (bawaan true). Isi false untuk menyisakan akses hanya bagi tim dukungan panel baru.

Bentuk tiketnya harus sama: tiket berbentuk kanal hanya bisa pindah ke panel berbasis kanal, dan tiket berbentuk utas hanya ke panel berbasis utas. Karena perpindahan ini mengganti nama kanal, Discord membatasinya sekitar dua kali tiap 10 menit; endpoint ini memakai batas yang sama dan mengembalikan 429 beserta retry_after ketika batas itu terlampaui.

Contoh permintaan
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel
Contoh respons
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}