Documentação

Aprenda o TicketsX mais rápido

Guias de configuração, a referência completa dos comandos, os recursos Premium e a API REST num só lugar.

13.15

Trocar o painel de um ticket

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

Move um ticket para outro painel simples. É o equivalente por API do comando /switchpanel. O ticket é renomeado conforme o padrão do novo painel, movido para a categoria dele (tickets em canal), e as equipes de suporte do novo painel ganham acesso. Exige a permissão `switch_panel` (desativada por padrão).

Corpo da requisição

NomeTipoObrigatórioDescrição
panel_idnumber
obrigatório
ID do painel simples para o qual o ticket será trocado (veja Listar painéis).
keep_permissionsboolean
opcional
Mantém as permissões de cargo atuais do canal além das equipes do novo painel (true por padrão). Use false para deixar o acesso só com as equipes de suporte do novo painel.

Os modos de ticket precisam combinar: tickets em canal só trocam para painéis de canal, e tickets em tópico para painéis de tópico. Como a troca renomeia o canal, o Discord limita isso a cerca de duas vezes a cada 10 minutos; este endpoint segue o mesmo limite e retorna 429 com retry_after quando é ultrapassado.

Exemplo de requisição
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
Exemplo de resposta
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}