> For the complete documentation index, see [llms.txt](https://ticketking.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ticketking.xyz/docs/it/comandi-personalizzati/creating-a-command.md).
# Creazione di un comando personalizzato
:crown: **funzionalità Premium.** Nel pannello di controllo, apri **Comandi personalizzati**, poi **+ Nuovo comando** per aprire il creatore.
Il creatore ha due pannelli. Il **pannello sinistro** è dove costruisci la risposta (il contenuto del messaggio, gli embed e i pulsanti). Il **pannello destro** contiene le impostazioni del comando (nome, trigger, opzioni e permessi).
## Pannello sinistro, la risposta
Il pannello sinistro è dove costruisci ciò che il comando invia. Ci sono tre schede.
### Scheda Contenuto testuale
Un editor multi-linea per la risposta del bot.
* Limite: 2000 caratteri. Viene mostrato un contatore, che diventa rosso mentre ti avvicini al limite.
* Supporta il markdown di Discord.
* Ha un selettore emoji in linea.
* Quando il comando è **Solo ticket**, i segnaposto dei ticket funzionano qui (vedi la sezione Segnaposto sotto).
Testo di aiuto: *"Il contenuto è facoltativo se viene fornito almeno un embed."*
### Scheda Embed
Fino a 10 embed. Apri l' **Designer degli embed** per modificare ciascuno. È lo stesso designer usato altrove nel pannello di controllo.
* Per ogni embed: titolo (256), descrizione (4096), piè di pagina (2048), autore (256), un colore, un'immagine, una miniatura e fino a 25 campi (nome campo 256, valore campo 1024).
* In tutti gli embed di un solo comando: fino a 6000 caratteri totali.
Quando **Solo ticket** è attivo, anche i campi di testo dell'embed supportano i segnaposto dei ticket.
Un pulsante "Elimina tutto" rimuove tutti gli embed in una volta sola, con un passaggio di conferma.
### Scheda Anteprima risposta
Un'anteprima in tempo reale di come apparirà la risposta in Discord, così puoi controllare la formattazione prima di salvare.
### Pulsanti link
All'interno degli embed puoi aggiungere **pulsanti link**. Questi sono solo pulsanti link.
* Fino a 5 righe con fino a 5 pulsanti ciascuna.
* Ogni pulsante richiede un'etichetta (fino a 80 caratteri) e un URL che inizi con http\:// o https\:// (fino a 512 caratteri). Un pulsante può usare solo un'emoji senza etichetta.
Sono utili per modelli come "Ecco la nostra politica di rimborso" con un pulsante che apre la pagina.
## Pannello destro, le impostazioni
### Nome comando
Una casella di testo che assegna un nome al comando nel tuo pannello di controllo. **Gli utenti non lo vedono.**
* Segnaposto: `Ticket sbagliato`
* Testo di aiuto: *"Usato solo per identificare questo comando nel tuo pannello di controllo. Gli utenti non lo vedranno."*
* Obbligatorio.
* Viene automaticamente convertito in minuscolo.
* Deve essere univoco nel tuo server.
### Trigger del comando
Il testo che gli utenti digitano per attivare il comando.
* Segnaposto: `!wrongticket`
* Testo di aiuto: *"Il testo che gli utenti digiteranno per attivare questo comando."*
* Obbligatorio.
* Viene automaticamente convertito in minuscolo.
* Deve essere univoco nel tuo server.
Non devi usare un `!` prefisso. Va bene qualsiasi testo. Scegli uno stile e usalo in tutti i tuoi comandi così il tuo staff potrà ricordarseli.
### Opzioni
| Campo | Tipo | Predefinito | Comportamento |
| ------------------------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Comando abilitato** | attiva/disattiva | Attivo | Quando è disattivato, digitare il trigger non fa nulla. |
| **Solo ticket** | attiva/disattiva | Disattivato | Quando è attivo, il comando si attiva solo all'interno dei canali ticket, e i segnaposto dei ticket funzionano nella risposta. |
| **Elimina messaggio del comando** | attiva/disattiva | Disattivato | Quando è attivo, il bot elimina il messaggio trigger dell'utente dopo aver risposto. |
| **Rispondi al messaggio del comando** | attiva/disattiva | Attivo | Quando è attivo, la risposta del bot è una risposta al messaggio dell'utente. Questa opzione è nascosta quando Elimina messaggio comando è attivo. |
### Permessi
| Campo | Tipo | Comportamento |
| ----------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------- |
| **Consenti a tutto lo staff** | attiva/disattiva | Quando è attivo, chiunque abbia un ruolo di supporto a livello del server può usare il comando. |
| **Ruoli** (mostrato quando Consenti tutto lo staff è disattivato) | selettore di ruolo | I ruoli specifici autorizzati a usare questo comando. |
## Convalida
Il pulsante Salva resta disabilitato finché il comando non è valido. Messaggi comuni:
* *"Il nome del comando è obbligatorio"*
* *"Il trigger del comando è obbligatorio"*
* *"Il comando deve avere contenuto o almeno un embed"*
* *"Il nome del comando esiste già"*
* *"Il trigger del comando esiste già"*
## Segnaposto (modalità Solo ticket)
Quando **Solo ticket** è attivo, questi segnaposto vengono compilati quando il comando si attiva:
| Segnaposto | Compilato con |
| ----------------- | ------------------------------------------- |
| `{USER}` | Un riferimento all'autore del ticket |
| `{TICKET_NUMBER}` | Il numero del ticket |
| `{TYPE}` | L'etichetta dell'opzione del pannello |
| `{USER_ID}` | L'ID Discord dell'autore del ticket |
| `{USER_NAME}` | Il nome visualizzato dell'autore del ticket |
| `{GUILD_NAME}` | Il nome del tuo server |
| `{CREATED_AT}` | L'orario di creazione del ticket |
Un segnaposto senza valore viene mostrato come `N/D`. I comandi che non sono Solo ticket non supportano i segnaposto.
## Salvataggio
Fai clic **Salva**. Il comando è attivo immediatamente. Il registro di controllo registra che il comando è stato creato.
## Correlati
{% content-ref url="/pages/3a4fc53bba90bbc859c8767cb7362e4e0e3763be" %}
[Modifica ed eliminazione dei comandi](/docs/it/comandi-personalizzati/editing-and-deleting.md)
{% endcontent-ref %}
{% content-ref url="/pages/e8f3c29a5fc93ac10022b787dca40960b7992ede" %}
[Casi d'uso](/docs/it/comandi-personalizzati/use-cases.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ticketking.xyz/docs/it/comandi-personalizzati/creating-a-command.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.