# Configura la prima categoria di ticket

> In TicketCord una “categoria” è una categoria di canali Discord, l'intestazione comprimibile nella sidebar. Via rapida: /setup. Sotto trovi quella manuale.

## Cosa significa “categoria” in TicketCord

Usiamo le categorie di canali integrate di Discord: non c'è un concetto separato da imparare. Ogni nuovo ticket diventa un canale di testo dentro la categoria che scegli, e il bot gestisce i permessi per canale, così solo il richiedente e lo staff possono vederlo.

## La via rapida: `/setup`

Invece di creare tutto a mano, esegui `/setup` nel tuo server. Il comando è riservato agli utenti con il permesso Discord **Amministratore** e configura il lato Discord in un colpo solo:

- Crea una categoria **Tickets** per i ticket aperti e una categoria **Closed Tickets**.
- Crea due ruoli staff: un ruolo **Ticket Admin** con permessi completi sui ticket e un ruolo **Ticket Support** con accesso in lettura e risposta. (Sul piano gratuito si chiamano **TicketCord Admin** / **TicketCord Support**.)
- Applica le sovrascritture dei permessi: i due ruoli staff possono vedere e agire nei ticket, `@everyone` è negato.
- Riordina i nuovi ruoli appena sotto il ruolo del bot, così la gerarchia dei ruoli di Discord permette al bot di gestirli.

Perché il comando funzioni, al bot serve Amministratore oppure **Gestire i canali** + **Gestire i ruoli** a livello di server (l'invito li richiede di default). Se il tuo server ha il requisito 2FA di Discord attivo per le azioni di moderazione, anche l'account che ha creato il bot nel Discord Developer Portal deve avere la 2FA attiva: è una regola di Discord, non nostra.

## Se hai già categorie o ruoli in stile ticket

Prima di creare qualcosa, `/setup` scansiona il tuo server alla ricerca di categorie e ruoli esistenti i cui nomi somigliano a una configurazione ticket precedente (es. “Tickets”, “Closed Tickets”, “Ticket Admin”, “Ticket Support”). Se ne trova, ti vengono mostrati tre pulsanti:

- **Usa esistenti** - lascia intatte le risorse attuali; sarà tuo compito puntarci la dashboard.
- **Crea comunque** - creane di nuove con nomi leggermente diversi, così non collidono.
- **Annulla** - esci senza cambiare nulla.

## Devi comunque completare la configurazione sul sito

Questa è la parte che sfugge a molti. `/setup` crea solo l'infrastruttura lato Discord. Non dice a TicketCord quali categorie o ruoli usare: quello avviene nella dashboard. Dopo aver eseguito il comando, torna in **Configurazione** e seleziona le nuove risorse nella procedura guidata. Senza questo passaggio, i ticket continueranno a non aprirsi.

## Oppure: crea le categorie da solo

1. Nel tuo server, crea una categoria chiamata ad esempio **Ticket aperti**.
2. Facoltativamente creane una seconda chiamata **Ticket chiusi**: TicketCord può spostarci i canali risolti invece di eliminarli, utile per la cronologia di audit.
3. Imposta entrambe le categorie come *private* di default: nei permessi della categoria, nega **Visualizza canale** per `@everyone` e concedilo al tuo ruolo staff e al bot TicketCord.

## Fai puntare TicketCord alle categorie

Apri la procedura guidata nella dashboard, oppure vai in **Configurazione > Canali**. Scegli la categoria dei ticket aperti: puoi sceglierne più di una se vuoi che i ticket si distribuiscano man mano che si riempiono (Discord limita ogni categoria a 50 canali). Se hai creato una categoria per i chiusi, impostala come destinazione dei ticket chiusi.

Entrambe le impostazioni accettano una lista, quindi puoi aggiungere altre categorie in seguito senza sostituire quelle già scelte.

## Cosa fa il bot con i permessi

Quando un cliente apre un ticket, TicketCord crea un nuovo canale di testo dentro la categoria degli aperti e aggiunge tre sovrascritture di permessi: nega a `@everyone` Visualizza canale, concede al richiedente Visualizza + Invia + Cronologia messaggi, e concede lo stesso ai tuoi ruoli staff. I permessi a livello di categoria restano intatti.

## Prossimo passo

Ora che i ticket hanno un posto dove atterrare, sei pronto a [creare un pannello ticket](https://ticketcord.com/it/help/getting-started/ticket-panel), così i clienti hanno un pulsante da cliccare.

## Risorse leggibili dalla macchina

- [HTML canonico](https://ticketcord.com/it/help/getting-started/first-category)
- [TicketCord llms.txt](https://ticketcord.com/llms.txt)
- [AI indice delle pagine](https://ticketcord.com/api/ai/pages)
