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

# Formulários

> Candidaturas para a equipe, pedidos de parceria e inscrições: formulários que os membros preenchem no Discord ou na web, revisados com Aceitar e Recusar.

## Visão geral

Um formulário é uma lista de perguntas que os membros respondem a partir de um painel no Discord ou da própria página dele na web. Cada resposta chega como um card em um canal de revisão, com **Aceitar**, **Recusar** e **Abrir tópico**. Aceitar ou recusar pode dar e tirar cargos, envia uma DM ao membro e fica registrado no log.

Use para candidaturas para a equipe, pedidos de parceria, inscrições em eventos, apelações de banimento que não estão ligadas a uma sanção (para essas, veja [Apelações](https://wiki.petto.sbs/pt-br/moderation/appeals.md)) ou qualquer pergunta que você queira respondida em ordem.

> [!NOTE]
>
> `!form` é um comando de prefixo (aliases `!forms`, `!application`, `!applications`). Criar e mudar formulários precisa de **Gerenciar servidor**. Revisar precisa de Gerenciar servidor ou de um dos **cargos revisores** do formulário. O dashboard tem o mesmo em **Formulários**.

## Configure um formulário em cinco passos

**1. Crie o formulário**

`!form create staff Candidatura para a equipe` cria um formulário chamado `staff` com o título que os membros veem (45 caracteres). Um formulário novo fica **fechado** até você abri-lo.

![liam digita !form create staff com o título e o Petto responde que o formulário staff foi criado, que está fechado por enquanto e o que fazer depois](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-step-create.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=e5d77691d3dc54c08cc619c3f1d1d081)

No Discord: um formulário criado, fechado até ser aberto.

**2. Adicione as perguntas**

`!form question add staff short Quantos anos você tem?` adiciona uma pergunta no final. Veja [Perguntas](#perguntas) para os tipos e as opções.

![liam digita !form question add staff short Quantos anos você tem? e o Petto responde que a pergunta 1 foi adicionada (texto curto)](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-step-question.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=1e597fa4422b7689da2f84708d01f44c)

No Discord: a primeira pergunta adicionada.

**3. Escolha o canal de revisão**

`!form set staff channel #candidaturas` é onde os cards chegam. Um formulário sem canal de revisão não pode ser aberto.

![liam digita !form set staff channel #candidaturas e o Petto responde que channel de staff foi salvo](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-step-channel.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=6090512ab835eaf6466fd82a72d54461)

No Discord: o canal de revisão escolhido.

**4. Abra o formulário**

`!form open staff` deixa os membros responderem.

![liam digita !form open staff e o Petto responde que o formulário está aberto e os membros podem preencher pelo painel](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-step-open.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=f08d7d5d96ba5af7fb41ca1ffd96ab03)

No Discord: o formulário aberto.

**5. Publique um painel**

`!form panel #candidate-se staff` publica um botão que abre o formulário. Um painel pode abrir vários formulários: `!form panel #candidate-se staff partner --style select` cria um menu em vez de botões, e `--web yes` adiciona um botão de link **Preencher na web**.

![liam digita !form panel #inscricoes staff partner; o Petto publica o card com os botões Candidatar-me e Pedido de parceria e responde Painel publicado com o link](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-step-panel.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=376dbb8d7f413b54840fa8d8caf59497)

No Discord: um painel com um botão para cada formulário.

![O painel com o menu Escolha um formulário para preencher aberto: Candidatar-me e Pedido de parceria, cada um com a descrição](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-panel-select.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=a33975da08b348d908bb2560b4c75d0a)

No Discord: o mesmo painel com --style select.

## Comandos

```javascript Sintaxe theme={null}
!form create <name> [title]
!form delete <form>
!form list
!form info <form>
!form open <form>
!form close <form>
!form relink <form>
!form set <form> <setting> <value>
!form message <form> <submitted|accepted|denied> [text] [template]
!form questions <form>
!form question add <form> <type> <label> [required] [help] [description] [image] [placeholder] [min] [max] [options] [choices]
!form question edit <form> <position> <field> <value>
!form question move <form> <from> <to>
!form question remove <form> <position>
!form panel <channel> <forms> [style] [template] [title] [description] [web]
!form submissions [form] [status]
!form view <number>
!form accept <number> [reason]
!form deny <number> [reason]
!form retention [days]
```

```javascript Exemplo theme={null}
!form create staff "Candidatura para a equipe"
!form question add staff paragraph Por que você quer entrar para a equipe?
!form question add staff choice Em que fuso horário você está? --options "América|Europa|Ásia|Outro"
!form set staff channel #candidaturas
!form set staff accept-roles @Ajudante
!form open staff
!form panel #candidate-se staff --web yes
!form accept 12 Boas-vindas à equipe!
```

> [accordion] !form list
>
> ![liam digita !form list: staff, partner e game-night com o título, o estado, as perguntas e as respostas pendentes](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-list.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=4682a9e7202ae161d620b805dfeef64d)
>
> No Discord: os formulários do servidor.

> [accordion] !form close
>
> ![liam digita !form close partner e o Petto responde que está fechado e que os painéis avisam](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-close.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=c3675be5442a0bd2180e29c5ff2f0e02)
>
> No Discord: um formulário fechado.

> [accordion] !form delete
>
> ![liam digita !form delete game-night e o Petto responde que foi apagado e que as respostas ficam](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-delete.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=33723a0bc1c68fdc21fdefcb982505e3)
>
> No Discord: um formulário apagado; o que os membros enviaram fica.

`form` é o nome ou o número de um formulário. O número pertence ao seu servidor: o primeiro formulário que você faz nele é o número 1, não importa o que os outros servidores tenham. Um `form` que é uma palavra é escrito em minúsculas, com letras, números, `-` e `_`. Nomes curtos também funcionam: `!form new`, `!form edit` (para `set`), `!form q add`, `!form subs`, `!form approve`, `!form reject`, `!form show` e `!form newlink`.

`!formconfig` mostra o card do módulo com todas as configurações de uma vez.

![liam digita !formconfig: a retenção, os três formulários com o estado e o canal de revisão, e todos os comandos de formulários](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-formconfig.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=a5fdc4fc3fcaeb41984d4985e4936255)

No Discord: o card do módulo de formulários.

## Perguntas

| Tipo | O que o membro vê |
| - | - |
| `short` | Uma linha de texto |
| `paragraph` | Um texto longo |
| `number` | Um número, com um valor mínimo e máximo opcionais |
| `yesno` | Sim ou não |
| `choice` | Uma opção de uma lista |
| `multi` | Várias opções de uma lista (`choices` diz quantas) |

Cada pergunta também pode ter:

* `required`: se uma resposta é necessária (sim, por padrão).
* `help`: uma linha embaixo da pergunta, com até 100 caracteres. O Discord a mostra embaixo do campo.
* `description`: um texto mais longo, com até 1.000 caracteres, com **negrito**, *itálico* e links. A página web o mostra inteiro; o Discord mostra o começo dele quando não há linha `help`.
* `image`: uma imagem acima da pergunta na página web, um link `https` para um arquivo `.png`, `.jpg`, `.gif` ou `.webp`.
* `placeholder`: o texto cinza no campo vazio.
* `min` e `max`: o tamanho de um texto, ou o intervalo de um número.
* `options`: para `choice` e `multi`, separadas por `|`.

```javascript Exemplo theme={null}
!form question edit staff 2 description Conte sobre **qualquer** servidor que você ajudou a cuidar. [Nossas regras](https://example.com/rules)
!form question edit staff 2 image https://example.com/banner.png
!form question move staff 3 1
!form questions staff
```

> [accordion] !form question edit
>
> ![liam digita !form question edit staff 6 description com negrito e um link e o Petto responde que a pergunta 6 mudou](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-question-edit.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=8540a5b141afd1e914eb0130a645aa54)
>
> No Discord: uma descrição com negrito e um link.

> [accordion] !form question move
>
> ![liam digita !form question move staff 3 1 e o Petto responde que o fuso horário agora é a pergunta 1](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-question-move.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=f196b1d01f41d594fc33f349d0c111db)
>
> No Discord: uma pergunta movida para o começo.

> [accordion] !form question remove
>
> ![liam digita !form question remove staff 4 e o Petto responde que a pergunta dos dias foi removida](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-question-remove.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=1b86e0457b3609645b5c92aca18f2aaa)
>
> No Discord: uma pergunta removida.

> [accordion] !form questions
>
> ![liam digita !form questions staff: as seis perguntas com o tipo, se são obrigatórias, os intervalos e as opções, e que são respondidas em 2 páginas](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-questions.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=3285fbf40fcae84e41e62acccaa1be1f)
>
> No Discord: as perguntas de um formulário, em ordem.

No Discord, as perguntas aparecem em páginas de cinco, com **Próximo** entre elas. Uma resposta inválida (um número fora do intervalo, por exemplo) é oferecida de novo com o que o membro escreveu.

> [accordion] Página 1 de 2
>
> ![O formulário do Discord com as cinco primeiras perguntas respondidas: um nome, uma idade, um fuso horário, os dias e Sim](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-modal.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=b47fab8d4492cfcda24e5fbf24784472)
>
> No Discord: a primeira página de um formulário de seis perguntas.

> [accordion] Próxima
>
> ![O Petto responde só para o membro que a página 1 de 2 foi salva, com os botões Próxima e Parar](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-modal-next.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=ab0c74e295f4d163082052d89b996751)
>
> No Discord: a página 1 salva, Próxima abre a página 2.

> [accordion] Uma resposta errada
>
> ![O Petto responde que algumas respostas precisam de ajuste: a idade precisa de um número de 13 a 99, com os botões Corrigir minhas respostas e Parar](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-modal-fix.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=29e3d47bd9d9858c5a3fdac7c1392232)
>
> No Discord: uma idade fora do intervalo é oferecida de novo.

> [accordion] Enviado
>
> ![O Petto responde só para o membro que as respostas foram enviadas (#13) e que uma DM vai trazer o resultado](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-submitted.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=20128c7cb67c4c80be86df93ea5f0f11)
>
> No Discord: a última página envia o formulário.

## Configurações

`!form set <form> <setting> <value>` muda uma configuração. `none` (ou `off`) a limpa.

![liam digita !form set staff color #ff91c2 e o Petto responde que color de staff foi salvo](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-set.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=dbfab28cf250603663b280c361ac03a1)

No Discord: uma configuração mudada.

![liam digita !form set staff colour e o Petto responde com todas as configurações que podem ser mudadas](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-set-unknown.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=5afffa60fcfffe43d2782929bd245232)

No Discord: uma configuração que o Petto não conhece lista as que ele conhece.

| Configuração | O que faz |
| - | - |
| `title`, `description`, `color` | O que o membro lê, e a cor do card e da página web (`#ff91c2`) |
| `channel` | Onde os cards chegam |
| `reviewers` | Cargos que podem aceitar e recusar este formulário, além de quem gerencia o servidor |
| `ping` | Cargos mencionados quando chega uma resposta (até 5) |
| `thread` | `on` abre um tópico embaixo de cada card |
| `required-roles` / `blocked-roles` | Quem pode e quem não pode preencher |
| `account-age` / `server-age` | Mínimo de dias da conta, ou no servidor (`7`, `7d`, `2 weeks`) |
| `one-pending` | `on`: uma resposta esperando por vez para cada membro |
| `cooldown` | Horas que um membro espera depois de uma recusa (`36`, `36h`, `2d`) |
| `max-per-user` / `max-total` | Quantas vezes um membro, ou todos juntos, podem enviar |
| `closes` | Uma data (`2026-12-31`) ou um tempo a partir de agora (`3d`) em que ele para de aceitar respostas |
| `accept-roles` / `accept-remove-roles` | Cargos dados e retirados quando uma resposta é aceita |
| `deny-roles` / `deny-remove-roles` | Cargos dados e retirados quando uma resposta é recusada |
| `dm` | `off` para não enviar DM com o resultado |
| `button-label`, `button-emoji`, `button-style` | O botão do painel (`primary`, `secondary`, `success` ou `danger`) |
| `web` | `off` mantém o formulário só no Discord |
| `banner`, `background`, `server-icon`, `server-name`, `branding` | O visual da [página web](#a-página-web) |

O Petto nunca tenta dar um cargo acima do dele ou um gerenciado por um app: em vez disso, ele avisa no card.

## Mensagens para o membro

`!form message <form> <kind> <text>` muda o que é dito ao membro:

* `submitted`: quando as respostas são enviadas.
* `accepted` e `denied`: a DM com o resultado.

![Uma DM do Petto: as respostas no Petto Land foram aceitas, com o motivo embaixo](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-dm-accepted.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=4cfa79782f53749555995b36a4cf5f5e)

No Discord: a DM de uma resposta aceita, com o motivo.

Como toda DM do Petto, esta começa com uma linha cinza `De <servidor>` e tem botões de info, apagar e denunciar: veja [DMs do Petto](https://wiki.petto.sbs/pt-br/moderation/dms-from-petto.md).

O texto aceita `{form}` (o título), `{number}`, `{server}`, `{status}` e `{reason}`, e também as [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) de sempre, então `{user}` menciona o membro. Um motivo deixado vazio simplesmente desaparece. `reset` volta ao padrão. Dá para usar um embed salvo no lugar com `--template <name>`, e ele aceita `{form.name}`, `{form.title}`, `{form.number}`, `{form.status}` e `{form.reason}`. Veja [Embeds](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md).

```javascript Exemplo theme={null}
!form message staff accepted "Boas-vindas à equipe, {user}! Leia o #regras-da-equipe primeiro."
!form message staff denied --template staff-denied
```

> [accordion] !form message staff accepted
>
> ![liam digita !form message staff accepted com um texto que usa \{user} e o Petto responde Mensagem salva](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-message.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=648cdd2efa7c6586f586881e60b55d73)
>
> No Discord: a DM das respostas aceitas, mudada.

> [accordion] !form message staff submitted
>
> ![liam digita !form message staff submitted e o Petto mostra a mensagem que o membro lê ao enviar](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-message-show.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=fd7646d76e0ddb1414e0591acd4b5f8c)
>
> No Discord: sem texto, a mensagem em uso.

## Revisando

Cada card tem todas as respostas (respostas longas são cortadas no card e vão inteiras em um arquivo), a idade da conta e quando o membro entrou, e os botões:

* **Aceitar** e **Recusar** (com um motivo opcional que o membro lê). Os cargos do formulário são dados e retirados, o membro recebe uma DM e a categoria `forms` do [log](https://wiki.petto.sbs/pt-br/moderation/logging.md) ganha uma linha.
* **Abrir tópico** abre um tópico embaixo do card para conversar sobre a resposta.

![O cartão da resposta 12 do formulário Candidatura para a staff, enviada pela web, que menciona Moderadores, com cada resposta e os botões Aceitar, Recusar, Abrir tópico e Painel web](https://mintcdn.com/wikipetto/LoL7QuPJ71yd9F_N/images/discord/community/pt-br/forms.webp?fit=max\&auto=format\&n=LoL7QuPJ71yd9F_N\&q=85\&s=28d68349784a3a93d1b42c245421975c)

No Discord: uma candidatura para a staff como chega no canal de revisão.

> [accordion] Aceitar
>
> ![O formulário Aceitar #12 com um motivo opcional que o membro lê na DM](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-accept-modal.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=e6ab2e7c433edf03fed531fc2c14ce84)
>
> No Discord: Aceitar pede um motivo opcional.

> [accordion] O card depois
>
> ![O card da resposta 12 agora verde: aceito por kira com o motivo e +Ajudantes, os botões desligados; o Petto responde só para kira que foi aceito](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-accepted.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=7ecb8a38fe9f8df63e193d0882e39846)
>
> No Discord: o card, aceito, e a resposta para quem revisou.

> [accordion] !form accept
>
> ![kira digita !form accept 12 com um motivo e o Petto responde que a resposta 12 de mia.draws foi aceita, Cargos: +Ajudantes](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-accept.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=e94769546c059d0ec3ab4b6e06606f0a)
>
> No Discord: uma resposta aceita com um comando.

> [accordion] !form deny
>
> ![kira digita !form deny 10 com um motivo e o Petto responde que a resposta 10 de jellybean foi recusada](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-deny.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=02060191e00c1028469caa0545cd00d2)
>
> No Discord: uma resposta recusada com um motivo.

Quando uma resposta é aceita ou recusada (pelo card, por `!form accept|deny` ou pelo dashboard), o tópico do card recebe uma última mensagem com o resultado, o motivo e quem decidiu, e é **trancado e arquivado**. Ninguém é mencionado.

![No tópico da resposta 12 o Petto escreve que kira aceitou e que o tópico foi fechado, com o motivo](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-thread-closed.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=d1c2369c7f3e29bb37ed1706693c3d6f)

No Discord: a última mensagem do tópico de uma resposta aceita.

`!form submissions [form] [status]` lista o que chegou (pendentes por padrão; também `accepted`, `denied`, `cancelled` ou `all`), e `!form view <number>` mostra um card de novo com os botões.

> [accordion] !form submissions
>
> ![kira digita !form submissions: 12, 11 e 10, pendentes, com quem enviou, o formulário, quando e um link para cada card](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-submissions.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=cfeb9b12b7f7ab3184f40f91eb87d2fe)
>
> No Discord: as respostas esperando a equipe.

> [accordion] !form view
>
> ![kira digita !form view 12 e o Petto mostra o card da resposta 12 com todas as respostas, pendente, e os botões Aceitar, Recusar, Tópico e Painel](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-view.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=7eb3bdfd583fe6581996067436d4a260)
>
> No Discord: um card mostrado de novo com os botões.

## A página web

Todo formulário também tem a sua própria página na web, ativada por padrão. O membro entra com o Discord, vê o título, a descrição e todas as perguntas, e envia as respostas. Elas passam pelas mesmas verificações do Discord (cargos, idades, limites) e chegam como o mesmo card, que diz que foi enviado pela web. A página fala o [idioma](https://wiki.petto.sbs/pt-br/setup/language.md) do servidor.

* `!form info <form>` dá o link, `petto.sbs/form/<id>`, em que o id são 12 letras e números aleatórios (`/es/form/<id>` e `/pt-br/form/…` o abrem em espanhol ou em português). Colado no Discord ou em outros apps, ele mostra uma prévia com o título, a descrição e o banner do formulário. Os links antigos `petto.sbs/form#…` e `petto.sbs/f/…` continuam funcionando.
* Os links são aleatórios, então ninguém consegue adivinhá-los. `!form relink <form>` cria um novo, e **o antigo deixa de funcionar na hora**. Os painéis publicados antes continuam com o link antigo, então publique-os de novo.
* `!form set <form> web off` mantém um formulário só no Discord.

> [accordion] !form info
>
> ![liam digita !form info staff: o link na web, a aparência da página, o canal e os cargos de revisão, quem pode preencher, o que acontece depois da revisão e os números](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-info.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=b6f3b799dfb043144fd4d50a9155933b)
>
> No Discord: tudo sobre um formulário, com o link.

> [accordion] !form relink
>
> ![liam digita !form relink staff e o Petto responde com o link novo e que o antigo não funciona mais](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-relink.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=7d3935f8b7e52b5d50a8535988d83dee)
>
> No Discord: um link novo; o antigo para de funcionar.

![A página web do formulário Staff application do Petto Land, com as primeiras perguntas](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/form-page.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=026df65423169ba7dc534d04c40cdc64)

A página de um formulário no petto.sbs, com o fundo animado aurora (Premium).

A página usa o visual do formulário:

```javascript Exemplo theme={null}
!form set staff color #ff91c2
!form set staff banner https://example.com/staff-banner.png
!form set staff background gradient
!form set staff server-icon off
```

* **Cor**: o destaque da página (botões, links, números).
* **Banner**: uma imagem em cima (um link `https` para um `.png`, `.jpg`, `.gif` ou `.webp`).
* **Fundo**: `default` (o do Petto), `solid` (um tom da cor) ou `gradient`. Com o [Premium](https://wiki.petto.sbs/pt-br/overview/premium.md) há também dois animados, `aurora` e `waves`, feitos a partir da cor do formulário; eles se movem devagar e ficam parados para visitantes cujo dispositivo pede menos movimento.
* **Ícone do servidor** e **nome do servidor** no cabeçalho; cada um pode ser escondido.
* **Marca**: com o Premium, `!form set <form> branding off` esconde a linha pequena "Formulários por Petto" no fim da página.

Os fundos animados e `branding off` são as únicas partes Premium dos formulários. Quando o Premium acaba, a página volta a mostrar o gradiente normal e a linha, e nada mais muda.

No dashboard, o editor de formulários tem uma seção **Página web** com as mesmas opções, o link com **Copiar** e **Novo link**, e uma prévia ao vivo da página e da aba do navegador.

![A seção Página web com o link do formulário, o fundo animado Aurora e uma prévia da página](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/forms-web-page.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=de72db25002d3a97cf1ec7cd5f6a6679)

A seção Página web do editor de formulários: o link, o banner, o fundo e o que o cabeçalho mostra.

A seção **Prévia do link** muda como o link aparece quando é colado: título, descrição, imagem e cor lateral próprios, e uma opção para mostrar a imagem pequena. Os campos vazios usam o título, a descrição, o banner e a cor do formulário. O Discord guarda a prévia por um tempo, então um link colado antes de uma mudança ainda pode mostrar a antiga.

![A seção Prévia do link com um título, uma descrição, uma cor lateral e a prévia no Discord](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/forms-link-preview.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=27385b85d322922305afd3249591e02e)

A seção Prévia do link, com o card que o Discord mostra quando o link é colado.

## Armazenamento e limites

Todo servidor tem os mesmos limites para formulários, com ou sem Premium: até 25 formulários de até 25 perguntas, e 2.000 respostas guardadas. Quando um servidor está cheio, as respostas revisadas mais antigas abrem espaço; as respostas que ainda estão pendentes nunca são apagadas.

`!form retention <days>` (1 a 365, 30 por padrão) diz por quanto tempo as respostas de envios revisados são guardadas. Depois disso fica só uma linha pequena: o formulário, o membro, o estado, quem revisou, as datas e o link para o card.

![liam digita !form retention 60 e o Petto responde que as respostas revisadas ficam 60 dias, com quantas estão guardadas](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-retention.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=34e02de4a01ecf7fb6d41eebd34918bf)

No Discord: quanto tempo as respostas revisadas ficam guardadas.

## Dashboard

![O editor do formulário Staff application com a prévia](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/forms-editor.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=af437153f6ec9d5934542af023753c20)

O editor de formulários: o básico à esquerda e uma prévia do painel e do formulário do Discord à direita.

**Dashboard → Formulários** tem três páginas:

* **Formulários**: crie e edite formulários, as perguntas (com a descrição e a imagem), as regras, os cargos, as mensagens e a página web.
* **Respostas de formulários**: as respostas por formulário e estado, com busca, e **Aceitar** e **Rejeitar**.
* **Painéis de formulários**: publique um painel com botões ou um menu.

> [accordion] Formulários
>
> ![A página Formulários com dois formulários abertos e a inscrição da noite de jogos fechada, cada um com as respostas pendentes e Editar, Fechar ou Abrir e Duplicar](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/forms-dash-list.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=fd6166fa4c17b9c7150b2bd4337bc5fc)
>
> Dashboard → Formulários → Formulários: os formulários do servidor.

> [accordion] Respostas de formulários
>
> ![A página Respostas de formulários em Pendentes com as respostas 12, 11 e 10, os filtros e o card Armazenamento com 24 de 2000 guardadas e 30 dias](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/forms-dash-submissions.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=007055df6570848ccddf888f2f70ff84)
>
> Dashboard → Formulários → Respostas de formulários: as respostas pendentes e o armazenamento.

> [accordion] Painéis de formulários
>
> ![A página Painéis de formulários com o formulário Publicar um painel e dois painéis publicados, em #inscricoes e #general](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/forms-dash-panels.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=f5fc6e6077fae46b440261cac5fd2d4a)
>
> Dashboard → Formulários → Painéis de formulários: publicar um painel e os painéis publicados.

Os membros com um cargo que recebeu acesso à parte Comunidade do dashboard também podem usar esta página; veja [Acesso ao painel](https://wiki.petto.sbs/pt-br/setup/dashboard-access.md).

## Problemas comuns

> [accordion] Os membros dizem que o formulário não está pronto
>
> O formulário não tem canal de revisão. Defina um com `!form set <form> channel #canal`.
>
> ![Abaixo do painel o Petto responde só para o membro que o formulário não está pronto porque a equipe não escolheu para onde vão as respostas](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-not-ready.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=5f17f133232c1d0c5f02703d676132a4)
>
> No Discord: um membro aperta o botão de um formulário sem canal de revisão.

> [accordion] O botão do painel não faz nada
>
> O formulário está fechado. Abra-o com `!form open <form>`. `!form panel` lembra quais formulários do painel estão fechados.
>
> ![Abaixo do painel o Petto responde só para o membro que o formulário está fechado](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-closed.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=21da92579c499349ec558d7a0f644d5d)
>
> No Discord: um membro aperta o botão de um formulário fechado.

> [accordion] Um link web antigo não abre
>
> O formulário ganhou um novo link. Use o link novo do `!form info` e publique os painéis de novo.

> [accordion] Um cargo não foi dado
>
> O cargo está acima do cargo mais alto do Petto ou é gerenciado por um app. Mova o cargo do Petto para cima dele; veja [Problemas de permissão](https://wiki.petto.sbs/pt-br/common-issues/permissions.md).
>
> ![kira aceita a resposta 12 e o Petto responde que não conseguiu mudar o cargo Admin, que está acima do dele](https://mintcdn.com/wikipetto/9BKGsKMxfvX24pve/images/discord/community/pt-br/forms-role-not-given.webp?fit=max\&auto=format\&n=9BKGsKMxfvX24pve\&q=85\&s=ef3490b445eebd74baf007b731a54d36)
>
> No Discord: um cargo acima do cargo do Petto não é dado.


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