Skip to content

MarcosSoftwareEngineering/ChatBoot.Ts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 WhatsApp Chatbot — Node.js & TypeScript

TypeScript Node.js whatsapp-web.js

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.


🚀 Tecnologias Utilizadas

  • 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.

⚙️ Pré-requisitos

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)

🛠️ Instalação e Configuração

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 install

3. Configure as variáveis de ambiente:

cp .env.example .env

4. Execute em modo desenvolvimento:

npx ts-node-dev src/index.ts

5. Para produção, compile e inicie:

npx tsc
node dist/index.js

📱 Autenticação (Primeiro Acesso)

Na primeira execução, será exibido um QR Code no terminal:

  1. Abra o WhatsApp no celular.
  2. Vá em Aparelhos ConectadosConectar um aparelho.
  3. Escaneie o QR Code para autenticar.

⚠️ As credenciais ficam salvas em .wwebjs_authnão versionar no Git por segurança (adicione ao .gitignore).


📜 Scripts Disponíveis

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

🎯 Funcionalidades

  • ✅ Autenticação via QR Code
  • ✅ Escuta de mensagens recebidas
  • ⬜ Respostas dinâmicas a comandos

👨‍💻 Autor

Desenvolvido com dedicação e foco em Clean Code.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages