Um chatbot automatizado para WhatsApp, construído com Node.js, TypeScript e a biblioteca whatsapp-web.js.
Projetado com foco em performance, escalabilidade e código limpo, facilitando manutenção e evolução.
- Node.js: Ambiente de execução JavaScript.
- TypeScript: Tipagem estática para maior segurança e previsibilidade.
- whatsapp-web.js: API baseada no WhatsApp Web (via Puppeteer/Chromium).
- ts-node-dev / Nodemon: Live-reload para desenvolvimento ágil.
Antes de começar, garanta que você possui:
- Node.js (v18 ou superior recomendado)
- npm ou yarn
- Uma conta ativa no WhatsApp (preferencialmente um número de testes)
1. Clone o repositório e acesse a pasta do projeto:
git clone https://github.com/MarcosSoftwareEngineering/<seu-repositorio>.git
cd <seu-repositorio>2. Instale as dependências:
npm install3. Configure as variáveis de ambiente:
cp .env.example .env4. Execute em modo desenvolvimento:
npx ts-node-dev src/index.ts5. Para produção, compile e inicie:
npx tsc
node dist/index.jsNa primeira execução, será exibido um QR Code no terminal:
- Abra o WhatsApp no celular.
- Vá em Aparelhos Conectados → Conectar um aparelho.
- Escaneie o QR Code para autenticar.
⚠️ As credenciais ficam salvas em.wwebjs_auth— não versionar no Git por segurança (adicione ao.gitignore).
npx ts-node-dev src/index.ts # Executa em modo desenvolvimento (TypeScript)
npx tsc # Transpila o código para JavaScript (pasta /dist)
node dist/index.js # Roda a versão compilada em produção- ✅ Autenticação via QR Code
- ✅ Escuta de mensagens recebidas
- ⬜ Respostas dinâmicas a comandos
Desenvolvido com dedicação e foco em Clean Code.