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
| Termo | O que é |
|---|---|
| Formulário | Um conjunto de perguntas com as regras de coleta, revisão e ações. Cada formulário é independente dos outros |
| Painel | A mensagem pública com o botão que abre o formulário. Cada formulário tem um painel |
| Envio | O 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ática | Algo que o bot faz sozinho em um dos três momentos: ao enviar, ao aprovar ou ao reprovar |
Um envio passa por estes status:
| Status | Quando |
|---|---|
| Preenchendo | O membro ainda está respondendo (só na coleta por canal) |
| Aguardando | Enviado e esperando a equipe (só com revisão humana) |
| Aprovado | A equipe aprovou, ou o formulário não tem revisão |
| Reprovado | A equipe reprovou |
| Abandonado | O 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
- 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).
- 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. - 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.
| Modal | Canal | |
|---|---|---|
| Onde o membro responde | Em uma janela que abre por cima do Discord | Em um canal temporário e privado, criado para ele |
| Perguntas | Até 5 | Até 50 |
| Tamanho da resposta | Até 4.000 caracteres | Uma mensagem do Discord por resposta |
| Tempo | Sem limite enquanto a janela estiver aberta | Tempo limite por pergunta, de 15 a 900 segundos (padrão 120) |
| Precisa de | Nada além das perguntas | Uma categoria onde o canal é criado |
| Indicado para | Formulários curtos, como pedido de parceria ou inscrição | Candidaturas 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
- 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. - No canal, o bot explica quantas perguntas são, quanto tempo há para cada uma e mostra o botão Cancelar.
- 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.
- Em pergunta opcional, o membro envia
-(um hífen) para pular. - 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:
| Campo | Como funciona |
|---|---|
| Pergunta | O texto mostrado ao membro, de 2 a 300 caracteres |
| Tipo de resposta | Texto curto ou Texto longo. No modal, define o tamanho do campo |
| Resposta obrigatória | Se o membro pode deixar em branco (no modal) ou pular com - (no canal) |
| Dica de preenchimento | Texto 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ção | Como funciona |
|---|---|
| Tipo de revisão | Sem 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ão | Obrigatório na revisão humana. Precisa ser privado |
| Exigir motivo ao reprovar | Se sim (o padrão), reprovar abre uma janela pedindo o motivo, de 3 a 1.000 caracteres |
| Cooldown após reprovação | Quantos 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:
- O bot publica no canal de revisão uma mensagem com o nome do formulário, quem enviou (menção e ID) e quando.
- 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.
- 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ção | O que faz |
|---|---|
| Adicionar cargo | Dá um ou mais cargos ao membro, até 25 por ação |
| Remover cargo | Tira um ou mais cargos do membro, até 25 por ação |
| Alterar apelido | Muda o apelido do membro no servidor usando um formato com variáveis, até 100 caracteres |
| Enviar DM | Manda uma mensagem privada ao membro, até 2.000 caracteres |
| Mensagem em canal | Manda 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ável | Vira |
|---|---|
{{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:
| Momento | Ações |
|---|---|
| Ao enviar | Mensagem no canal da staff: Nova candidatura de {{user}} em {{formulario}}. |
| Ao aprovar | Adicionar o cargo Staff em teste · Enviar DM: Parabéns, {{user}}! Sua candidatura foi aprovada. |
| Ao reprovar | Enviar 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":
| Momento | Ações |
|---|---|
| Ao aprovar | Alterar apelido: {{resposta.nome_do_personagem}} | {{resposta.id_no_jogo}} · Remover o cargo Visitante · Adicionar o cargo Membro |
Cadastro sem revisão, liberado na hora:
| Momento | Ações |
|---|---|
| Ao enviar | Adicionar o cargo Cadastrado · Alterar apelido: {{resposta.nome}} |
O que o membro vê
| Situação | O 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 canal | O 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 reprovado | Só 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 sintoma | O que fazer |
|---|---|
| "Cadastre ao menos uma pergunta." ao ativar ou publicar | Adicione 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 mudou | Veja 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 DM | A 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 criado | O bot precisa de gerenciar canais na categoria, e a categoria não pode estar cheia (o Discord aceita 50 canais por categoria) |
Ticket
Como o ticket funciona de ponta a ponta, da configuração ao fechamento. Inclui abertura, atendimento, logs, horário de atendimento, alerta de SLA, Inteligência Artificial e as estatísticas da equipe no dashboard.
Anúncios
Como montar, publicar e agendar anúncios com o /anuncio. Inclui os limites do bot gratuito e dos planos pagos, variáveis, dias da semana, limite de envios, publicar nos seguidores, fixar a mensagem e envio em vários canais.
