> For the complete documentation index, see [llms.txt](https://ticketking.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ticketking.xyz/docs/pt-br/aplicacoes/designing-your-application.md).
# Projetando seu aplicativo
O editor da opção de aplicação usa um layout plano, com todos os campos em uma única página. As opções de ticket usam, em vez disso, as abas Geral, Mensagens e Avançado.
Este passo a passo vai de cima para baixo.
## Tipo de aplicação
Um rótulo de texto, com até **50 caracteres**.
Este é o título do formulário que os membros veem quando clicam no botão de se candidatar. Exemplos são "Candidatura da Equipe", "Candidatura de Parceiro" e "Solicitação de Cargo".
É obrigatório. O painel o marca com um asterisco e não permitirá que você salve a opção até preenchê-lo.
## Canal de registro
É obrigatório. Sem ele, ninguém pode analisar as submissões.
É um seletor de canal. Ele define onde as candidaturas enviadas são postadas como embeds, com botões Aprovar e Recusar. Você pode configurá-lo para herdar o padrão do painel ou substituí-lo.
Se o padrão do painel não estiver definido e isto estiver configurado para herdar, você verá uma nota de que nenhum padrão de painel foi definido, de que esta opção deve ser substituída e de que, caso contrário, as candidaturas não poderão ser enviadas. Defina o canal e depois salve.
## Perguntas da Aplicação
Até **5 perguntas** no plano gratuito, ou até **100** no Premium. Isso usa o mesmo sistema de formulário que os formulários de ticket.
→ [Tipos de pergunta](/docs/pt-br/formularios/question-types.md)
O título do formulário é o Tipo de aplicação acima. O corpo são suas perguntas.
## Requisitos de elegibilidade
Bloqueie candidaturas de contas que não se qualificam, antes que elas iniciem o formulário.
| Campo | Tipo | Intervalo | Padrão |
| --------------------------------------------------- | ------ | --------- | ------------------- |
| **Idade mínima da conta (dias)** | número | 0 a 365 | Nenhum (desativado) |
| **Tempo mínimo de participação no servidor (dias)** | número | 0 a 365 | Nenhum (desativado) |
Se um membro não cumprir uma regra, ele recebe uma mensagem de bloqueio que informa a regra não cumprida e o número de dias exigido:
* Conta muito nova: uma mensagem de que a conta do Discord dele deve ter pelo menos N dias para enviar uma candidatura.
* Tempo insuficiente no servidor: uma mensagem de que ele deve ser membro do servidor por pelo menos N dias para enviar uma candidatura.
## Configurações de reaplicação
O que acontece se a candidatura de um membro for decidida e ele quiser se candidatar novamente.
| Campo | Tipo | Comportamento |
| ---------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Permitir reaplicação** | alternância (padrão ativada) | Quando desativado, um membro que enviou uma vez não pode enviar novamente de forma alguma, e o tempo de espera não importa. |
| **Período de espera (dias)** | número, de 0 a 365 | Mostrado apenas quando Permitir reaplicação está ativado. Após uma decisão, o membro deve aguardar esta quantidade de dias antes de enviar outra candidatura para a mesma opção. |
Uma configuração comum é manter Permitir reaplicação ativado com um tempo de espera de 7 dias. Isso dá aos candidatos sérios uma chance de voltar sem permitir spam.
## Cargos concedidos
Um seletor de vários cargos. Quando uma candidatura é aprovada, o Ticket King adiciona esses cargos ao candidato.
Padrões comuns:
* Candidatura da equipe: conceda o cargo "Equipe" ou "Moderador".
* Candidatura de parceiro: conceda "Parceiro".
* Candidatura de concessão de cargo: conceda o cargo para o qual a pessoa se candidatou.
{% hint style="warning" %}
O cargo do bot do Ticket King precisa ficar acima de todos os Cargos concedidos na lista de cargos do Discord. Se um Cargo concedido estiver acima do cargo do bot, a concessão do cargo não funcionará. Arraste o Ticket King para cima em **Configurações do servidor, Cargos**.
{% endhint %}
## Cargos a remover
Um seletor de vários cargos. Quando uma candidatura é aprovada, o Ticket King remove esses cargos do candidato. É o oposto de Cargos concedidos, e os dois funcionam juntos em uma única etapa.
Um uso comum é um cargo de retenção "candidato" ou "pendente". Quando alguém se candidata, recebe o cargo de retenção e, quando você o aprova, o Ticket King remove o cargo de retenção e adiciona o novo cargo ao mesmo tempo.
O cargo do bot precisa ficar acima de todos os cargos listados aqui, assim como em Cargos concedidos.
## Cargos de revisor
Um seletor de vários cargos. Apenas membros com pelo menos um desses cargos podem aprovar ou recusar candidaturas com os botões do canal de log.
Isso é separado das permissões do painel. Para agir sobre as candidaturas, um revisor precisa de um destes:
* Pelo menos um destes cargos de revisor, para usar os botões do canal de log.
* A permissão do painel Revisar candidaturas, para aprovar ou recusar pelo painel. O proprietário do servidor e qualquer pessoa com Administrador ou Gerenciar Servidor também podem fazer isso.
A maioria dos servidores usa o mesmo cargo para ambos.
## Cargos obrigatórios (Premium)
Um seletor de vários cargos que pode herdar o padrão do painel ou ser substituído. O candidato deve ter pelo menos um desses cargos para enviar. Este é um :crown: recurso Premium.
## Cargos bloqueados (Premium)
Um seletor de vários cargos que pode herdar o padrão do painel ou ser substituído. Membros com qualquer um desses cargos não podem enviar. Este é um :crown: recurso Premium.
Sua configuração de Cargos bloqueados para todo o servidor também se aplica aqui, e ela bloqueia todos os comandos, não apenas esta opção.
## Notificações
| Campo | Tipo | Comportamento |
| ---------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enviar resultado por DM ao candidato** | alternância (padrão ativada) | Quando ativado, o Ticket King envia uma DM ao candidato após a decisão. A DM inclui o tipo de aplicação, o status (aprovada ou recusada) e o **motivo** que o revisor digitou no pop-up de decisão. |
Não há mensagens separadas de aceite e recusa. Um único toggle controla se uma DM é enviada, e o conteúdo é montado a partir do motivo e do status informados pelo revisor.
Se o candidato tiver as DMs desativadas, a DM não será entregue. A decisão ainda é registrada.
## Status da opção
Ativada ou desativada. Liga ou desliga esta opção sem remover o painel inteiro.
## Salvar
O painel mostra uma barra de alterações não salvas na parte inferior quando você edita algo. Clique **Salvar** para aplicar suas alterações. O editor não salva automaticamente, então você precisa salvar manualmente.
## Relacionados
{% content-ref url="/pages/eefdaa99b5a8756395bc45fb13e0b49436035a7b" %}
[A página de Aplicações](/docs/pt-br/aplicacoes/the-applications-page.md)
{% endcontent-ref %}
{% content-ref url="/pages/0eb92eba8d202851ace03ccb68ae5c74fc4b3018" %}
[Limites e restrições de aplicações](/docs/pt-br/aplicacoes/limits-and-constraints.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ticketking.xyz/docs/pt-br/aplicacoes/designing-your-application.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.