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

# Tickets

> Os membros abrem um ticket de suporte privado por um painel de botões ou um menu, a equipe assume e fecha, e cada ticket pode guardar uma transcrição completa.

## Visão geral

Os tickets organizam os pedidos de suporte por meio de um painel, em vez de uma enxurrada de DMs. Tudo abaixo exige a permissão **Gerenciar servidor**, a menos que seja uma ação de ticket que qualquer membro pode usar.

O dashboard tem o mesmo em **Comunidade → Tickets**: painéis com prévia ao vivo, tipos de suporte, formulários de ticket, acesso, configurações, respostas rápidas e os tickets abertos.

![A página Painéis de tickets com os passos de configuração feitos e um painel com os botões Suporte, Denunciar um membro e Parceria](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/tickets.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=0b845e18367683ecc9131acd140821d6)

Dashboard → Comunidade → Tickets: os passos de configuração e um painel com a prévia no Discord.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

![liam digita !ticketconfig e o Petto responde com o card de configuração dos tickets: modo de assumir, fechamento, avaliações, canais de log, limites e horário da equipe, e depois todos os comandos de tickets](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-ticketconfig.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=8d0101c2417e66498031008357d06f82)

No Discord: !ticketconfig com as configurações dos tickets e os comandos para mudá-las.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

`!ticketconfig` mostra em um card o que o servidor configurou para os tickets e todos os comandos de tickets.

## Configuração guiada

`!ticket setup` abre um painel com menus e botões que configura tudo em um só lugar: escolha o canal do painel de tickets, os cargos de suporte e um canal de logs, escreva o título e o texto, adicione os tipos de ticket (nome, emoji e uma descrição curta), escolha a cor dos botões e se os membros veem botões ou um menu suspenso, e publique tudo com um clique. Se o painel não puder ser publicado, nada é guardado. Depois, cada tipo pode ser ajustado no dashboard ou com `!ticket category edit`.

**1. Use !ticket setup**

O Petto responde com o painel de configuração. Nada é publicado até você apertar **Publicar**, e o canal do painel começa como o canal onde você digitou.

![liam digita !ticket setup e o Petto responde com o painel de configuração: o canal do painel, os cargos de suporte e o canal de log, um tipo Suporte de exemplo, três menus e os botões Título e texto, Adicionar tipo, Cor, Usar menu suspenso, Publicar e Cancelar](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-start.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=3d21f7d580b3182059aa16dcc6bfd5d5)

No Discord: o painel do !ticket setup ao abrir.

**2. Escolha os canais e os cargos**

Use os três menus: onde publicar o painel, os cargos de suporte que respondem os tickets e um canal de log opcional para os tickets abertos e fechados. Cada linha ganha um check quando está pronta.

![O painel de configuração com #abrir-ticket como canal do painel, Ajudantes e Moderadores como cargos de suporte e #registro-tickets como canal de log, cada um com um check](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-menus.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=75ba65d42846a26349f67ed5f56dabbb)

No Discord: o canal do painel, dois cargos de suporte e o canal de log já estão escolhidos.

**3. Escreva o título e o texto**

**Título e texto** abre um formulário com o título e o texto do painel.

![O formulário Título e texto do painel com Precisa de ajuda? como título e o texto que fica acima dos botões](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-text.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=2dd5c541c4fd3ab6296408689cfdb8dd)

No Discord: o formulário de Título e texto.

**4. Adicione os tipos de ticket**

**Adicionar tipo** pede o nome do botão, um emoji, uma descrição curta para o menu suspenso e, se quiser, o texto de boas-vindas desse tipo.

![O formulário Adicionar um tipo de ticket com Denunciar um membro como nome, o emoji de sirene, uma descrição curta e um texto de boas-vindas com \{user}](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-type.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=922ffa289999d252c7ddf2ac3f48eb5b)

No Discord: o formulário de Adicionar tipo.

**5. Escolha a aparência**

**Cor** muda a cor dos botões cada vez que você aperta, e **Usar menu suspenso** troca para um menu (até 25 tipos em vez de 5). O painel mostra o que os membros vão ver.

![O painel de configuração com o título Precisa de ajuda?, os tipos Suporte, Denunciar um membro e Parceria com pontos verdes, e a linha com o texto de boas-vindas próprio, botões verdes e 3/5 tipos](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-types.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=c625b16cf1891fefcc6f1f5c09040d57)

No Discord: três tipos, botões verdes e o texto de boas-vindas de um tipo.

**6. Publique**

**Publicar** publica o painel e cria os tipos. Sem canal do painel ou sem um cargo de suporte, o Petto diz o que falta e nada é publicado.

![O Petto responde que o sistema de tickets está pronto, com o painel em #abrir-ticket e 3 tipos de ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-ready.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=dfaea27be33631a672508f2e8b837776)

No Discord: o painel de configuração vira a mensagem de pronto.

![O painel em #abrir-ticket: Precisa de ajuda?, o texto e os botões verdes Suporte, Denunciar um membro e Parceria](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-panel.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=1658dc34512a11cb18688ff4030e46d8)

No Discord: o painel que a configuração publicou.

![Abaixo do painel de configuração o Petto responde, só para liam, que primeiro escolha pelo menos um cargo de suporte](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-setup-missing.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=dfb40cd69a0670200724605699050f8c)

No Discord: Publicar ainda sem um cargo de suporte.

## Painéis

A mensagem em que os membros clicam para abrir um ticket.

```javascript Sintaxe theme={null}
!ticket panel create <channel> [title] [description] [embed_template] [style] [color] [image] [footer]
!ticket panel edit <panel_id> [title] [description] [color] [image] [footer] [placeholder] [style]
!ticket panel delete <panel_id>
!ticket panel resend <panel_id>
!ticket panel list
!ticket stats
```

```javascript Exemplo theme={null}
!ticket panel create #suporte "Precisa de ajuda?" "Clique em um botão abaixo" --style button --color a5ea7a
!ticket panel edit 1 --footer "Um ticket por assunto" --image https://example.com/banner.png
```

```text Resultado theme={null}
✅ Painel #1 publicado em #suporte. Adicione categorias com !ticket category add panel_id:1.
```

> [accordion] !ticket panel create
>
> ![kira digita !ticket panel create em #abrir-ticket com um título, um texto, o estilo de botões e a cor; o Petto publica o card e responde que o painel 1 foi publicado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-create.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=38b32805170206e47abd65827f2829e8)
>
> No Discord: um painel publicado com um comando, antes de ter tipos.

> [accordion] !ticket panel edit
>
> ![O painel de #abrir-ticket agora azul e com uma linha pequena embaixo; kira digitou !ticket panel edit 1 com um rodapé e uma cor e o Petto responde que o painel 1 mudou e a mensagem foi atualizada](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-edit.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=b4526e3d0900cf9c7094a1c6144b1564)
>
> No Discord: o painel muda no lugar.

> [accordion] !ticket panel delete
>
> ![kira digita !ticket panel delete 2 e o Petto responde que o painel 2 foi apagado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-delete.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=1c9b76dede060677399d2d80a118f02a)
>
> No Discord: um painel apagado.

> [accordion] !ticket panel resend
>
> ![kira digita !ticket panel resend 1 e o Petto responde que o painel 1 foi reenviado em #abrir-ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-resend.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=59a0e09924f3c21630093c9f7812dd4f)
>
> No Discord: um painel publicado de novo.

> [accordion] !ticket panel list
>
> ![kira digita !ticket panel list: o painel 1 em #abrir-ticket com botões e 3 categorias, o painel 2 em #inscricoes como menu sem nenhuma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=5e336910148c5c6628104d0c8fd62641)
>
> No Discord: os painéis do servidor.

`style` é `button` (no máximo 5 categorias) ou `select` (menu suspenso, no máximo 25 categorias).

![O painel Precisa de ajuda? com o menu Com o que você precisa de ajuda? aberto: Suporte, Denunciar um membro e Parceria, cada um com o emoji e a descrição](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-panel-dropdown.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=c72ab9edc7e0490fc4c646ae0365e5ff)

No Discord: um painel com estilo select e o menu aberto.

### Como um painel fica

Um painel é um card: uma **imagem em cima** (opcional), o **título**, o **texto**, uma **linha pequena** embaixo, e os botões ou o menu suspenso abaixo do card. No dashboard você pode escolher a **cor do card** (a faixa do lado dele; sem cor o card não tem faixa, mesmo que a prévia mostre verde), a imagem (um link que começa com `https`), o texto pequeno e, para um menu suspenso, o texto que ele mostra antes da escolha. Uma prévia ao vivo mostra o que os membros vão ver.

![O card do painel de #abrir-ticket, publicado, com o título, o texto, o estilo, a cor do card, a imagem, o texto pequeno e o design salvo, e à direita a prévia com os três botões](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-panel.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=3c85ab481cc498264d229dc1756e440d)

Dashboard → Comunidade → Tickets: um painel com a prévia ao vivo.

O dashboard também tem **designs prontos** para começar (suporte clássico, central de ajuda com menu suspenso, denúncias, candidaturas e minimalista). Eles só preenchem o formulário: você pode mudar o que quiser antes de publicar. Um design salvo em **Embeds** ainda pode substituir o card.

![A seção Novo painel com os designs Suporte clássico, Central de ajuda (menu), Denúncias, Candidaturas e Minimalista, o formulário para publicar um painel e a prévia](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-new-panel.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=2616777c6b3de1a4efb5e5ed471b560a)

Dashboard → Comunidade → Tickets: Novo painel, com os designs prontos.

## Categorias

O que o botão ou a opção do menu suspenso de um painel realmente abre.

![A página Tipos de suporte com Suporte, Denunciar um membro e Parceria, 3 de 25, cada um com Como aparece no painel aberto, e a parte Adicionar um tipo de suporte com Começar com um conjunto pronto](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-types.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=610dd2e47f4e3a1865dd2acc1884f346)

Dashboard → Comunidade → Tipos de suporte: cada tipo com o painel, a aparência, a abertura e a equipe, e o conjunto pronto.

```javascript Sintaxe theme={null}
!ticket category add <panel_id> <key> <label> <parent> <support_role> [emoji] [style] [description] [welcome_embed] [max_open] [naming]
!ticket category edit <key> [label] [parent] [emoji] [style] [description] [welcome_embed] [max_open] [naming]
!ticket category remove <key>
!ticket category list
```

```javascript Exemplo theme={null}
!ticket category add 1 support Suporte #Tickets @Staff
```

> [accordion] !ticket category add
>
> ![kira digita !ticket category add 1 partner Parceria SUPORTE @Partner Manager com um emoji e o Petto responde que a categoria partner foi adicionada ao painel 1](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-category-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=754446703c2097a4abe9661becadf100)
>
> No Discord: uma categoria adicionada ao painel 1.

> [accordion] !ticket category edit
>
> ![kira digita !ticket category edit support --emoji 💬 --max\_open 2 e o Petto responde que a categoria support foi atualizada](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-category-edit.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=129bb45794bbc3a3407b93b50d9f3d5c)
>
> No Discord: uma categoria mudada com flags.

> [accordion] !ticket category remove
>
> ![kira digita !ticket category remove partner e o Petto responde que a categoria partner foi removida](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-category-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=afed01371740efa76b0248e9fb372181)
>
> No Discord: uma categoria removida.

> [accordion] !ticket category list
>
> ![kira digita !ticket category list: support, report e partner, cada uma com o nome, o painel 1, a categoria de canais e os cargos de suporte](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-category-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=faae4c0887b277a82f0d33d92cf64dd0)
>
> No Discord: as categorias do servidor.

`naming` aceita `{number}`, `{username}`, `{userid}` e `{category}`, e o padrão é `ticket-{number}`. `max_open` é o limite por usuário nessa categoria, e o padrão é 1.

Cada categoria pode ter o seu próprio **texto de boas-vindas** com `--welcome` (em `!ticket category add` e `edit`, ou no painel de configuração), sem precisar de um embed salvo. Ele aceita `{user}`, `{username}`, `{category}`, `{server}` e `{number}`.

### Exemplos de nomes e boas-vindas

| Placeholder | Nos nomes | No texto de boas-vindas e nas respostas rápidas | Exemplo |
| - | - | - | - |
| `{number}` | sim | sim | 0042 |
| `{username}` | sim | sim | liam |
| `{userid}` | sim | não | 293504726505357312 |
| `{category}` | sim | sim | Suporte |
| `{user}` | não | sim | @Liam |
| `{server}` | não | sim | Petto Land |

> [tab] Nomes dos canais
>
> ```javascript Comando theme={null}
> !ticket category edit support --naming "{category}-{username}-{number}"
> ```
>
> ```text Resultado theme={null}
> O próximo ticket abre como #suporte-liam-0042
> ```
>
> Os nomes ficam em minúsculas, e espaços, acentos e símbolos viram `-`.
>
> ![kira define o nome \{category}-\{username}-\{number} em support, depois abre um ticket com !ticket open support e o Petto responde Ticket aberto: #suporte-kira-0043](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-naming.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=81204d5d67d917cd12d438f75a0b9ff3)
>
> No Discord: o novo nome, e depois um ticket que o usa.

> [tab] Texto de boas-vindas
>
> ```javascript Comando theme={null}
> !ticket category edit support --welcome "Oi, {user}! Obrigado por entrar em contato com o **{server}**. Conte o que você precisa e alguém de {category} vai responder em breve. Ticket #{number}"
> ```
>
> ```text Resultado theme={null}
> Oi, @Liam! Obrigado por entrar em contato com o Petto Land. Conte o que você precisa e alguém de Suporte vai responder em breve. Ticket #0042
> ```
>
> ![O card de boas-vindas do ticket 0043 do tipo Suporte: menciona Ajudantes e diz Oi @Nova! Obrigado por falar com o Petto Land, com os botões Assumir, Fechar, Transcrição, Adicionar membro e Remover membro](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-welcome-text.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=09a2215d1d9b42fca01f159c91b69120)
>
> No Discord: o texto de boas-vindas do tipo, em um ticket novo.

> [tab] Embed salvo
>
> ```javascript Comando theme={null}
> !ticket category edit support --welcome_embed ticket-welcome
> ```
>
> Um [embed](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md) salvo aceita as [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) normais em vez das curtas acima: `{user}` é o membro que abriu o ticket e `{channel}` é o próprio ticket.
>
> ![Um ticket novo começa com a menção a Ajudantes e o embed ticket-welcome, que cita o membro e o canal do ticket, e os botões do ticket embaixo](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-welcome-embed.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=69ecc75e7331df84b3a81760e9418237)
>
> No Discord: um embed salvo como boas-vindas do tipo.

Só esses placeholders funcionam nos nomes e nos textos de boas-vindas; outras variáveis, como `{server_name}`, ficam do jeito que foram escritas.

`!ticket category add` e `!ticket category edit` também aceitam `form` (o nome de um [formulário](#formulários), ou `none` no `edit` para removê-lo) e `required_role` (um [cargo de que os membros precisam](#cargos-obrigatórios) para abrir a categoria). Na forma com prefixo, escreva-os como flags: `!ticket category edit support --form bug-report`.

### Cargos de suporte e cargos mencionados

Além do que é obrigatório na criação, adicione mais cargos que podem ver os tickets de uma categoria, ou cargos mencionados quando um ticket abre.

```javascript Sintaxe theme={null}
!ticket support-role add <key> <role>
!ticket support-role remove <key> <role>
!ticket support-role list <key>
!ticket ping-role add <key> <role>
!ticket ping-role remove <key> <role>
!ticket ping-role list <key>
```

```javascript Exemplo theme={null}
!ticket support-role add support @Staff-Sênior
!ticket ping-role add support @de-plantão
```

> [accordion] !ticket support-role add
>
> ![kira adiciona @Senior-Staff como cargo de suporte de support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-support-role-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=3bd5e8d479d6aa50e144f752f70405a1)
>
> No Discord: um cargo adicionado.

> [accordion] !ticket support-role remove
>
> ![kira remove @Senior-Staff dos cargos de suporte de support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-support-role-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=d38214ce2534030948a05eb3359ba281)
>
> No Discord: um cargo removido.

> [accordion] !ticket support-role list
>
> ![kira lista os cargos de suporte de support: Ajudantes e Senior-Staff](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-support-role-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=477af28e03e04dcd3c54b09d1b79e68a)
>
> No Discord: os cargos de uma categoria.

> [accordion] !ticket ping-role add
>
> ![kira adiciona @on-call como cargo mencionado de support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-ping-role-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=84edf47f0735e420894088eb31d56785)
>
> No Discord: um cargo adicionado.

> [accordion] !ticket ping-role remove
>
> ![kira remove @on-call dos cargos mencionados de support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-ping-role-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=2627b9d7c81bfece564dc648a269db5e)
>
> No Discord: um cargo removido.

> [accordion] !ticket ping-role list
>
> ![kira lista os cargos mencionados de support: Ajudantes e on-call](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-ping-role-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=201e3f690a3aff945232e1797660323c)
>
> No Discord: os cargos de uma categoria.

### Cargos obrigatórios

Limite uma categoria aos membros que têm um cargo (por exemplo, um cargo pago ou de verificado).

```javascript Sintaxe theme={null}
!ticket required-role add <key> <role>
!ticket required-role remove <key> <role>
!ticket required-role list <key>
```

```javascript Exemplo theme={null}
!ticket required-role add vip-support @VIP
```

> [accordion] !ticket required-role add
>
> ![kira torna @VIP obrigatório para vip-support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-required-role-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=83c975068035f0382d1db58a36c244b6)
>
> No Discord: um cargo adicionado.

> [accordion] !ticket required-role remove
>
> ![kira remove @VIP dos cargos obrigatórios de vip-support e o Petto confirma](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-required-role-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=e568486fabe4a3de854de26b0a7c06e0)
>
> No Discord: um cargo removido.

> [accordion] !ticket required-role list
>
> ![kira lista os cargos obrigatórios de vip-support: VIP](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-required-role-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=12572309986f253cfe8e525a2b09a962)
>
> No Discord: os cargos de uma categoria.

> [accordion] Um membro sem o cargo
>
> ![Abaixo do painel, agora com um botão Suporte VIP, o Petto responde só para o membro: Você precisa de @VIP para abrir este ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-required-role-refused.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=ad69fd63a4f206b2968595aefcc65b0b)
>
> No Discord: um membro sem @VIP aperta Suporte VIP.

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

> [accordion] !ticket blacklist add
>
> ![kira digita !ticket blacklist add @griefer\_99 com um motivo e o Petto responde que griefer\_99 foi adicionado à lista negra de tickets](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-blacklist-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=968b5eb4ecd990617da66a573ee78c27)
>
> No Discord: um membro bloqueado dos tickets, com um motivo.

> [accordion] !ticket blacklist remove
>
> ![kira digita !ticket blacklist remove @griefer\_99 e o Petto responde que griefer\_99 foi removido da lista negra de tickets](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-blacklist-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=3accfc5b6d82e5549913e6207f32517f)
>
> No Discord: um membro tirado da lista negra.

> [accordion] !ticket blacklist list
>
> ![kira digita !ticket blacklist list: griefer\_99 com o motivo, e o cargo Silenciado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-blacklist-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=668373522968d7f61b1ad0d1247d6432)
>
> No Discord: quem não pode abrir tickets.

> [accordion] Dashboard
>
> ![A página Acesso a tickets com griefer\_99 e o cargo Silenciado bloqueados, cada um com Desbloquear, e o formulário para bloquear um membro ou cargo](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-access.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=4dc99d5110c645160d06f6be5df03dda)
>
> Dashboard → Comunidade → Acesso a tickets: os membros e cargos bloqueados.

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

Para que um membro ou um cargo não possa abrir tickets, use a lista negra de tickets (uma entrada de cargo vale para todos os membros com esse cargo). O dashboard tem isso em **Acesso a tickets**.

```javascript Sintaxe theme={null}
!ticket blacklist add [user] [role] [reason]
!ticket blacklist remove [user] [role]
!ticket blacklist list
```

```javascript Exemplo theme={null}
!ticket blacklist add @Alguém --reason "Tickets de brincadeira"
!ticket blacklist add @Silenciado
```

## Horário da equipe e limites

Em **Configurações de tickets** você pode definir:

* **Tickets abertos ao mesmo tempo por membro**, para o servidor inteiro (0 para sem limite). Cada tipo também tem o seu próprio limite.
* **Horário da equipe**: dias, de e até, e um fuso horário. Fora desse horário, o ticket abre com um aviso que diz quando a equipe responde (você pode escrever a mensagem, com `{start}`, `{end}` e `{timezone}`, por exemplo `Nossa equipe está offline. Respondemos de {start} até {end} ({timezone}).`), ou você pode escolher não deixar abrir tickets.

> [accordion] Limite do servidor atingido
>
> ![Abaixo do painel, o Petto responde só para o membro que ele já tem 1 ticket aberto e o limite do servidor é 1](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-limit-refused.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=b5e956e06ad6c3f11e80c3111edb3d58)
>
> No Discord: um membro no limite do servidor tenta abrir outro ticket.

> [accordion] Fora do horário da equipe
>
> ![Um ticket novo com o card de boas-vindas e, embaixo, o aviso de que a equipe não está e responde das 14:00 às 22:00 (America/Bogota)](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-outside-hours.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=9d026f8a37f70d4af892fb88d2cc3a90)
>
> No Discord: um ticket aberto fora do horário da equipe recebe o aviso.

* **Lembrete para tickets não assumidos**: depois dos minutos que você escolher, os cargos de suporte do tipo são mencionados uma vez em um ticket que ninguém assumiu (0 para sem lembrete).

![No ticket 0042 enderwolf pede ajuda; depois o Petto menciona Ajudantes: o ticket está esperando há 30 minutos e ninguém assumiu](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-reminder.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=560b6bdcf5b612715235b481f7e91219)

No Discord: ninguém assumiu o ticket em 30 minutos, então os cargos de suporte são mencionados uma vez.

Todo canal de ticket também ganha um **tópico** com o número, o tipo e quem o abriu, para a equipe ver tudo de relance.

* **Exclusão automática**: o canal de um ticket fechado é apagado depois das horas que você escolher (a transcrição é mantida). 0 mantém os canais até alguém apagá-los.

![A página Configurações de tickets: um lembrete depois de 30 minutos, canais fechados apagados depois de 48 horas, o canal de transcrições, 2 tickets abertos por membro e horário da equipe das 9:00 às 22:00, de segunda a sábado, com mensagem própria](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-settings.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=e85705c294de5b223a35af9bc24be474)

Dashboard → Comunidade → Configurações de tickets: assumir, encerramento, transcrições, fechamento automático, avaliações, logs, limites, horário da equipe e cargos bloqueados.

## Respostas rápidas

Textos que a equipe envia dentro de um ticket com um comando, para as perguntas que aparecem o tempo todo.

```javascript Sintaxe theme={null}
!quickreply add <name> <text>
!quickreply send <name>
!quickreply list
!quickreply remove <name>
```

```javascript Exemplo theme={null}
!quickreply add regras Oi, {user}! Por favor, leia as regras e conte o que você precisa.
!quickreply add resolvido Que bom que pudemos ajudar, {username}! O ticket {number} será fechado em breve. Obrigado por fazer parte do {server} 💛
!qr send regras
```

> [accordion] !quickreply add
>
> ![kira salva a resposta rápida rules e o Petto responde que foi salva e como enviá-la](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-quickreply-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=1c28ae175fab3b7fa99ba7c4deeb4d68)
>
> No Discord: uma resposta rápida salva.

> [accordion] !qr send
>
> ![No ticket 0042 enderwolf diz que agora funciona; shi digita !qr send solved e o Petto publica o texto com o nome do membro, o número 0042 e Petto Land, e depois Enviado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-quickreply-send.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=b7692722bfc7ed50c4d49d7bff2f6ebc)
>
> No Discord: uma resposta rápida enviada em um ticket.

> [accordion] !quickreply list
>
> ![shi digita !quickreply list: booster-role, rules e solved, cada uma com o começo do texto](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-quickreply-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=8d65301f6c16af11e3b10add7c1c12c2)
>
> No Discord: as respostas rápidas do servidor.

> [accordion] !quickreply remove
>
> ![kira digita !quickreply remove booster-role e o Petto responde que foi apagada](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-quickreply-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=f170713073f1133e16f8e11269cb9f6e)
>
> No Discord: uma resposta rápida apagada.

`add` e `remove` precisam de **Gerenciar servidor**; `send` só funciona dentro de um ticket aberto e só para a equipe dele. Você pode usar `{user}`, `{username}`, `{category}`, `{server}` e `{number}`. Dá para guardar até 50, e elas também podem ser gerenciadas no dashboard (**Respostas rápidas**).

![A página Respostas rápidas com booster-role, rules e solved, cada uma com !qr send e o texto, e o formulário Nova resposta rápida](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-replies.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=aeebacb13973fe1b3b667a28d612c98e)

Dashboard → Comunidade → Respostas rápidas: os textos salvos e um novo.

No dashboard, a página **Tickets ao vivo** também mostra os números dos seus tickets, e **Tipos de suporte** pode adicionar um conjunto pronto (Suporte, Reportar um jogador, Compras e Apelações) com um clique.

![A página Tickets ao vivo: 3 abertos, 1 sem quem assuma, 11 abertos e 8 fechados em 7 dias, 3 h 38 min abertos em média e avaliação 4,5, os três tickets abertos, os fechados com um botão Transcrição e o gráfico de 14 dias](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-open.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=507f197d4d93f78de55d4b64dfa79ff4)

Dashboard → Comunidade → Tickets ao vivo: os números, os tickets abertos e os fechados com transcrição.

> [!NOTE]
>
> Tudo o que é automático aqui começa **desativado ou em 0**: o lembrete, a exclusão automática de canais fechados, o limite, o horário da equipe e o encerramento automático. Nada é apagado ou fechado sozinho até você ativar.

### IA de tickets (em breve)

O assistente de IA para tickets é um beta fechado: só os servidores em que a equipe do Petto o ativou veem uma página **Assistente de IA** em **Comunidade → Tickets**, e só ali ele pode cumprimentar os membros e escrever as primeiras respostas nos tickets. Os outros servidores ainda não têm essa página. Será um **produto Premium separado**, vendido à parte e **não incluído** no plano Premium.

`!ticket stats` (Gerenciar servidor) mostra os números dos seus tickets: quantos estão abertos e não assumidos, abertos e fechados nos últimos 7 e 30 dias, o tempo médio que um ticket fica aberto, a avaliação média e quem mais assume tickets.

![liam digita !ticket stats: 5 abertos (2 sem ninguém assumir), 16 abertos e 11 fechados em 7 dias, 3 h 31 min abertos em média, avaliação 4,5 de 41, e shi, chu, kira e Chillet como quem mais assume](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-stats.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=7e4e195ddef6a3baef5a4b7c7fb184fa)

No Discord: os números dos tickets do servidor.

Fechar com um motivo, a DM com a transcrição, avaliações, reabrir e apagar um ticket fechado estão na mesma página.

Como toda DM do Petto, as DMs da transcrição e do fechamento começam com uma linha `De <servidor>` e têm botões de info, apagar e denunciar: veja [DMs do Petto](https://wiki.petto.sbs/pt-br/moderation/dms-from-petto.md).

## Transcrições

Uma transcrição é a conversa salva de um ticket. Ela é criada quando o ticket fecha, ou quando a equipe clica no botão de transcrição. Em **Configurações de tickets > Transcrições** você escolhe:

* **Canal de transcrições**: toda transcrição também é enviada para lá, além dos logs. Vazio significa que ele não é usado.
* **Como é enviada**: automático (um link, ou o arquivo se o servidor não tiver link), só o link, só o arquivo HTML, ou os dois. Vale para os logs, para o canal de transcrições e para a mensagem a quem abriu (que só a recebe se a opção de enviá-la ao fechar estiver ativada).

> [accordion] Configurações de tickets: Transcrições
>
> ![O card Transcrições com #transcricoes como canal de transcrições e Link e arquivo como forma de envio](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-transcripts.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=e7820c6a684e312d73454619c294779f)
>
> Dashboard → Comunidade → Configurações de tickets: o card Transcrições.

> [accordion] O canal de transcrições
>
> ![Em #transcricoes o Petto publica a transcrição do ticket 42 aberto por enderwolf, com Ver online, o botão Ver transcrição e o arquivo ticket-42-transcript.html](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-transcript-channel.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=6afdee03b7a8a6f752bddc5733aea053)
>
> No Discord: a transcrição de um ticket fechado no canal de transcrições, com o link e o arquivo.

> [accordion] A DM para quem abriu
>
> ![Uma DM do Petto: Seu ticket 0042 foi fechado, com o servidor, a categoria, quem atendeu e fechou, o motivo, quando abriu e o canal, os cinco botões de estrelas para avaliar e Ver transcrição](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-closed-dm.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=861d53cc97bc7eee1599e1a0ccdbecc7)
>
> No Discord: a DM que o membro recebe quando o ticket fecha.

Os tickets fechados com transcrição salva aparecem na página **Tickets ao vivo** do dashboard, cada um com um botão **Transcrição** que a abre.

![A lista Fechados, com transcrição: os tickets 0041 a 0030 com o tipo, quem abriu, quando fecharam e o motivo, cada um com um botão Transcrição, e o gráfico dos últimos 14 dias](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-closed.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=01b8bfc86c04dcc09abb28f135bec169)

Dashboard → Comunidade → Tickets ao vivo: os tickets fechados com transcrição.

## Formulários

Um formulário é um questionário curto (um pop-up do Discord) mostrado ao membro antes de o ticket abrir, para que a equipe receba logo os detalhes de que precisa. Crie um formulário uma vez e associe-o a qualquer categoria.

![A página Formulários de ticket com bug-report e partner-info, cada um com o título e os campos, e a parte Novo formulário](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/tickets-dash-forms.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=39446284d62eec554243578fbb2f49cd)

Dashboard → Comunidade → Formulários de ticket: os formulários e os campos.

```javascript Sintaxe theme={null}
!ticket form create <name> <fields> [title]
!ticket form edit <name> [fields] [title]
!ticket form delete <name>
!ticket form list
```

```javascript Exemplo theme={null}
!ticket form create bug-report "long_text|what|O que aconteceu?|Conte o que você fez|required;short_text|device|Dispositivo|Celular ou PC|optional" "Reportar um bug"
!ticket category edit support --form bug-report
```

> [accordion] !ticket form create
>
> ![kira digita !ticket form create bug-report com dois campos e um título e o Petto responde que o formulário bug-report foi criado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-create.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=8f9d70dddc2397d515d93d2a542d32ef)
>
> No Discord: um formulário feito com os campos.

> [accordion] !ticket form edit
>
> ![kira digita !ticket form edit bug-report --title e o Petto responde que o formulário foi atualizado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-edit.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=fd205009d7c2b4e0805bf75acd3c1d1a)
>
> No Discord: um título novo para um formulário.

> [accordion] !ticket form delete
>
> ![kira digita !ticket form delete partner-info e o Petto responde que foi apagado](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-delete.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=0c5528658233110d09a8b9aaaba3162c)
>
> No Discord: um formulário apagado.

> [accordion] !ticket form list
>
> ![kira digita !ticket form list: bug-report com 2 campos e partner-info com 3](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-list.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=20ee31057352859b2d356f9e943f6159)
>
> No Discord: os formulários de ticket do servidor.

O jeito fácil é com botões: `!ticket form create <name>` (e `!ticket form edit <name>`), sem campos, abre um painel onde você adiciona perguntas com um botão (resposta curta, parágrafo, opções, envio de arquivos, seletor de membro, cargo ou canal, ou um texto), define uma dica e se cada uma é obrigatória, remove a última, muda o título e salva. O dashboard tem um construtor mais completo, com [todos os tipos de pergunta](#tipos-de-pergunta). O texto `fields` abaixo continua funcionando para quem preferir.

![kira digita !ticket form create appeal e o Petto responde com o construtor: Detalhes do ticket com uma pergunta de resposta curta e uma de parágrafo, as duas obrigatórias, e os botões Adicionar resposta curta, Adicionar parágrafo, Remover a última, Título, Salvar e Cancelar](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-builder.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=bbface1fa72319b8a7988c467550624c)

No Discord: o construtor de formulários com duas perguntas.

![O formulário Adicionar uma pergunta curta com a pergunta Qual sanção?, a dica e sim em Obrigatória](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-builder-modal.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=a23e2d35253a6db4ec4c1205542fdf01)

No Discord: Adicionar resposta curta pede a pergunta, uma dica e se é obrigatória.

`fields` são de 1 a 5 campos separados por `;`, e cada campo é `type|id|label|placeholder|required`:

| Parte | Significado |
| - | - |
| `type` | `short_text` (uma linha), `long_text` (um parágrafo) ou um dos [outros tipos de pergunta](#tipos-de-pergunta). |
| `id` | Um nome curto para o campo, com letras, números, `_` e `-`. |
| `label` | A pergunta, com até 45 caracteres. |
| `placeholder` | A dica cinza dentro da caixa, com até 100 caracteres. |
| `required` | `required` (o padrão) ou `optional`. |
| `extra` | Opcional, para os outros tipos: as opções separadas por vírgulas em `select`, `radio` e `checkboxes` (`Bug,Pagamentos,Outro`), `images` ou `any` e um número de 1 a 5 em `file` (`images,3`), o máximo que um membro pode escolher em `user`, `role` e `channel`, ou o texto de um `display`. |

`title` é o título do pop-up, com até 45 caracteres (padrão "Detalhes do ticket"). As respostas são publicadas no novo ticket e salvas junto com ele.

![O formulário Reportar um bug com O que aconteceu? (obrigatório) e Dispositivo, preenchido pelo membro](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-modal.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=a86b1aa7ffed86c9ceee77f8db9d2533)

No Discord: o formulário que o membro preenche antes de o ticket abrir.

![O ticket novo 0043 com o card de boas-vindas, e depois o Petto publica Formulário enviado com a resposta para O que aconteceu? e Dispositivo](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-form-answers.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=8068f19bc20eb880b716b545e1453a55)

No Discord: as respostas, publicadas no ticket novo.

### Tipos de pergunta

Além das respostas curtas e dos parágrafos, uma pergunta pode ser qualquer uma destas. Um formulário continua tendo no máximo **5 partes** (um texto que só informa conta como uma, é um limite do Discord) e pelo menos uma precisa ser algo que os membros respondam.

| Tipo | `type` | O que o membro vê | Como a resposta aparece no ticket |
| - | - | - | - |
| Menu suspenso | `select` | Um menu com 1 a 25 opções, dá para escolher uma ou várias | A opção, ou uma lista quando há mais de uma |
| Botões de opção | `radio` | 2 a 10 opções, dá para escolher uma | A opção |
| Caixas de seleção | `checkboxes` | 1 a 10 opções, dá para marcar qualquer quantidade | Uma lista |
| Uma caixa de seleção | `check` | Uma caixa para marcar. Uma obrigatória precisa estar marcada | Um sinal de certo ou um X |
| Envio de arquivos | `file` | Até 5 arquivos, só imagens ou qualquer arquivo | As imagens como galeria, os outros arquivos como arquivos |
| Seletor de membro, cargo ou canal | `user`, `role`, `channel` | Um seletor, até 25 escolhas | Menções que não avisam ninguém |
| Só texto | `display` | Um texto que informa (Markdown funciona), sem nada para responder | Não aparece nas respostas |

Cada pergunta também pode ter um texto de ajuda curto embaixo. Uma pergunta é obrigatória a não ser que você a torne opcional, exceto uma caixa sozinha, que o Discord não consegue tornar obrigatória e que o Petto só exige se você pedir.

```javascript Exemplo theme={null}
!ticket form create report "select|topic|Sobre o que é?||required|Trapaça,Assédio,Outro;user|who|Qual membro?||optional;file|proof|Capturas de tela||required|images,3" "Denunciar um jogador"
```

### Imagens e arquivos

Os links do Discord para os arquivos que um membro envia em um formulário podem parar de funcionar, então o Petto copia cada arquivo para o ticket: baixa o arquivo (só de endereços públicos, até **8 MB** por arquivo e nunca mais que o limite de envio do servidor) e o envia de novo ao canal do ticket, onde ele fica enquanto o ticket existir. Um ticket copia até 10 arquivos.

* As **imagens** (PNG, JPG, GIF e WebP) aparecem nas respostas como uma galeria.
* Os **outros arquivos** aparecem como arquivos, com nome e tamanho, prontos para baixar.
* Uma pergunta definida como **só imagens** confere o tipo e os primeiros bytes de cada arquivo. Qualquer outra coisa é recusada com uma mensagem privada no formulário, e nenhum ticket é aberto.
* Se um arquivo não puder ser copiado (é grande demais, o download falhou ou o ticket já tem 10 arquivos), as respostas guardam o link, o nome e o tamanho e avisam que o link pode parar de funcionar.

### Como as respostas aparecem

As respostas são publicadas no novo ticket, depois da mensagem de boas-vindas, e não avisam ninguém: as menções a membros, cargos e canais aparecem mas não notificam, e o `@everyone` nunca funciona. Uma resposta longa é cortada em 1000 caracteres, e quando há muito texto, muitos arquivos ou muito peso, as respostas continuam em mais cards. A [transcrição](#transcrições) mostra o mesmo card, com as imagens desenhadas uma só vez e os arquivos como links, e os nomes de arquivo aparecem como texto simples.

No dashboard (**Comunidade > Formulários de ticket**) cada pergunta tem o seu tipo, as opções são escritas uma por linha, um envio de arquivos diz se aceita só imagens ou qualquer arquivo e quantos (de 1 a 5), uma pergunta pode ser obrigatória, as setas a sobem ou descem, e uma prévia mostra a janela do Discord. Os formulários são salvos como antes, e os formulários que você já tem continuam funcionando como estão.

## Usando um ticket

Os botões dos tickets se arrumam sozinhos. Um botão apertado tarde, ou em um ticket cujo canal já não existe, não mostra mais um erro. Se algo falhar de verdade, o Petto diz ao membro para tentar de novo e que a equipe foi avisada.

```javascript Sintaxe theme={null}
!ticket open <category>
!ticket close [reason]
!ticket reopen
!ticket delete
!ticket claim
!ticket unclaim
!ticket add <user>
!ticket remove <user>
!ticket rename <name>
!ticket transcript
!ticket info
```

```javascript Exemplo theme={null}
!ticket open support
!ticket close "Resolvido, obrigado!"
```

![O ticket 0042 do tipo Suporte menciona Ajudantes com o cartão de boas-vindas e os botões Assumir, Fechar, Transcrição, Adicionar membro e Remover membro; enderwolf explica o problema e shi assume o ticket](https://mintcdn.com/wikipetto/LoL7QuPJ71yd9F_N/images/discord/community/pt-br/tickets.webp?fit=max\&auto=format\&n=LoL7QuPJ71yd9F_N\&q=85\&s=fc6e103472c1f57d634b36d49296b000)

No Discord: um ticket novo, a primeira mensagem do membro e alguém da equipe assumindo.

> [accordion] !ticket open
>
> ![Nova digita !ticket open support em #comandos e o Petto responde Ticket aberto: #suporte-0043](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-open.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=8f705f717d1a9f35476cbaffa2a66c82)
>
> No Discord: um ticket aberto sem painel.

> [accordion] Botão do painel
>
> ![Abaixo do painel, o Petto responde só para o membro: Ticket aberto: #suporte-0043](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-open-click.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=2734cfd2f73002853a886d7d25d6aa87)
>
> No Discord: um membro aperta Suporte no painel.

> [accordion] !ticket claim
>
> ![shi digita !ticket claim no ticket 0042; o Petto publica Ticket assumido, shi está cuidando, e responde Você assumiu este ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-claim.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=94d92aaa6d6c4291b564d88bb09ab870)
>
> No Discord: um ticket assumido.

> [accordion] !ticket unclaim
>
> ![shi digita !ticket unclaim; o Petto publica Ticket liberado e responde Liberado](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-unclaim.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=87991a5467e969935e91dfd9b0765275)
>
> No Discord: uma reivindicação liberada.

> [accordion] !ticket close
>
> ![enderwolf agradece a equipe, shi digita !ticket close com um motivo e o Petto publica Ticket 0042 fechado com o motivo e os botões Reabrir, Apagar e Ver transcrição](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-close.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=95172a311d5a93e1b0c22e909da21e86)
>
> No Discord: um ticket fechado com um motivo.

> [accordion] Botão Fechar
>
> ![O formulário Fechar ticket com um motivo opcional escrito](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-close-modal.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=44c49e6ac344cc3c2decb0a523b00209)
>
> No Discord: o botão Fechar pede um motivo opcional.

> [accordion] !ticket reopen
>
> ![shi digita !ticket reopen; o Petto publica Ticket reaberto por shi com os botões do ticket e responde Ticket reaberto](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-reopen.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=4fc9e76e305644047e28bb445adff2ea)
>
> No Discord: um ticket fechado aberto de novo.

> [accordion] !ticket delete
>
> ![shi digita !ticket delete e o Petto responde Apagando este canal](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-delete.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=9785662cd86447fabe2e955c5af9f64a)
>
> No Discord: o canal de um ticket fechado apagado.

> [accordion] !ticket add
>
> ![shi digita !ticket add @Luna e o Petto responde que adicionou Luna a este ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-add.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=5011ac6936aa913705c45fc28616804e)
>
> No Discord: um membro adicionado ao ticket.

> [accordion] Botão Adicionar membro
>
> ![O Petto responde só para a equipe: Quem você quer adicionar?, com um menu de membros](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-add-member-button.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=20145634c6bd60323d86ef5ee503cb5d)
>
> No Discord: o botão Adicionar membro pergunta quem.

> [accordion] !ticket remove
>
> ![shi digita !ticket remove @Luna e o Petto responde que removeu Luna deste ticket](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-remove.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=62d9915e47a8611a687fdd4a74df0b97)
>
> No Discord: um membro tirado do ticket.

> [accordion] !ticket rename
>
> ![shi digita !ticket rename com três palavras e o Petto responde que foi renomeado com hifens entre elas](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-rename.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=dd448168b2bd1b67c9db6f0e94234046)
>
> No Discord: um ticket renomeado.

> [accordion] !ticket transcript
>
> ![shi digita !ticket transcript e o Petto responde que a transcrição foi publicada no log de tickets, com o botão Ver transcrição](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-transcript.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=498e15442f1d05970096afe7956193d8)
>
> No Discord: uma transcrição publicada sem fechar.

> [accordion] !ticket info
>
> ![shi digita !ticket info: ticket 42, Suporte, aberto por enderwolf, aberto, assumido por shi, prioridade alta, aberto há 35 minutos](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-info.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=6a2075ef7c833a00e77ffe6be16c8f03)
>
> No Discord: o que o Petto sabe do ticket.

### Ferramentas da equipe dentro de um ticket

```javascript Sintaxe theme={null}
!ticket priority <low|normal|high|urgent>
!ticket transfer <user>
!ticket note [text]
!ticket request-close [reason]
```

> [accordion] !ticket priority
>
> ![shi digita !ticket priority high; o Petto publica que shi definiu a prioridade como alta e responde que a prioridade agora é alta](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-priority.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=c47b58c234b4c7cf657b0b910d66b955)
>
> No Discord: a prioridade de um ticket.

> [accordion] !ticket transfer
>
> ![shi digita !ticket transfer @chu; o Petto publica que shi passou o ticket para chu e responde que chu está com o ticket agora](https://mintcdn.com/wikipetto/njNy1RYd5OMIlGZk/images/discord/community/pt-br/tickets-transfer.webp?fit=max\&auto=format\&n=njNy1RYd5OMIlGZk\&q=85\&s=9b91b41c2656a4dc41ad7d32fea829b2)
>
> No Discord: um ticket passado para outra pessoa da equipe.

> [accordion] !ticket note
>
> ![shi salva uma nota com !ticket note e o Petto responde Nota salva; depois !ticket note sem texto lista a nota de chu e a nova de shi](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-note.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=f2e73a360de796b890ff56d3f3b2212a)
>
> No Discord: uma nota privada salva, e depois as notas lidas.

> [accordion] !ticket request-close
>
> ![shi digita !ticket request-close com um motivo; o Petto menciona enderwolf perguntando se pode fechar, com Sim, feche e Não, deixe aberto, e responde que pediu para confirmar](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-request-close.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=7b1bf392a5f0eb27989ed0abbd8daa81)
>
> No Discord: o membro é perguntado se o ticket pode ser fechado.

> [accordion] Sim, feche
>
> ![Abaixo da pergunta o Petto escreve que enderwolf aceitou fechar, e publica Ticket 0042 fechado por enderwolf com o motivo de que o membro confirmou que estava resolvido](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-request-close-yes.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=1bfb1c2cf301ec24f19558f1c9f22dbd)
>
> No Discord: o membro aceita e o ticket fecha.

`priority` aparece no `!ticket info`. `transfer` passa o ticket para outro membro da equipe da categoria. `note` salva uma nota privada para a equipe (escreva uma, ou use sem texto para lê-las). `request-close` pergunta ao membro, com botões Sim/Não, se o ticket pode ser fechado.

`open` funciona sem nenhum painel. `close` gera automaticamente um link de transcrição para compartilhar, e `transcript` publica um sem fechar. `claim`/`unclaim`, `reopen`, `delete` e `rename` são só para a equipe.

![enderwolf digita !ticket claim no próprio ticket e o Petto responde que só a equipe da categoria pode fazer isso](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-staff-only.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=263796302448868c90a5b3606fa7831d)

No Discord: um membro tenta um comando só da equipe.

## Limites

Um servidor gratuito pode ter 25 tipos de ticket, e um servidor Premium, 50. `!ticket category add`, `!ticket setup` e o dashboard contam todos da mesma forma, e a configuração diz quantos ainda cabem antes de criar qualquer coisa. Um painel continua mostrando no máximo 5 botões ou 25 opções no menu suspenso, como o Discord permite. Veja [Premium](https://wiki.petto.sbs/pt-br/overview/premium.md). Um formulário de ticket tem até 5 partes, com arquivos de até 8 MB cada (veja [Formulários](#formulários)).

![kira digita !ticket category add e o Petto responde que o servidor já tem 25 tipos de ticket, o máximo de um servidor gratuito, e que o Premium aumenta para 50](https://mintcdn.com/wikipetto/yvwTI4WDSefwU9f6/images/discord/community/pt-br/tickets-category-limit.webp?fit=max\&auto=format\&n=yvwTI4WDSefwU9f6\&q=85\&s=214eb9f4fd96b53a2ef078cc73b8a1c6)

No Discord: um servidor gratuito com 25 tipos de ticket tenta adicionar mais um.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.