> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pannelli candidature

> Recluta staff ed elabora richieste di ruolo con form di domande, gate di eleggibilità, voto dei reviewer e azioni automatizzate.

Un membro clicca un pulsante, risponde alle tue domande, e lo staff accetta o rifiuta. All'accettazione Vetox può assegnare ruoli, inviare DM, rinominarli, aprire un canale di intervista e altro.

## Limiti

|                              | Starter | Basic | Max | Black |
| ---------------------------- | ------- | ----- | --- | ----- |
| Pannelli                     | 1       | 3     | 10  | 10    |
| Domande per form             | 5       | 15    | 50  | 50    |
| Azioni per stage             | 1       | 3     | 10  | 10    |
| Form (pulsanti) per pannello | 1       | 3     | 5   | 10    |

<Warning>
  **Il downgrade elimina permanentemente le domande oltre il nuovo limite.** Questo è l'unico posto in Vetox dove un downgrade distrugge dati piuttosto che disabilitarli.

  Passare da Max (50 domande) a Basic (15) rimuove le domande dalla 16 in poi definitivamente. Fare di nuovo l'upgrade non le riporta indietro.

  **Esporta o copia le tue domande prima di fare il downgrade.**
</Warning>

Tutto il resto in un downgrade viene disabilitato piuttosto che eliminato, e torna all'upgrade.

## Due flussi di invio

<CardGroup cols={2}>
  <Card title="Dialog Button" icon="window-maximize">
    Un pop-up form di Discord. Gratuito in ogni tier. **Massimo 5 domande.**
  </Card>

  <Card title="Private Message" icon="envelope">
    Vetox invia un DM al richiedente e fa domande una alla volta. Supporta il limite completo delle domande.
  </Card>
</CardGroup>

<Warning>
  **Un form dialog con 6 o più domande in cui qualsiasi domanda oltre la quinta è obbligatoria non può mai essere inviato.**

  I pop-up Discord contengono 5 campi. Le domande oltre non vengono mostrate, ma una obbligatoria viene comunque controllata — quindi al richiedente viene detto che una risposta obbligatoria manca, senza modo di fornirla. Nulla ti avvisa quando salvi questo.

  Se hai bisogno di più di 5 domande, usa il flusso **Private Message**.
</Warning>

### Cosa il flusso DM non può fare

Il flusso DM fa domande come messaggi di chat, quindi i tipi di domanda più ricchi si degradano:

| Tipo di domanda        | Dialog Button | Private Message                  |
| ---------------------- | ------------- | -------------------------------- |
| Testo breve, Paragrafo | Nativo        | Nativo                           |
| Dropdown               | Nativo        | Picker nativo                    |
| **User picker**        | Nativo        | **Testo digitato, non validato** |
| **Role picker**        | Nativo        | **Testo digitato, non validato** |
| **Channel picker**     | Nativo        | **Testo digitato, non validato** |
| **User/Role picker**   | Nativo        | **Testo digitato, non validato** |
| **File upload**        | Nativo        | **Solo nomi file**               |

<Warning>
  Nel flusso DM, i quattro tipi picker accettano **qualsiasi testo** senza validazione. Un richiedente può digitare qualsiasi cosa e viene memorizzata come sua risposta. Non fare affidamento su una risposta picker che sia un utente, ruolo o canale reale in un form DM.
</Warning>

## Domande

Otto tipi. Le domande di testo prendono un intervallo di 0–4.000 caratteri; i dropdown prendono fino a 25 scelte; i file upload prendono fino a 10 file.

## Eleggibilità

Chi è ammesso a candidarsi:

| Gate                             | Cosa controlla                                                       |
| -------------------------------- | -------------------------------------------------------------------- |
| **Età minima dell'account**      | Quanto è vecchio il loro account Discord                             |
| **Membership minima del server** | Da quanto tempo sono nel tuo server                                  |
| **Ruoli richiesti**              | Devono avere **uno qualsiasi** o **tutti** di questi                 |
| **Ruoli bloccati**               | Non possono avere **uno qualsiasi** o **tutti** di questi            |
| **Verifica multi-server**        | Devono essere membri di altri server nominati (**Max**)              |
| **Cooldown**                     | 0–1.440 minuti tra le application                                    |
| **Max in sospeso**               | 1–5 application aperte per persona                                   |
| **DM raggiungibile**             | I loro DM devono essere aperti (attivo per impostazione predefinita) |

<Info>
  Ruoli richiesti e bloccati, e auto-deny, richiedono **Basic**. La verifica multi-server richiede **Max**.
</Info>

<Warning>
  **Non c'è un gate "già accettato".** Una volta che qualcuno è accettato può candidarsi di nuovo non appena il cooldown scade. Se non vuoi candidature ripetute, imposta un cooldown lungo o aggiungi il ruolo accettato ai **Ruoli bloccati**.
</Warning>

## Azioni workflow

Cosa succede all'invio, all'accettazione o al rifiuto.

| Azione                                  | Tier     |
| --------------------------------------- | -------- |
| Aggiungi ruoli, Rimuovi ruoli           | Gratuito |
| Invia embed, Invia DM, Ping ruoli       | Gratuito |
| Modifica nickname, Imposta tag di forum | Gratuito |
| Kick, Ban, Timeout membro               | Basic    |
| Modifica nome thread                    | Basic    |
| Crea canale di intervista               | Basic    |
| Auto-assegna ruolo di probation         | Max      |
| Ritarda un'azione / concatena azioni    | Max      |
| **Esegui comando**                      | Max      |

<Warning>
  **Execute command non fa nulla.** Si salva, è vincolato dietro Max, e il bot lo registra e prosegue senza eseguire il comando. L'editor lo etichetta di conseguenza, ma è comunque presentato come una capacità a pagamento.

  Non costruire un workflow che dipenda da esso.
</Warning>

### Variabili nei messaggi delle azioni

<Warning>
  Le variabili membro e server — `{username}`, `{user.displayName}`, `{nickname}`, `{guildname}`, `{server.name}`, `{server.memberCount}` — **si risolvono in nulla all'interno dei template delle azioni workflow.**

  Un template come `[{answer1}] {username}` renderizza come `[la loro risposta]` con uno spazio finale. Usa variabili di risposta e testo statico nelle azioni workflow; metti i dettagli membro nei messaggi DM invece, dove funzionano.
</Warning>

## Revisione dello staff

Le application vengono pubblicate in un canale di revisione dove i reviewer accettano o rifiutano.

| Opzione                           | Note                                                                 |
| --------------------------------- | -------------------------------------------------------------------- |
| **Canale di revisione**           | Testo, annuncio o forum                                              |
| **Ruoli reviewer**                | Fino a 10                                                            |
| **Aggiungi thread al submission** | Un thread per application (**Basic**)                                |
| **Voto**                          | Richiedi N approvazioni o rifiuti prima di una decisione (**Basic**) |
| **Auto-deny**                     | Rifiuta dopo 1–720 ore in sospeso (**Basic**)                        |

<Note>
  L'opzione **private thread** per i thread di revisione non ha effetto — i thread di revisione sono sempre pubblici a chiunque possa vedere il canale di revisione. Limita il canale stesso invece.
</Note>

<Note>
  Un reviewer non può rivedere la propria application.
</Note>

## Permessi di cui Vetox ha bisogno

| Azione                        | Permesso                                                  |
| ----------------------------- | --------------------------------------------------------- |
| Aggiungi o rimuovi ruoli      | **Manage Roles**, e il ruolo deve essere **sotto** Vetox  |
| Modifica nickname             | **Manage Nicknames**, e il membro deve essere sotto Vetox |
| Kick / Ban / Timeout          | Il permesso corrispondente, e il membro sotto Vetox       |
| Pubblica l'embed di revisione | **View Channel**, **Send Messages**, **Embed Links**      |
| Thread di revisione           | **Manage Threads**                                        |
| Canali di intervista          | **Manage Channels**                                       |

<Warning>
  **Se Vetox non può pubblicare nel canale di revisione, al richiedente viene comunque detto che la sua application è stata inviata** — mentre lo staff non la vede mai. Verifica che il bot possa pubblicare nel canale di revisione prima di andare live.
</Warning>

La maggior parte degli altri fallimenti vengono riportati nel canale di revisione così lo staff può vedere cosa è andato storto.

## Configurarne uno

<Steps>
  <Step title="Attiva Applications in Server Setup" />

  <Step title="Parti da un template">
    Sei sono forniti — Staff Application, Game Member, Role Request, Event Signup, Partner Inquiry, Verification — o parti in bianco.
  </Step>

  <Step title="Scegli il flusso">
    Cinque domande o meno, Dialog Button va bene. Più di cinque, usa Private Message.
  </Step>

  <Step title="Imposta il canale di revisione e i ruoli reviewer">
    Conferma che Vetox può pubblicare lì.
  </Step>

  <Step title="Aggiungi azioni di accettazione">
    Tipicamente: aggiungi il ruolo, invia un DM di benvenuto. Controlla che il ruolo sia sotto Vetox.
  </Step>

  <Step title="Imposta l'eleggibilità">
    Un'età minima dell'account blocca gli account usa-e-getta a quasi nessun costo per i richiedenti genuini.
  </Step>

  <Step title="Invia il pannello e testalo tu stesso">
    Invia una vera application e portala fino all'accettazione prima di annunciarla.
  </Step>
</Steps>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="I richiedenti ottengono un errore di risposta obbligatoria mancante che non possono risolvere">
    Un form dialog con più di 5 domande in cui una successiva è obbligatoria. Passa al flusso Private Message, o rendi facoltative le domande 6+.
  </Accordion>

  <Accordion title="Le application vengono inviate ma lo staff non le vede mai">
    Vetox non può pubblicare nel canale di revisione. Al richiedente viene detto che ha funzionato comunque.
  </Accordion>

  <Accordion title="Il ruolo non viene assegnato all'accettazione">
    Manage Roles, e il ruolo deve essere sotto Vetox nella lista dei ruoli.
  </Accordion>

  <Accordion title="Qualcuno che era già stato accettato si è candidato di nuovo">
    Previsto — non c'è gate per questo. Aggiungi il ruolo accettato ai Ruoli bloccati.
  </Accordion>

  <Accordion title="Le mie variabili sono renderizzate in bianco in un'azione di accettazione">
    Le variabili membro e server non si risolvono nelle azioni workflow. Sposta quel testo nel DM di accettazione.
  </Accordion>

  <Accordion title="Le domande sono sparite dopo che ho cambiato piano">
    Un downgrade tronca le domande oltre il nuovo limite e non possono essere recuperate.
  </Accordion>

  <Accordion title="Il pulsante non fa nulla quando cliccato">
    Solitamente un pannello che è stato modificato o ricreato dopo che il messaggio è stato inviato. Invia di nuovo il pannello.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Invii" icon="inbox" href="/it/utility/applications/submissions">
    Rivedi, filtra ed esporta le application.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/it/utility/applications/analytics">
    Tassi di accettazione e dove i richiedenti abbandonano.
  </Card>
</CardGroup>