Building Your First Custom Command
Dois exemplos práticos: um comando de informação simples e outro com opções que dá um cargo, envia uma DM e confirma.
O que os comandos personalizados fazem
Comandos personalizados viram comandos de barra reais do Discord, criados, atualizados e removidos pela API do Discord, com argumentos próprios que as pessoas preenchem ao digitar /seucomando. Um comando executa uma ou mais ações em ordem, de cima para baixo, quando alguém o usa.
Ver a referência completaExemplo: um comando de informação simples
O comando mais simples é uma resposta fixa, sem opções e com uma ação. Ótimo para perguntas frequentes, regras ou qualquer coisa que você vive digitando à mão:
| Campo | Valor |
|---|---|
| Nome | regras |
| Descrição | Mostra as regras do servidor |
| Opções | Nenhuma |
| Ação | Responder: "📋 Veja #regras para todas as diretrizes do servidor!" |
Exemplo: opções que dão um cargo e enviam uma DM
As opções ficam mais úteis quando uma ação as usa para algo além de texto. Este comando tem duas opções obrigatórias, para quem liberar o acesso e um recado pessoal, e executa três ações: adiciona um cargo fixo ao membro selecionado, envia uma DM com o recado e responde para confirmar.
Opções
| Opção | Tipo | Descrição |
|---|---|---|
{member} | Usuário | Obrigatória. O membro que vai receber o acesso |
{message} | Texto | Obrigatória. Um recado pessoal incluído na DM |
Ações
| Ação | Configuração |
|---|---|
| 1. Adicionar cargo | Alvo: member (opção personalizada) · Cargo: Membro (fixo) |
| 2. Enviar DM | Alvo: member (opção personalizada) · Mensagem: "Boas-vindas! {message}" |
| 3. Responder | "✅ Pronto, {member.mention} agora tem acesso." · Efêmera: ativado |
Publicar e testar
Salvar um comando já o registra no Discord automaticamente. Não existe uma etapa de publicação separada. Pode levar um ou dois minutos para ele aparecer quando você digita /, e se a lista de comandos parecer desatualizada, o botão Sincronizar agora em Comandos personalizados registra tudo de novo de uma vez.
Você já tem o básico
Daqui em diante, teste a ação Resposta aleatória para dar variedade ou explore os Grupos para manter organizado um conjunto crescente de comandos.