Como Configurar Cargos por Reação no Discord? Guia Completo com Cargos Temporários
Menu suspenso ou painel de botões? Qual escolher para cada conjunto de cargos, como definir um tempo de duração e remover o cargo automaticamente ao expirar. Com comandos, configuração de painéis, a armadilha da hierarquia e três erros comuns.
Este artigo foi traduzido automaticamente do original em turco. Ler o original em turco
Neste artigo
- Duas condições para o cargo ser atribuído
- Menu suspenso ou painel de botões?
- Configuração por comando
- Configuração pelo painel
- Cargos temporários: remoção automática
- Erros com o canal, a seleção múltipla e os cargos de moderador
- O membro deve escolher o cargo ou o moderador deve dá-lo?
- Perguntas frequentes
Em resumo
Cargos por reação permitem que os membros escolham seus próprios cargos através de um menu ou botão em uma mensagem. No VeyroBot, existem dois formatos: menu suspenso e painel de botões. Ambos podem ser configurados com o comando /reactionrole ou na seção de Cargos por Reação do painel.
Você também pode definir um tempo de duração para o menu: quando o tempo expirar, o bot remove o cargo automaticamente. Isso é ideal para cargos de eventos, participantes de competições ou acessos temporários, sem precisar de acompanhamento manual.
Duas condições para o cargo ser atribuído
Se estes dois pontos não forem atendidos, o menu será criado e a mensagem aparecerá, mas o cargo não será atribuído. A maioria das reclamações surge daqui.
- O módulo de autorole deve estar ativado. O comportamento de atribuição de cargos dos menus e botões depende deste módulo; com ele desativado, o menu não responde aos cliques.
- O cargo do bot deve estar acima dos cargos que ele vai distribuir. O Discord não permite que um bot atribua um cargo superior ao seu próprio cargo mais alto. Os cargos que não estão acima não são ignorados silenciosamente; eles aparecem com o nome na lista de "não foi possível atribuir" na resposta ao membro. O bot também precisa da permissão Gerenciar Cargos.
Se você não tiver certeza de como a ordem dos cargos funciona, leia primeiro o artigo sobre o sistema de cargos e permissões do Discord; a regra de hierarquia explicada lá se aplica exatamente aqui.
Este tema no VeyroBot:Cargos por reação no Discord (menu de cargos) →
Menu suspenso ou painel de botões?
Ambos se comportam de maneira diferente, e essa diferença determina a escolha correta para o seu conjunto de cargos.
| Menu suspenso | O membro pode marcar várias opções. O menu funciona como uma lista completa: os cargos que não forem deixados marcados são removidos. É ideal para conjuntos gerenciados em conjunto, como cores, jogos e cargos de interesses. |
| Painel de botões | Cada botão ativa ou desativa apenas o seu próprio cargo; ele não mexe nos outros cargos. É ideal para aceitação de regras, cargos de notificação ou itens obtidos individualmente. |
| Limite comum | Um menu pode conter no máximo 25 cargos. Este é um limite do Discord: o menu suspenso aceita 25 opções, enquanto o painel de botões aceita 5 linhas × 5 botões. |
Configuração por comando
Para usar o comando, você precisa ter a permissão Gerenciar Cargos.
/reactionrole tipo:<menu suspenso | botoes> titulo:<titulo do menu> cargo1:@Cargo [cargo2 … cargo5] [descricao] [tempo]
- tipo — escolhe se será um menu ou botões.
- titulo — o título que aparece acima da mensagem; obrigatório.
- cargo1 … cargo5 — o comando aceita até cinco cargos de uma vez só. Listas mais longas devem ser configuradas pelo painel.
- descricao — a linha de descrição exibida abaixo do título.
- tempo — por quanto tempo o cargo atribuído permanecerá. Se deixado em branco, o cargo é permanente.
Configuração pelo painel
O painel remove as limitações do comando e permite que você edite o menu visualmente:
- Seleção de até 25 cargos em um único menu.
- Título com no máximo 256 caracteres e descrição com no máximo 1000 caracteres.
- Escolha da cor do embed da mensagem do menu e do canal onde ela será enviada.
- O tempo é definido a partir da mesma lista de opções do comando.
A mensagem do menu é enviada pelo bot para o canal escolhido. Se você excluir a mensagem, o menu deixará de funcionar; você precisará configurar um novo menu.
Cargos temporários: remoção automática
As opções de tempo são fixas: indefinido, 10 minutos, 1 hora, 6 horas, 1 dia, 3 dias, 7 dias, 30 dias. O tempo é definido no nível do menu — todos os cargos obtidos através daquele menu são concedidos com a mesma duração.
O funcionamento não é baseado em "definir um lembrete e esquecer"; tudo é mantido no banco de dados de registros:
- O horário de término é registrado no momento em que o membro recebe o cargo. Mesmo se o bot reiniciar, o tempo não é perdido.
- Os registros com tempo expirado são verificados em intervalos de um minuto e o cargo é removido.
- Se o membro remover o cargo por conta própria, o temporizador é excluído; se ele pegar o cargo novamente, o tempo começa do zero.
- Mesmo que o menu seja excluído posteriormente, os cargos atribuídos por ele serão removidos quando seus respectivos tempos expirarem.
- Se o cargo tiver sido excluído, o membro tiver saído do servidor ou o cargo já não estiver mais com o membro, o registro será limpo.
- Se o bot não conseguir remover o cargo (problema de permissão ou hierarquia), ele tentará novamente a cada ciclo; se não conseguir após 24 horas, o registro será descartado. É por isso que a regra de hierarquia nos pré-requisitos é ainda mais importante para cargos temporários.
Você pode verificar em qual plano os menus temporários estão disponíveis na tabela de comparação de planos.
Erros com o canal, a seleção múltipla e os cargos de moderador
- Configurar o menu no canal errado. Se você enviar a mensagem do menu para um canal que apenas a moderação pode ver, os membros não poderão pegar os cargos. O menu deve ficar em um canal que todos possam ler.
- Achar que o menu suspenso é de seleção única. Quando um membro seleciona um segundo cargo, o primeiro permanece; mas se ele desmarcar uma opção no menu, aquele cargo é removido. Se os cargos precisarem ser mutuamente exclusivos, isso deve ser garantido pelo seu design de cargos, e não pelo menu.
- Colocar um cargo de moderação no menu. Qualquer cargo adicionado ao menu é um cargo que qualquer pessoa com acesso àquele canal pode pegar. Cargos que concedem permissões de moderador, gerenciamento de canais de voz ou exclusão de mensagens nunca devem ser colocados em menus.
O membro deve escolher o cargo ou o moderador deve dá-lo?
Adequado: comunidades onde os membros escolhem seus próprios cargos de notificação, jogos, cores ou interesses; servidores que distribuem cargos temporários durante eventos e períodos de competições; estruturas que liberam acesso após a aprovação de regras.
Não adequado: situações em que uma pessoa precisa decidir quem deve ter o cargo (recrutamento de moderação, status de membro verificado) e servidores onde o cargo depende de um processo de inscrição/aprovação. Nesses casos, quem atribui o cargo é o moderador, e não o menu.
Perguntas frequentes
Se um membro pegar o cargo pelo menu e largá-lo imediatamente, o tempo continua contando?
Não. No momento em que ele larga o cargo, o temporizador é excluído. Se ele pegar o cargo novamente, o tempo começa do zero.
Posso tornar apenas um dos cargos de um menu temporário?
Não. O tempo é definido a nível de menu. Para tempos diferentes, configure menus separados.
Posso editar a mensagem do menu?
O título, a descrição e os cargos do menu são definidos no momento da criação. Para fazer alterações, é necessário configurar um novo menu e excluir o antigo.
O que acontece com os cargos cujo tempo expira enquanto o bot está offline?
Como os registros ficam armazenados no banco de dados, assim que o bot retorna, eles são removidos no primeiro ciclo; o tempo não é perdido.
Quero que os membros escolham entre mais de 25 cargos. Divida os cargos por assunto e crie vários menus; o limite é por menu.
Última atualização: 15 de setembro de 2026. Os limites e comportamentos descritos neste artigo foram verificados no motor atual de cargos por reação e temporários do VeyroBot.
