Primeiros passos

Crie uma aplicação, gere o bot, instale num servidor e responda !ping.

Este guia leva você do zero até um bot que responde !ping com pong! num canal de verdade. Você vai precisar de Node.js 18+ e de uma conta no NEX.

  1. Crie uma aplicação

    Abra o Developer Portal com sua conta NEX e clique em Criar. Qualquer usuário pode criar aplicações, sem aprovação. Isso cria o projeto, mas ainda não o bot.

  2. Gere o bot e guarde o token

    Na aba Bot, clique em Gerar bot. O token (nexbot_…) aparece uma única vez — guarde numa variável de ambiente. Se perder, gere outro em Rotacionar token.

  3. Ligue os intents

    Em Intents, marque messages.read para receber mensagens pelo Gateway. Sem ele, o bot conecta mas não recebe nenhum evento de mensagem. Veja Gateway.

  4. Instale num servidor

    Cadastre uma URL de redirecionamento, escolha as permissões na aba Instalação (no mínimo VER_CANAL e ENVIAR_MENSAGENS) e abra o link gerado logado na sua conta. Detalhes em Instalação.

  5. Conecte e responda

    Instale o cliente do Gateway e rode o exemplo abaixo.

npm install socket.io-client
NEX_TOKEN=nexbot_seu_token node bot.js
Dica
Use sempre a rota de bot /api/bot/servers/…/messages para enviar: ela aceita embeds e componentes e não esbarra nas regras de verificação que o servidor aplica a humanos.

Próximos passos