Skip to main content
Este tutorial irá guiá-lo desde a criação do bot no Discord Developers até a integração completa com sua loja Mginex.

1. Criar Aplicação no Discord

Antes de tudo, você precisa criar uma aplicação no portal de desenvolvedores do Discord.
  1. Acesse o Discord Developer Portal.
  2. Clique em New Application e dê um nome ao seu bot (ex: “Minha Loja Bot”).
  3. No menu lateral, clique em Bot.
  4. Desmarque a opção “Public Bot” (para que apenas você possa adicioná-lo).
  5. Role até a seção Privileged Gateway Intents e marque as três opções:
    • Presence Intent
    • Server Members Intent
    • Message Content Intent
  6. Salve as alterações.
  7. Clique no botão Reset Token, confirme e copie o Token gerado. Guarde-o, pois usaremos em breve.

2. Instalação do Bot

Download

Baixe a versão mais recente do bot Mginex:

Baixar BOT MGINEX V2 - SPX

Clique para fazer o download do arquivo .zip

Configuração Inicial

  1. Extraia o arquivo ZIP para uma pasta em seu computador.
  2. Abra o arquivo config.json com um editor de texto.
  3. Cole o Token do Bot Discord (copiado no passo 1) no campo token.
  4. Não altere o campo apiKey por enquanto, faremos isso via comando.
O arquivo deve ficar assim:
{
    "token": "SEU_TOKEN_DO_DISCORD_AQUI",
    "apiKey": "", 
    ...
}

Instalação das Dependências

  1. Abra o Terminal ou CMD dentro da pasta do bot.
  2. Execute o comando para instalar as bibliotecas necessárias:
    npm install
    

3. Primeiro Início (Auto-Setup)

Execute o bot pela primeira vez:
node .
O bot irá iniciar, identificar seu servidor e o dono, fazer o upload automático dos emojis e atualizar as configurações. Logo após, ele irá desligar automaticamente. Isso é normal!
A mensagem “SETUP DE PRIMEIRO USO CONCLUÍDO COM SUCESSO!” aparecerá no terminal.

4. Integração com a Mginex

Agora, inicie o bot novamente:
node .
O bot ficará online. Agora vamos configurá-lo dentro do Discord.

Gerando o Token da API

  1. Acesse seu painel em app.mginex.com.
  2. Vá em Settings (Configurações) > Integração via API (Open API).
  3. Clique em Gerar novo token e copie a chave.

Configurando no Discord

No canal do seu servidor Discord, digite o comando:
/configurar
  1. Um menu interativo aparecerá. Selecione a opção Editar API Key.
  2. Cole o token da Mginex que você copiou.
  3. O bot irá salvar e validar sua conexão com a loja.

5. Configurações Finais

Use o mesmo comando /configurar para ajustar outras opções importantes:
  • Editar Categoria: Selecione a categoria do Discord onde os tickets de carrinho (carrinhos de compra) serão criados.
  • Configurar Cores: Personalize as cores das mensagens do bot para combinar com sua marca.
  • Configurar Logs: Defina canais para receber notificações de vendas e eventos.

Publicando um Produto

Para vender um produto, use o comando:
/setar-produto
Selecione o produto que deseja anunciar e preencha as informações no formulário que aparecerá. O bot criará, então, um painel de compra automático para seus clientes.