# Formulários

Crie painéis no Discord que abrem uma janela de perguntas e receba as respostas para a equipe aprovar ou recusar.

Source: https://fivedash.fivex.gg/docs/pt/discord/forms

Os formulários são a recepção da sua cidade para pedidos que precisam de uma decisão: candidatura para a staff, denúncia, parceria, inscrição em evento. Cada formulário é um painel fixo num canal do Discord com um botão; o botão abre uma janela de perguntas e cada resposta chega num canal da equipe com **Aprovar** e **Recusar**. O membro recebe o resultado no privado. Esta página é para donos e staff que montam e analisam formulários em **Discord → Formulários**.

## Antes de começar

* O módulo **Discord** precisa estar no plano da organização e o bot precisa estar conectado ao servidor do Discord (veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot)).
* Os formulários estão em todos os planos. O número de formulários por bot muda com o plano:

| Plano | Formulários por bot |
| ----- | ------------------- |
| Plus  | 3                   |
| Pro   | 10                  |
| Ultra | 25                  |

### Nível de acesso por ação

| Ação                                                                      | Nível na área **Formulários** |
| ------------------------------------------------------------------------- | ----------------------------- |
| Ver os formulários, os números e as respostas                             | **Ver**                       |
| Aprovar e recusar respostas pelo painel                                   | **Gerenciar**                 |
| Criar, editar, ligar, desligar e excluir formulários, painéis e mensagens | **Configurar**                |

Os níveis são dados em **Configurações → Membros** (veja [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)).

> No Discord, quem decide é quem tem um dos cargos de **Quem decide**. Administradores do servidor e quem tem **Gerenciar servidor** sempre podem.

## A página Formulários

Em **Discord → Formulários** você vê:

* **Números de todos os formulários**: **Respostas** (comparadas com os 7 dias anteriores), **Aguardando a equipe**, **Aprovação** (30 dias) e **Tempo até decidir** (mediana dos últimos 30 dias).
* **Seus formulários**: cada um com a situação (**No ar**, **Sem painel** ou **Desligado**), o gráfico de **14 dias**, a última resposta, a aprovação e quantas respostas aguardam.
* **Começar de um modelo**: atalhos para criar um formulário pronto.

## Criar um formulário

### Abra Formulários

Vá em **Discord → Formulários** e clique em **Novo formulário** (ou em **Usar modelo →** num dos modelos).

### Escolha o modelo e o nome

Escolha o **Modelo** e escreva o **Nome**. Clique em **Criar formulário**.

### Ajuste as perguntas

O formulário abre na aba **Formulário** (o construtor). Edite, adicione ou tire campos e clique em **Salvar**.

### Escolha os canais

Na aba **Configurações**, escolha o **Canal do painel** e o **Canal das respostas**.

### Ligue o formulário

Ligue o interruptor **Ligar o formulário** no topo e clique em **Salvar**. O aviso **Painel publicado** confirma o canal.

> O formulário nasce desligado: nada aparece no Discord até você ligar e salvar. Ligado e salvo, o painel é postado (ou atualizado) sozinho. Desligado e salvo, o painel sai do Discord.

### Modelos

| Modelo                       | O que traz                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Candidatura para a staff** | Nome e idade, por que quer entrar, tempo de jogo por dia, áreas em que quer ajudar e a confirmação das regras da staff.        |
| **Denúncia**                 | Quem você quer denunciar (membro do servidor), o que aconteceu (lista), o relato e as provas (até 5 arquivos). Botão vermelho. |
| **Pedido de parceria**       | Perguntas para organizações, criadores e lojas que querem parceria. Botão verde.                                               |
| **Em branco**                | Um campo de texto curto, para começar do zero.                                                                                 |

## As abas de um formulário

| Aba               | O que tem                                                                             |
| ----------------- | ------------------------------------------------------------------------------------- |
| **Respostas**     | Os números do formulário e a lista de respostas, com busca e filtro. Abre por padrão. |
| **Formulário**    | O construtor da janela: título, introdução e campos, com a prévia no Discord.         |
| **Configurações** | Canais, quem pode responder, análise, resultado, registro, mensagens e embed.         |

No topo ficam **Voltar para os formulários**, a situação (**No ar em #canal**, **Ligado, painel não publicado** ou **Desligado**), **Ver painel**, o interruptor **Ligar o formulário** e **Mais opções do formulário** (com **Excluir formulário**).

## Montar a janela (aba Formulário)

### Janela

| Campo          | O que faz                                                                                         | Limite          |
| -------------- | ------------------------------------------------------------------------------------------------- | --------------- |
| **Título**     | O título da janela que abre no Discord. Obrigatório.                                              | 45 caracteres   |
| **Introdução** | Opcional. Um aviso no topo da janela. Aceita **negrito** e links. Ocupa um dos 5 itens da janela. | 1000 caracteres |

> O Discord mostra até 5 itens na janela. A introdução conta como um. Se passar disso, o construtor avisa **A janela está cheia** e não deixa salvar.

### Tipos de campo

Clique em **Adicionar campo** e escolha o tipo:

| Tipo                   | Para que serve                     | Limites                       |
| ---------------------- | ---------------------------------- | ----------------------------- |
| **Texto curto**        | Uma linha: nome, idade, ID.        | Até 400 letras (padrão 200)   |
| **Texto longo**        | Respostas com várias linhas.       | Até 4000 letras (padrão 1000) |
| **Escolha única**      | Bolinhas: a pessoa marca uma.      | De 2 a 10 opções              |
| **Múltipla escolha**   | Caixinhas: marca quantas quiser.   | Até 10 opções                 |
| **Lista de opções**    | Menu que abre.                     | Até 25 opções                 |
| **Confirmação**        | Uma caixinha, como “Li as regras”. | —                             |
| **Membro do servidor** | Escolhe alguém do Discord.         | Até 10 membros                |
| **Arquivos**           | Prints, vídeos ou documentos.      | Até 10 arquivos               |

### Configurações de cada campo

Clique num campo na lista ou na prévia para editar. Use **Subir** / **Descer** para mudar a ordem, **Duplicar campo** e **Excluir campo**.

| Campo                                           | O que faz                                                                                                                                 | Vale para                               |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| **Tipo do campo**                               | Troca o tipo.                                                                                                                             | Todos                                   |
| **Pergunta**                                    | O texto em cima do campo. Obrigatório (até 45 caracteres).                                                                                | Todos                                   |
| **Descrição**                                   | Texto pequeno embaixo da pergunta (até 100). Opcional.                                                                                    | Todos                                   |
| **Texto de exemplo**                            | Aparece apagado dentro do campo, antes de a pessoa responder (até 100).                                                                   | Texto curto, texto longo, lista, membro |
| **Obrigatório**                                 | O Discord não deixa enviar sem responder. Na **Confirmação**, a pessoa só envia marcando a caixa (ex.: aceitar as regras). Padrão ligado. | Todos                                   |
| **Texto da caixa**                              | O que a pessoa confirma ao marcar. Padrão: “Sim, concordo”.                                                                               | Confirmação                             |
| **Mínimo de letras** / **Máximo de letras**     | Tamanho da resposta.                                                                                                                      | Texto curto, texto longo                |
| **Opções**                                      | Cada opção tem nome e **Descrição (opcional)** (até 100 cada). Não pode ter opção vazia nem repetida.                                     | Escolha única, múltipla escolha, lista  |
| **Mínimo de escolhas** / **Máximo de escolhas** | Quantas opções a pessoa marca.                                                                                                            | Múltipla escolha, lista                 |
| **Até quantos membros**                         | Quantas pessoas podem ser escolhidas.                                                                                                     | Membro do servidor                      |
| **Até quantos arquivos**                        | Quantos arquivos podem ser enviados.                                                                                                      | Arquivos                                |

Os arquivos enviados ficam guardados pelo FiveDash, então o card da resposta continua abrindo mesmo depois que o link do Discord expira. Arquivos de formato ou tamanho que não dá para guardar aparecem como **não guardado (formato ou tamanho)**.

## Configurações

### Painel

| Campo               | O que faz                                                                           | Padrão                       |
| ------------------- | ----------------------------------------------------------------------------------- | ---------------------------- |
| **Nome**            | Como a equipe vê o formulário no painel e nos registros (até 60). Obrigatório.      | O nome que você deu ao criar |
| **Canal do painel** | O painel fica fixo aqui, com o botão que abre o formulário. Obrigatório para ligar. | Nenhum                       |

### Quem pode responder

| Campo                         | O que faz                                                                                              | Padrão              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------- |
| **Cargos**                    | Só quem tem um desses cargos abre o formulário. Sem cargos, qualquer membro.                           | **Qualquer membro** |
| **Uma resposta por vez**      | Quem tem uma resposta esperando a equipe não manda outra.                                              | Ligado              |
| **Intervalo entre respostas** | Quanto tempo a pessoa espera para responder de novo: 5 min, 30 min, 1 h, 6 h, 1 dia, 3 dias ou 7 dias. | **Sem intervalo**   |
| **Só até ser aprovado**       | Depois de uma resposta aprovada, a pessoa não responde mais esse formulário.                           | Desligado           |

### Análise

| Campo                             | O que faz                                                                                                        | Padrão                 |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------- |
| **Canal das respostas**           | Cada resposta chega aqui, com os botões **Aprovar** e **Recusar**. Obrigatório para ligar.                       | Nenhum                 |
| **Quem decide**                   | Quem tem um desses cargos aprova e recusa pelo Discord. Administradores e quem gerencia o servidor sempre podem. | **Só administradores** |
| **Avisar cargos**                 | Esses cargos são marcados a cada resposta nova.                                                                  | **Ninguém**            |
| **Motivo obrigatório ao recusar** | A equipe só recusa escrevendo o porquê, que vai para o membro.                                                   | Ligado                 |

### Resultado

| Campo                           | O que faz                                                             | Padrão    |
| ------------------------------- | --------------------------------------------------------------------- | --------- |
| **Cargo ao aprovar**            | Quem tem a resposta aprovada ganha esse cargo.                        | Nenhum    |
| **Avisar o resultado**          | O membro recebe no privado se foi aprovado ou recusado, com o motivo. | Ligado    |
| **Copiar no privado ao enviar** | Além da confirmação na hora, a pessoa recebe uma cópia na DM.         | Desligado |

### Registro no Discord

| Campo                 | O que faz                                                                       | Padrão           |
| --------------------- | ------------------------------------------------------------------------------- | ---------------- |
| **Canal do registro** | Cada resposta nova, aprovação e recusa desse formulário vira uma mensagem aqui. | **Só no painel** |

Todas as respostas e decisões também ficam na aba **Respostas**, com a linha do tempo de cada uma.

## Personalizar mensagens e embed

Na aba **Configurações**, o cartão de personalização tem **Mensagens** (painel, botão, confirmação e resultado) e **Embed** (cores, servidor, miniatura e rodapé).

### Mensagens

| Aba           | Campo                               | O que faz                                                                                                                           | Padrão                                    |
| ------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| **Painel**    | **Título**                          | O título do painel (até 256).                                                                                                       | Formulário                                |
| **Painel**    | **Texto**                           | O texto do painel (até 2000).                                                                                                       | Clique no botão abaixo para responder…    |
| **Painel**    | **Botão**                           | O botão que abre o formulário (até 80), com **Emoji do botão** e **Cor do botão** (**Azul**, **Cinza**, **Verde** ou **Vermelho**). | Responder, **Azul**                       |
| **Painel**    | **Imagem**                          | Opcional. Larga (2:1), no fim do painel.                                                                                            | Nenhuma                                   |
| **Ao enviar** | **Logo depois de enviar**           | Só quem respondeu vê. Com **Copiar no privado ao enviar** ligado, vai também na DM (até 1500).                                      | Recebemos sua resposta, `{membro}`! …     |
| **Aprovada**  | **DM quando a resposta é aprovada** | `{motivo}` é a mensagem que a equipe escreveu ao aprovar (até 1500). Com imagem opcional (2:1).                                     | Resposta aprovada…                        |
| **Recusada**  | **DM quando a resposta é recusada** | `{motivo}` é o motivo que a equipe escreveu ao recusar (até 1500). Com imagem opcional (2:1).                                       | Resposta recusada… **Motivo:** `{motivo}` |

As imagens são PNG, JPG, WebP ou GIF de até 1 MB.

### Variáveis

| Variável       | O que vira                         |
| -------------- | ---------------------------------- |
| `{membro}`     | Marca quem respondeu               |
| `{nome}`       | O nome de quem respondeu           |
| `{servidor}`   | O nome do servidor do Discord      |
| `{formulario}` | O nome do formulário               |
| `{numero}`     | O número da resposta (#0012)       |
| `{motivo}`     | O que a equipe escreveu ao decidir |
| `{equipe}`     | Quem decidiu                       |

### Embed

| Campo                            | O que faz                                                      | Padrão             |
| -------------------------------- | -------------------------------------------------------------- | ------------------ |
| **Cor** (aba **Painel e novas**) | O painel, a resposta enquanto espera e a confirmação de envio. | Cor do bot         |
| **Cor** (aba **Aprovada**)       | A resposta aprovada no canal da equipe, a DM e o registro.     | Verde (#57F287)    |
| **Cor** (aba **Recusada**)       | A resposta recusada no canal da equipe, a DM e o registro.     | Vermelho (#ED4245) |
| **Servidor no topo**             | O nome e o ícone do servidor em cima do painel e das DMs.      | Ligado             |
| **Miniatura do painel**          | Opcional. Quadrada, no canto do painel.                        | Nenhuma            |
| **Rodapé do painel**             | Opcional (até 200).                                            | Vazio              |

## Como funciona no Discord

1. O membro clica no botão do painel. O bot confere se ele pode responder (cargo, resposta esperando, intervalo, já aprovado). Se não puder, ele recebe um aviso só para ele.
2. A janela abre com os campos. Ao enviar, ele vê a mensagem de **Logo depois de enviar**.
3. A resposta chega no **Canal das respostas** como um card, com **Aprovar** e **Recusar**, marcando os cargos de **Avisar cargos**.
4. Quem decide clica num botão. Abre uma janela com **Mensagem para o membro** (opcional, ao aprovar) ou **Motivo da recusa** (obrigatório se **Motivo obrigatório ao recusar** estiver ligado).
5. O card é atualizado com a decisão, o cargo de **Cargo ao aprovar** é dado, o membro recebe a DM (com **Avisar o resultado** ligado) e o registro é postado.

Cada resposta é decidida uma vez só. Se duas pessoas clicarem, a segunda vê quem já decidiu.

## Analisar respostas pelo painel

### Abra as respostas

Em **Discord → Formulários**, clique no formulário. A aba **Respostas** abre por padrão.

### Encontre a resposta

Filtre por **Aguardando**, **Aprovadas** ou **Recusadas**, ou use **Buscar por membro, número, ID ou qualquer resposta**. Clique na resposta.

### Decida

Clique em **Aprovar** ou **Recusar**. Escreva a **Mensagem para o membro (opcional)** ou o **Motivo da recusa** e confirme em **Aprovar resposta** ou **Recusar resposta**.

O card no Discord é atualizado e o membro recebe o resultado no privado. A ficha da resposta mostra as respostas, a **Decisão** e a **Linha do tempo** (enviada, chegou para a equipe, aprovada ou recusada, resultado no privado). Use **Copiar ID do membro** e **Ver no Discord** para ir até o card.

> **Excluir formulário** tira o painel do Discord e apaga todas as respostas, com os arquivos. Para só parar de receber respostas, desligue o formulário em vez de excluir.

## Perguntas frequentes

**O membro clica no botão e recebe “Esse formulário está fechado no momento”.**
O formulário está desligado. Ligue **Ligar o formulário** e salve.

**Aparece “O painel não foi postado: o bot não vê ou não escreve no canal”.**
Dê ao cargo do bot as permissões de ver o canal e enviar mensagens nele, e salve de novo.

**Não consigo criar mais formulários.**
Você chegou no limite do plano (3 no Plus, 10 no Pro, 25 no Ultra). Exclua um formulário que não usa ou mude de plano.

**Posso decidir pelo Discord e pelo painel?**
Sim. Os dois atualizam a mesma resposta; quem decidir primeiro vale.

## Próximos passos

[Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets)Atendimento privado com a equipe, com formulário por categoria.
[Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)Perguntas, entrevistas e liberação na cidade.
[Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)Inscrições e níveis de criadores de conteúdo.
[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê à staff o nível certo em Formulários.
