Documentazione

Impara TicketsX più in fretta

Guide di configurazione, riferimento completo dei comandi, funzioni Premium e API REST in un unico posto.

13.15

Cambiare il pannello di un ticket

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

Sposta un ticket su un altro pannello singolo. È l'equivalente via API del comando /switchpanel. Il ticket viene rinominato secondo lo schema del nuovo pannello, spostato nella sua categoria (per i ticket su canale) e i team di staff del nuovo pannello ricevono l'accesso. Richiede il permesso `switch_panel` (disattivato per impostazione predefinita).

Corpo della richiesta

NomeTipoObbligatorioDescrizione
panel_idnumber
obbligatorio
ID del pannello singolo su cui spostare il ticket (vedi Elencare i pannelli).
keep_permissionsboolean
facoltativo
Mantiene sul canale i permessi dei ruoli attuali oltre ai team del nuovo pannello (predefinito true). Imposta false per lasciare l'accesso ai soli team di staff del nuovo pannello.

Le modalità dei ticket devono coincidere: i ticket su canale si possono spostare solo su pannelli basati su canali e i ticket in thread solo su pannelli basati su thread. Dato che il cambio rinomina il canale, Discord lo limita a circa due volte ogni 10 minuti; questo endpoint applica lo stesso limite e risponde 429 con retry_after quando viene superato.

Esempio di richiesta
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
Esempio di risposta
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}