Logo da L&M SYSTEMDocumentação
Sistemas

Formulário

Como o formulário funciona de ponta a ponta. Cobre a configuração, a coleta por modal ou por canal, a revisão da equipe em thread, as ações automáticas com variáveis e os relatórios de envios.

O formulário serve para qualquer cadastro ou pedido que precise de perguntas: candidatura à staff, recrutamento de organização, pedido de parceria, inscrição em evento e o que mais o seu servidor precisar. O membro clica no botão de um painel, responde às perguntas, e as respostas chegam para a sua equipe aprovar ou reprovar. Quando o membro envia, quando é aprovado e quando é reprovado, o bot pode dar cargos, mudar o apelido e mandar mensagens sozinho.

Ele vem em todo bot da L&M System, inclusive no gratuito, porque faz parte do Básico. Você pode criar quantos formulários quiser, e cada um tem as próprias perguntas, a própria revisão, as próprias ações e o próprio painel.

Não confunda com o Registro do MTA

O Registro do plano MTA (cadastro do personagem com nome, ID e até 3 perguntas extras) é outro sistema, com configuração própria. Ele está explicado na página do plano MTA. Esta página trata só do Formulário do Básico.

Conceitos

TermoO que é
FormulárioUm conjunto de perguntas com as regras de coleta, revisão e ações. Cada formulário é independente dos outros
PainelA mensagem pública com o botão que abre o formulário. Cada formulário tem um painel
EnvioO preenchimento de um membro. Fica guardado com as respostas, o status, quem revisou, o motivo da reprovação e o resultado de cada ação automática
Ação automáticaAlgo que o bot faz sozinho em um dos três momentos: ao enviar, ao aprovar ou ao reprovar

Um envio passa por estes status:

StatusQuando
PreenchendoO membro ainda está respondendo (só na coleta por canal)
AguardandoEnviado e esperando a equipe (só com revisão humana)
AprovadoA equipe aprovou, ou o formulário não tem revisão
ReprovadoA equipe reprovou
AbandonadoO membro cancelou, ficou sem responder no tempo limite ou o envio não pôde ser entregue

Configurando do zero

Toda a configuração fica em /config-bot → Atendimento → Formulário, e só quem tem Administrador no servidor abre esse painel. A primeira tela lista os formulários do servidor, 5 por página, com o botão Criar e um Configurar para cada um.

Prepare o servidor

Antes de criar o formulário, deixe pronto no Discord:

  • Um canal privado para a revisão, se a equipe for aprovar os envios. Só a equipe deve ver esse canal, porque quem vê o canal de revisão pode aprovar e reprovar (veja Revisão). O bot precisa ver o canal, enviar mensagens e criar threads nele.
  • Uma categoria, se as perguntas forem respondidas em canal. O bot cria ali um canal temporário para cada preenchimento e precisa da permissão de gerenciar canais.
  • Os cargos que o bot vai dar ou tirar, abaixo do cargo do bot na lista de cargos e com o bot tendo gerenciar cargos. Para mudar apelidos, ele precisa de gerenciar apelidos. Veja Permissões.
  • O canal do painel, onde os membros vão clicar para preencher.

Crie o formulário

Clique em Criar e preencha:

  • Nome: de 2 a 60 caracteres. Aparece no painel (se ele não tiver título próprio), na revisão e nos relatórios.
  • Forma de coleta: Modal ou Canal (veja a comparação em Coleta). Dá para trocar depois.

O formulário nasce desativado, com revisão humana, motivo obrigatório ao reprovar, sem cooldown e com 120 segundos por resposta na coleta por canal. Nada disso aparece para os membros até você ativar e publicar.

Ao abrir um formulário, o topo mostra o nome, se ele está ativo e a forma de coleta, junto com o botão Ativar/Desativar. Logo abaixo ficam as abas Geral, Perguntas, Revisão, Ações, Painel e Relatórios.

Cadastre as perguntas

Na aba Perguntas, clique em Adicionar e defina cada pergunta (veja Perguntas). A ordem da lista é a ordem em que o membro responde, e você muda essa ordem com Subir e Descer.

Defina a revisão

Na aba Revisão, escolha entre sem revisão e revisão humana e, na humana, o canal privado das threads (veja Revisão).

Configure as ações (opcional)

Na aba Ações, adicione o que o bot deve fazer ao enviar, ao aprovar e ao reprovar (veja Ações automáticas). Um formulário sem nenhuma ação funciona normalmente: as respostas só ficam registradas para a equipe.

Ative e publique o painel

  1. Clique em Ativar. O bot confere se o formulário está pronto e avisa o que falta: pelo menos uma pergunta, a categoria (na coleta por canal) e o canal de revisão (na revisão humana).
  2. Na aba Painel, defina o canal, o título (até 100 caracteres), a descrição (até 2.000) e o texto do botão (até 60). Em Imagens, dá para colocar uma imagem lateral (miniatura) e uma imagem inferior. Use o link direto da imagem, começando com https://. O bot recusa na hora de salvar o que não for um link; deixar o campo vazio remove a imagem. Um link de página (em vez do arquivo da imagem) é aceito, mas o Discord não mostra a imagem.
  3. Clique em Publicar.

Sem título, o painel usa o nome do formulário. Sem descrição, mostra "Clique no botão abaixo para preencher o formulário.". Sem texto no botão, o botão diz Preencher.

Para mudar o painel, edite e clique em Publicar de novo: o bot atualiza a mensagem que já está no canal, sem mandar outra. Ele só envia uma nova se a anterior tiver sido apagada. Para levar o painel para outro canal, troque o canal, publique e apague a mensagem antiga à mão.

Ativar, desativar e excluir

  • Desativar pausa o formulário sem apagar as configurações nem o histórico. Quem clicar no painel vê "Este formulário não está disponível." Os envios que já estão aguardando continuam na revisão e podem ser aprovados ou reprovados normalmente.
  • Excluir pede confirmação e remove o formulário e as configurações. O histórico de envios continua guardado, mas sai da tela de relatórios junto com o formulário, e os envios que estavam aguardando não podem mais ser revisados. O painel publicado não é apagado: apague a mensagem à mão. Se a ideia for só pausar, use Desativar.

Coleta: modal ou canal

A forma de coleta define como o membro responde. Ela fica em Geral → Coleta.

ModalCanal
Onde o membro respondeEm uma janela que abre por cima do DiscordEm um canal temporário e privado, criado para ele
PerguntasAté 5Até 50
Tamanho da respostaAté 4.000 caracteresUma mensagem do Discord por resposta
TempoSem limite enquanto a janela estiver abertaTempo limite por pergunta, de 15 a 900 segundos (padrão 120)
Precisa deNada além das perguntasUma categoria onde o canal é criado
Indicado paraFormulários curtos, como pedido de parceria ou inscriçãoCandidaturas longas, como staff ou recrutamento

Para trocar de canal para modal, o formulário precisa ter no máximo 5 perguntas. Se tiver mais, o bot pede que você remova as que sobram primeiro.

Como funciona a coleta por modal

O membro clica no botão, a janela abre com todas as perguntas de uma vez, ele preenche e envia. Perguntas de texto curto viram um campo de uma linha, e as de texto longo viram um campo de parágrafo. As opcionais podem ficar em branco.

Nos modais, o Discord só mostra 45 caracteres no título de cada campo. Se a pergunta for maior, o bot corta o título e mostra o texto completo logo abaixo, como descrição do campo. Para ficar mais legível, prefira perguntas curtas no modal.

Como funciona a coleta por canal

  1. O membro clica no botão e o bot cria um canal chamado form-<nome do membro> na categoria configurada. O canal tem permissões próprias, sem herdar as da categoria: só o membro (e quem é Administrador no servidor) vê o canal.
  2. No canal, o bot explica quantas perguntas são, quanto tempo há para cada uma e mostra o botão Cancelar.
  3. As perguntas aparecem uma por vez, no formato Pergunta 1/10. O membro responde enviando uma mensagem. O bot guarda a resposta, apaga a pergunta e a mensagem para o canal ficar limpo, e manda a próxima.
  4. Em pergunta opcional, o membro envia - (um hífen) para pular.
  5. Depois da última resposta, o envio vai para a revisão (ou é aprovado direto, sem revisão), o membro recebe a confirmação no canal e o canal é apagado em cerca de 15 segundos.

Regras importantes:

  • Ficar em silêncio cancela. Se o tempo de uma pergunta acabar sem resposta, o formulário é cancelado, mesmo que a pergunta seja opcional (para pular é preciso enviar -). O bot avisa no canal e apaga o canal em cerca de 10 segundos.
  • Cancelar só funciona enquanto o membro ainda está respondendo. Depois do envio, o botão avisa que o formulário já foi enviado.
  • O bot só considera mensagens de texto do membro dono do canal. Imagens e anexos sem texto não contam como resposta.

Se o bot reiniciar no meio

As respostas são gravadas uma a uma, então um reinício do bot não faz o membro perder o que já respondeu. Quando o bot volta, ele retoma o preenchimento da pergunta em que o membro parou e avisa no canal que reiniciou. Se o membro respondeu enquanto o bot estava fora, essa resposta também é aproveitada.

Essa retomada vale para preenchimentos parados há menos de 1 hora. Um preenchimento parado há mais tempo é tratado como abandonado: o bot marca o envio como abandonado e apaga o canal que sobrou. Essa verificação roda quando o bot liga e depois a cada 15 minutos.

Perguntas

Cada pergunta tem:

CampoComo funciona
PerguntaO texto mostrado ao membro, de 2 a 300 caracteres
Tipo de respostaTexto curto ou Texto longo. No modal, define o tamanho do campo
Resposta obrigatóriaSe o membro pode deixar em branco (no modal) ou pular com - (no canal)
Dica de preenchimentoTexto cinza dentro do campo do modal, até 100 caracteres. Só aparece na coleta por modal

Na lista de perguntas, cada uma mostra embaixo a sua variável, por exemplo {{resposta.nome_do_personagem}}. É com ela que você coloca a resposta em apelidos e mensagens das ações automáticas.

A variável é criada a partir do texto da pergunta no momento em que ela é cadastrada: o bot tira acentos e símbolos, troca espaços por _ e limita a 32 caracteres. "Qual é o seu nome?" vira {{resposta.qual_e_o_seu_nome}}. Se duas perguntas gerarem a mesma variável, a segunda ganha um número no final (_2, _3...).

A variável não muda quando você edita a pergunta

Editar o texto de uma pergunta não muda a variável dela. Isso protege os apelidos e as mensagens que já usam essa variável. Se você quer uma variável com outro nome, remova a pergunta e cadastre de novo. Depois, atualize as ações que usavam a variável antiga.

Editar ou remover perguntas não muda os envios antigos: cada envio guarda o texto da pergunta como estava no momento em que foi respondido.

Revisão

A revisão fica na aba Revisão.

OpçãoComo funciona
Tipo de revisãoSem revisão: o envio já conta como aprovado na hora. Revisão humana: cada envio abre uma thread para a equipe aprovar ou reprovar
Canal de revisãoObrigatório na revisão humana. Precisa ser privado
Exigir motivo ao reprovarSe sim (o padrão), reprovar abre uma janela pedindo o motivo, de 3 a 1.000 caracteres
Cooldown após reprovaçãoQuantos dias o membro espera para enviar de novo depois de ser reprovado, de 0 a 365. Use 0 para permitir reenvio imediato

Quem pode revisar

Não existe um cargo de revisor. Quem enxerga o canal de revisão pode aprovar e reprovar. Por isso o bot recusa um canal que o @everyone consegue ver. Para controlar quem revisa, ajuste quem vê o canal nas permissões do Discord.

Se você trocar o canal de revisão, os envios antigos continuam nas threads do canal anterior, mas a permissão passa a ser conferida no canal novo: para revisar uma thread antiga, a pessoa precisa ver o canal que está configurado agora.

Revisão humana

Quando um envio chega:

  1. O bot publica no canal de revisão uma mensagem com o nome do formulário, quem enviou (menção e ID) e quando.
  2. Dessa mensagem nasce uma thread chamada Nome do formulário — nome do membro, com todas as respostas e os botões Aprovar e Reprovar. Se as respostas forem longas, elas são divididas em várias mensagens.
  3. Ao clicar, o bot muda o status, executa as ações de Ao aprovar ou Ao reprovar, publica o resultado na thread (incluindo as ações que falharam), atualiza a mensagem do canal com quem revisou, quando e o motivo, e arquiva a thread.

Assim, o canal de revisão funciona como uma lista: dá para ver o resultado de cada envio sem abrir a thread. O Discord arquiva sozinho as threads paradas, mas os botões continuam funcionando. Os envios que ainda faltam revisar são as mensagens do canal que não mostram Aprovado por nem Reprovado por.

Um envio só pode ser respondido uma vez. Se o membro tiver saído do servidor, o bot não deixa aprovar nem reprovar.

O bot não avisa o membro sozinho

Aprovar ou reprovar não manda nenhuma mensagem automática ao membro. Para avisar, adicione uma ação Enviar DM em Ao aprovar e outra em Ao reprovar (use {{motivo}} para incluir o motivo). Veja os exemplos.

Sem revisão

O envio é aprovado na hora e só as ações de Ao enviar são executadas. As ações de Ao aprovar e Ao reprovar nunca são executadas, e a aba Ações avisa isso.

O canal de revisão é opcional aqui. Se você configurar um, o bot publica nele cada envio com as respostas, só para registro e sem botões, e avisa se alguma ação falhou.

Um envio por vez

Cada membro só pode ter um envio em aberto por formulário. Enquanto ele estiver preenchendo ou com um envio aguardando revisão, o botão do painel responde:

  • "Você já possui um preenchimento em andamento para este formulário."
  • "Você já enviou este formulário e ele ainda está em análise."

Com cooldown, quem foi reprovado vê "Você foi reprovado recentemente. Poderá enviar novamente...", com a contagem do tempo que falta. Quem foi aprovado pode enviar o mesmo formulário de novo. Se isso não fizer sentido no seu caso, use uma ação para dar um cargo e limite quem vê o painel pelas permissões do canal.

Envio preso sem thread

Se a thread de um envio que estava aguardando for apagada (ou o canal de revisão inteiro), ninguém mais consegue revisar esse envio, e o membro ficaria bloqueado. Por isso o bot verifica a cada 15 minutos os envios que estão aguardando há mais de 30 minutos sem thread, cancela esses envios, avisa o membro por DM que ele pode enviar de novo e marca a mensagem do canal de revisão, se ela ainda existir.

Ações automáticas

As ações ficam na aba Ações, separadas pelos três momentos: Ao enviar, Ao aprovar e Ao reprovar. Em cada um, clique em Gerenciar e depois em Adicionar ação.

AçãoO que faz
Adicionar cargoDá um ou mais cargos ao membro, até 25 por ação
Remover cargoTira um ou mais cargos do membro, até 25 por ação
Alterar apelidoMuda o apelido do membro no servidor usando um formato com variáveis, até 100 caracteres
Enviar DMManda uma mensagem privada ao membro, até 2.000 caracteres
Mensagem em canalManda uma mensagem em um canal escolhido, até 2.000 caracteres
  • As ações de um momento rodam na ordem da lista, e a mesma ação pode aparecer mais de uma vez (por exemplo, avisar em dois canais).
  • Uma ação que falha não impede as outras de rodar.
  • Para mudar uma ação, remova e adicione de novo.

Variáveis

Nos apelidos e nas mensagens você pode usar:

VariávelVira
{{user}}A menção do membro
{{user.id}}O ID do membro
{{user.name}}O nome de usuário do membro
{{formulario}}O nome do formulário
{{motivo}}O motivo da reprovação. Fica vazio nos outros momentos e quando o motivo não é obrigatório
{{resposta.<variável>}}A resposta de uma pergunta, pela variável mostrada na aba Perguntas
  • Uma pergunta opcional que foi pulada vira um texto vazio.
  • Uma variável escrita errado (ou de uma pergunta que foi removida) não é trocada: aparece do jeito que foi escrita, com as chaves. Se um apelido ou mensagem sair com {{...}}, confira a variável na aba Perguntas.
  • As mensagens de DM e de canal aceitam a formatação do Discord (negrito, listas, links, menções de cargo e canal).

Apelido com mais de 32 caracteres

O Discord aceita apelidos de até 32 caracteres. Ao criar a ação Alterar apelido, você escolhe o que fazer se o resultado passar disso:

  • Cortar em 32 caracteres: aplica o apelido cortado.
  • Não aplicar e avisar a revisão: mantém o apelido atual e registra o aviso na revisão.

O Discord não deixa nenhum bot mudar o apelido do dono do servidor, então essa ação sempre falha para ele.

Quando uma ação falha

Cargo acima do cargo do bot, falta de permissão, DM fechada ou canal apagado fazem a ação falhar. O bot não esconde a falha:

  • Nas ações de Ao enviar, o aviso é a primeira mensagem da thread, antes das respostas, para quem revisa ver a falha antes de aprovar. Sem revisão, o aviso vai para o canal de revisão, se houver um configurado.
  • Nas ações de Ao aprovar e Ao reprovar, o resultado publicado na thread traz a seção Ações que não foram aplicadas.

Cada falha aparece com o nome da ação (por exemplo, Adicionar cargo) e o motivo em português: cargo acima do bot ou falta de permissão, DM do membro fechada, canal ou cargo que não existe mais, ou membro que saiu do servidor. Assim a equipe sabe, por exemplo, que o cargo não foi dado e pode dar à mão.

Exemplos

Candidatura à staff, coleta por canal, revisão humana, cooldown de 7 dias:

MomentoAções
Ao enviarMensagem no canal da staff: Nova candidatura de {{user}} em {{formulario}}.
Ao aprovarAdicionar o cargo Staff em teste · Enviar DM: Parabéns, {{user}}! Sua candidatura foi aprovada.
Ao reprovarEnviar DM: Sua candidatura foi reprovada. Motivo: {{motivo}}. Você poderá tentar de novo em 7 dias.

Recrutamento com apelido padronizado, com as perguntas "Nome do personagem" e "ID no jogo":

MomentoAções
Ao aprovarAlterar apelido: {{resposta.nome_do_personagem}} | {{resposta.id_no_jogo}} · Remover o cargo Visitante · Adicionar o cargo Membro

Cadastro sem revisão, liberado na hora:

MomentoAções
Ao enviarAdicionar o cargo Cadastrado · Alterar apelido: {{resposta.nome}}

O que o membro vê

SituaçãoO que acontece
Clica no painel de um formulário desativado ou excluído"Este formulário não está disponível."
Clica em um formulário sem perguntas"Este formulário ainda não possui perguntas configuradas."
Envia pelo modal, com revisão humana"Suas respostas foram enviadas para análise. Aguarde o retorno da administração."
Envia pelo modal, sem revisão"Suas respostas foram registradas com sucesso."
Começa pela coleta por canalO bot responde com o link do canal criado
A revisão está mal configurada (canal apagado ou sem permissão)"Este formulário está com a revisão mal configurada e suas respostas não chegaram à administração. Avise a equipe do servidor." O envio é cancelado, para o membro poder tentar de novo depois
É aprovado ou reprovadoSó recebe algo se houver uma ação de DM, mensagem ou cargo configurada

Relatórios

A aba Relatórios mostra:

  • Resumo: quantos envios estão aguardando revisão, aprovados, reprovados, preenchendo agora e abandonados, e a taxa de aprovação (aprovados sobre o total de revisados).
  • Últimos envios: do mais recente para o mais antigo, 5 por página, com o membro, o status, a data e quem revisou.

As respostas de cada envio ficam na thread de revisão. O botão Atualizar recarrega os números.

Problemas comuns

Mensagem ou sintomaO que fazer
"Cadastre ao menos uma pergunta." ao ativar ou publicarAdicione uma pergunta na aba Perguntas
"A coleta por canal exige uma categoria..."Em Geral → Coleta, escolha a categoria onde o canal será criado
"A revisão humana exige um canal privado..."Na aba Revisão, escolha o canal das threads
"O canal ... é visível para todos..."Tire do @everyone a permissão de ver o canal de revisão, ou escolha outro canal
"Ative o formulário antes de publicar o painel."Clique em Ativar no topo do formulário
"Configure o canal do painel."Na aba Painel, escolha o canal e salve
"Este formulário já atingiu o limite de ... perguntas..."O modal aceita 5 perguntas e o canal 50. Remova perguntas ou troque para a coleta por canal
"Você não tem permissão para revisar este formulário."A pessoa não vê o canal de revisão. Ajuste as permissões do canal
"O membro não está mais no servidor..."O membro saiu. O envio não pode ser aprovado nem reprovado
O cargo não foi dado ou o apelido não mudouVeja o motivo no resultado da revisão. Normalmente o cargo está acima do cargo do bot, ou o bot está sem gerenciar cargos ou gerenciar apelidos
O membro diz que não recebeu a DMA DM dele está fechada para membros do servidor. A falha aparece como Enviar DM no aviso da revisão
O canal de preenchimento não foi criadoO bot precisa de gerenciar canais na categoria, e a categoria não pode estar cheia (o Discord aceita 50 canais por categoria)