Os bots do Discord podem adicionar recursos poderosos ao seu servidor, mas encontrar e usar esses recursos rapidamente pode ser confuso. Os comandos de menu de contexto permitem executar ações do bot diretamente de uma mensagem ou perfil de usuário sem digitar comandos de barra ou prefixos. Este artigo explica o que são comandos de menu de contexto de bot, como configurá-los e como usá-los em mensagens e usuários. Você aprenderá as etapas exatas para acionar esses comandos e como gerenciá-los como administrador do servidor.
Principais conclusões: usando comandos de menu de contexto de bot no Discord
- Clique com o botão direito em uma mensagem ou usuário: Abre o menu de contexto onde os comandos do bot aparecem em Apps.
- Configurações do servidor > Integrações > Bots e Apps: Permite que administradores do servidor ativem ou desativem comandos específicos de menu de contexto para cada bot.
- Diretório de aplicativos ou site do bot: Use-os para encontrar bots que oferecem comandos de menu de contexto para moderação, tradução ou tarefas utilitárias.
O que são comandos de menu de contexto de bot?
O Discord introduziu comandos de menu de contexto como parte do sistema de comandos de barra. Esses comandos aparecem quando você clica com o botão direito em uma mensagem ou em um usuário. Eles também são chamados de comandos de mensagem e comandos de usuário. Diferente dos comandos tradicionais de bot que exigem digitar !comando ou /comando, os comandos de menu de contexto são acionados pelo menu de aplicativos que aparece ao clicar com o botão direito.
Comandos de menu de contexto de mensagem atuam na mensagem específica em que você clicou com o botão direito. Por exemplo, um bot de moderação pode oferecer um comando para excluir essa mensagem ou denunciá-la. Comandos de menu de contexto de usuário atuam no usuário em cujo perfil você clicou com o botão direito. Um bot pode oferecer um comando para ver o histórico de advertências desse usuário ou enviar uma nota privada.
Os bots precisam ser programados para oferecer suporte a esses comandos. Nem todo bot os inclui. Quando um bot os suporta, os comandos aparecem automaticamente assim que o bot é adicionado ao seu servidor e tem as permissões necessárias.
Pré-requisitos para usar comandos de menu de contexto
Antes de usar comandos de menu de contexto de bot, você precisa do seguinte:
- Um servidor do Discord onde você tenha permissão para adicionar bots. Geralmente, isso requer a permissão Gerenciar Servidor.
- Um bot que suporte comandos de menu de contexto de mensagem ou usuário. Verifique a documentação do bot ou a listagem no diretório de aplicativos.
- O bot deve ter as permissões corretas no seu servidor. Por exemplo, um bot de moderação precisa da permissão Gerenciar Mensagens para excluir mensagens.
Como usar comandos de menu de contexto de bot em mensagens
Usar um comando de menu de contexto de mensagem é simples. Siga estas etapas:
- Clique com o botão direito na mensagem alvo
Passe o mouse sobre a mensagem na qual deseja agir. Clique com o botão direito. Um menu de contexto aparece com várias opções. - Passe o mouse ou clique em Apps
No menu de contexto, procure a opção Apps. Clique nela ou passe o mouse para expandir a lista de comandos de bot disponíveis que se aplicam àquela mensagem. - Selecione o comando do bot
Na lista expandida, clique no comando que deseja executar. Por exemplo, se você tem um bot de tradução, pode ver Traduzir para inglês. Clique nele. - Aguarde a resposta do bot
O bot processará o comando e geralmente responderá no mesmo canal ou enviará uma mensagem direta. A resposta exata depende do design do bot.
Como usar comandos de menu de contexto de bot em usuários
Comandos de menu de contexto de usuário funcionam de forma semelhante, mas têm como alvo um usuário em vez de uma mensagem.
- Clique com o botão direito no nome ou avatar do usuário
Encontre o usuário na lista de membros, em uma mensagem do chat ou em um canal de voz. Clique com o botão direito no nome ou avatar. Um menu de contexto aparece. - Passe o mouse ou clique em Apps
Assim como nos comandos de mensagem, localize a opção Apps no menu de contexto e clique ou passe o mouse para expandi-la. - Selecione o comando de usuário
Clique no comando que deseja executar. Por exemplo, um bot de moderação pode oferecer Advertir Usuário ou Ver Advertências. Clique nele. - Aguarde a resposta do bot
O bot executará o comando e mostrará o resultado no canal ou via mensagem direta.
Como administradores de servidor podem gerenciar comandos de menu de contexto
Se você é administrador do servidor, pode controlar quais comandos de menu de contexto estão disponíveis para os membros. Isso é útil para ocultar comandos que são apenas para moderadores ou para desativar comandos que causam poluição visual.
- Abra as Configurações do Servidor
Clique no nome do servidor no canto superior esquerdo do seu cliente Discord. No menu suspenso, selecione Configurações do Servidor. - Navegue até Integrações
Na barra lateral esquerda, clique em Integrações. Esta página mostra todos os bots e webhooks adicionados ao seu servidor. - Selecione o bot que deseja gerenciar
Em Bots e Apps, encontre o bot cujos comandos de menu de contexto deseja alterar. Clique em Gerenciar. - Role até a seção Comandos
Na página de gerenciamento do bot, role para baixo até a seção Comandos. Aqui você verá todos os comandos que o bot oferece, incluindo os comandos de menu de contexto. - Ative ou desative comandos específicos
Cada comando tem um botão de alternância. Clique no botão para ativar ou desativar esse comando. Comandos desativados não aparecerão no menu de contexto de nenhum membro. - Defina permissões de comando
Abaixo de cada comando, você também pode definir quais cargos podem usá-lo. Clique no menu suspenso e selecione os cargos. Apenas membros com esses cargos verão o comando no menu de contexto.
Problemas comuns e limitações
Comandos de menu de contexto não aparecem
Se você clicar com o botão direito em uma mensagem ou usuário e não vir a opção Apps ou nenhum comando de bot, verifique o seguinte:
- O bot pode não suportar comandos de menu de contexto. Verifique a documentação do bot.
- O bot pode estar offline ou com problemas.
- Você pode não ter permissão para usar o comando. Peça a um administrador do servidor para verificar as restrições de cargo do comando.
- O comando pode estar desativado pelo administrador do servidor. Peça para ativá-lo.
O bot não responde após executar um comando de menu de contexto
Quando um bot não responde, pode ser porque ele não tem as permissões necessárias para realizar a ação. Por exemplo, um bot de moderação não pode excluir uma mensagem se não tiver a permissão Gerenciar Mensagens. Verifique as permissões do cargo do bot em Configurações do Servidor > Cargos. Verifique também se o bot está com limite de taxa ou se o comando requer um tipo específico de canal, como um canal de texto.
Comandos de menu de contexto aparecem para todos, mas deveriam ser restritos
Se você deseja que alguns comandos estejam disponíveis apenas para moderadores, defina as permissões dos comandos na página de Integrações. Siga as etapas da seção anterior para atribuir cargos a cada comando. Observe que alguns bots também podem ter seu próprio sistema de permissões dentro do painel do bot. Verifique o site do bot para configurações avançadas.
Comandos de mensagem vs comandos de usuário: principais diferenças
| Item | Comandos de menu de contexto de mensagem | Comandos de menu de contexto de usuário |
|---|---|---|
| Método de ativação | Clique com o botão direito em uma mensagem | Clique com o botão direito no nome ou avatar do usuário |
| Alvo | A mensagem específica em que você clicou | O usuário em cujo perfil você clicou |
| Casos de uso comuns | Traduzir, excluir, denunciar, fixar ou copiar conteúdo da mensagem | Advertir, silenciar, expulsar, ver informações do usuário ou enviar uma nota privada |
| Permissão necessária do bot | Depende da ação; geralmente Ler Mensagens e Enviar Mensagens | Depende da ação; geralmente Ler Membros e Moderar Membros |
| Exemplo de nome de comando | Traduzir para espanhol | Ver advertências de @Usuário |
Ambos os tipos de comando aparecem no mesmo menu Apps, mas são sensíveis ao contexto. O Discord mostra automaticamente apenas os comandos que se aplicam ao item em que você clicou. Se um bot oferece comandos de mensagem e de usuário, você verá os relevantes ao clicar com o botão direito em uma mensagem versus ao clicar em um usuário.
Os comandos de menu de contexto de bot economizam tempo ao eliminar a necessidade de lembrar nomes de comandos de barra ou prefixos de bot. Eles também reduzem a poluição no chat, pois o comando é acionado pelo menu em vez de ser digitado na caixa de mensagem. Administradores de servidor podem ajustar quais comandos aparecem e quem pode usá-los, tornando o sistema flexível para diferentes cargos no servidor.