> ## 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.

# Configurações Gerais de Tickets

> Configuração de tickets em nível de servidor — canais de log, limites, cargos de suporte, usuários bloqueados e alertas pessoais da staff.

Configurações aqui se aplicam a **todos** os painéis de ticket do servidor. Comportamento por painel fica em [Panels](/pt/utility/tickets/panels).

Quatro abas: **General**, **Limits**, **Access**, **Notifications**.

## General

### Numeração de tickets

| Configuração             | Padrão | Efeito                                                                                                   |
| ------------------------ | ------ | -------------------------------------------------------------------------------------------------------- |
| **Continuous numbering** | **On** | Números continuam contando para cima. Desligado, e os números reutilizam lacunas conforme tickets fecham |
| **Number padding**       | 0      | Zeros à esquerda, 0–6. Padding de 4 transforma `#7` em `#0007`                                           |

<Tip>
  Deixe a numeração contínua ligada. Números reutilizados tornam transcripts e trilhas de auditoria ambíguos — dois tickets diferentes podem acabar compartilhando `#12`.
</Tip>

### Padrões do embed de ticket

<Info>
  Requer **Basic**.
</Info>

Uma cor padrão e um footer padrão (texto mais ícone) aplicados aos embeds de ticket que não os sobrescrevem.

<Note>
  Se você define um ícone de footer mas deixa o texto do footer vazio, o ícone é descartado ao salvar. O texto é obrigatório para o ícone persistir.
</Note>

### Backup e restore

<Info>
  Requer **Basic**.
</Info>

**Export configuration** baixa toda a sua configuração de tickets. **Import configuration** a substitui.

<Warning>
  Import sobrescreve sua configuração atual. Pede confirmação primeiro, mas não há undo — exporte antes de importar.
</Warning>

### Zona de perigo

* **Reset All Ticket Settings** — retorna tudo desta página aos padrões
* **Revoke Transcript Links** — invalida todo link de transcript já emitido

<Warning>
  Revogar links de transcript é instantâneo e global. Todo link que você compartilhou com um membro ou arquivou em outro lugar para de funcionar.
</Warning>

## Limits

| Configuração                      | Starter | Basic e acima | Padrão |
| --------------------------------- | ------- | ------------- | ------ |
| **Max active tickets** (servidor) | 200     | Ilimitado     | 200    |
| **Max active tickets per user**   | **1**   | 5             | 1      |
| **Cooldown between tickets**      | 0       | 0             | 0      |
| **Max closed tickets per user**   | 3       | 100           | 0      |
| **Max closed tickets** (servidor) | 50      | 2.000         | 0      |
| **Limit bypass roles**            | até 10  | até 10        | nenhum |

<Note>
  Um valor de **0** nos limites de tickets fechados significa sem limite — tickets fechados são mantidos indefinidamente.
</Note>

<Warning>
  **No Starter, "max active tickets per user" é silenciosamente forçado a 1.** Você pode digitar 5, ele salvará, e o valor armazenado se torna 1 sem badge de premium e sem explicação. Este é o único limite na página sem indicação visual de que é bloqueado.
</Warning>

### Comportamento do cooldown

O cooldown é em segundos e é ajustado ao salvar:

* Qualquer coisa **abaixo de 10** vira **0** (sem cooldown)
* Qualquer coisa **acima de 3600** vira **3600** (uma hora)

Então um cooldown de 5 segundos não é um cooldown curto — é nenhum cooldown.

### Bypass roles

<Warning>
  Bypass roles pulam **todos** os limites nesta aba de uma vez — o cap por usuário, o cap do servidor, o cooldown e ambos os caps de tickets fechados.

  Não há como pular apenas um. Conceda apenas à staff.
</Warning>

## Access

* **Support roles** — staff em nível de servidor. Painéis podem adicionar os seus por cima
* **Blocked roles** — membros com um deles não podem abrir um ticket
* **Blocked users** — membros individuais, com expiração e razão opcionais

<Info>
  Usuários bloqueados: **100** no Starter, **500** no Basic e acima.
</Info>

Blocks podem ser permanentes ou expirar após 1 hora, 1 dia, 7 dias ou 30 dias. A razão é armazenada para sua própria referência, até 500 caracteres.

## Notifications

Sete canais de log independentes, todos desligados por padrão:

| Canal          | Loga                  |
| -------------- | --------------------- |
| **Opened**     | Novos tickets         |
| **Closed**     | Fechamentos           |
| **Reopened**   | Reaberturas           |
| **Renamed**    | Renomeações de canal  |
| **Deleted**    | Exclusões             |
| **Transcript** | Transcripts gerados   |
| **Rating**     | Avaliações de membros |

### My alerts

Preferências pessoais de DM por membro da staff, todas desligadas por padrão: ticket aberto, escalado, fechado, avaliado e SLA breach.

<Note>
  Essas são **suas** preferências, não em nível de servidor. Cada membro da staff define as suas.
</Note>

## Permissões que o Vetox precisa

| Permissão                                            | Por quê                                         |
| ---------------------------------------------------- | ----------------------------------------------- |
| **Manage Channels**                                  | Para criar, renomear e deletar canais de ticket |
| **Manage Roles**                                     | Para aplicar overwrites de permissão por ticket |
| **View Channel**, **Send Messages**, **Embed Links** | Para postar painéis e mensagens de ticket       |
| **Read Message History**                             | Para construir transcripts                      |
| **Manage Threads**, **Create Private Threads**       | Apenas painéis em modo thread                   |

<Warning>
  **A hierarquia de cargos não é verificada em nenhum lugar do sistema de tickets.** Se um cargo de suporte estiver **acima** do cargo do Vetox, mudanças de permissão envolvendo-o falham silenciosamente — sem erro no canal, sem entrada nos seus logs, e o ticket parece funcionar.

  Arraste o cargo do Vetox acima de todos os cargos de suporte. Essa é a causa mais comum de "a staff não consegue ver o ticket".
</Warning>

<Note>
  Sem **Read Message History**, tickets ainda fecham com sucesso mas o transcript fica vazio.
</Note>

## Transcripts

Limitados a **5.000 mensagens**, **2.000 caracteres** por mensagem, e **10 MB** por transcript. Tickets mais longos são truncados.

## O que muda no downgrade

<Note>
  **Nenhum dado de ticket é apagado.** Valores acima do limite são clamped, recursos bloqueados são desligados, e tudo volta quando você faz upgrade.

  Especificamente: caps de servidor e de tickets fechados são reduzidos ao teto gratuito, linked panels e targets de escalation esvaziam, formulários desanexam, prioridade reseta para nenhuma, e períodos de horário de suporte são todos forçados como abertos.
</Note>

## Solução de problemas

<AccordionGroup>
  <Accordion title="A staff não consegue ver ou agir em tickets">
    Quase sempre hierarquia de cargos — mova o cargo do Vetox acima dos seus cargos de suporte. Nada te alertará sobre isso.
  </Accordion>

  <Accordion title="Um membro não consegue abrir um segundo ticket">
    No Starter o limite por usuário é 1 e não pode ser aumentado. No Basic e acima, defina até 5.
  </Accordion>

  <Accordion title="O cooldown que defini está sendo ignorado">
    Valores abaixo de 10 segundos são armazenados como 0. Use 10 ou mais.
  </Accordion>

  <Accordion title="Um canal de ticket existe mas seus botões não fazem nada">
    Uma falha rara durante a criação pode deixar um canal sem seu estado armazenado. Delete-o manualmente e peça ao membro para abrir um novo.
  </Accordion>

  <Accordion title="O transcript está vazio">
    Falta ao Vetox **Read Message History** no canal do ticket.
  </Accordion>

  <Accordion title="Defini uma opção de auto-close-on-leave e ela nunca dispara">
    Esse toggle atualmente não tem efeito. Feche tickets manualmente quando um membro sair.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Panels" icon="ticket" href="/pt/utility/tickets/panels">
    Perguntas, botões e roteamento por painel.
  </Card>

  <Card title="Visão geral de Tickets" icon="circle-info" href="/pt/utility/tickets/overview">
    Como o sistema funciona de ponta a ponta.
  </Card>
</CardGroup>