Um bot robusto e organizado para WhatsApp focado na criação de figurinhas (stickers), desenvolvido com whatsapp-web.js.
Transforme imagens e vídeos em figurinhas instantaneamente.
- Como usar:
- Envie uma imagem ou vídeo com a legenda
!figurinha. - Ou responda (Reply) a uma imagem/vídeo já enviado com o comando
!figurinha.
- Envie uma imagem ou vídeo com a legenda
- Personalização:
- Adicione texto após o comando para dar nome à figurinha. Ex:
!figurinha MeuPack.
- Adicione texto após o comando para dar nome à figurinha. Ex:
!ping: Verifica se o bot está online.!gerar: (Opcional) Processa arquivos locais na pastastickers.
A maneira mais estável de rodar o bot é via Docker, pois ele já configura o ambiente com Chromium e FFmpeg.
- Inicie o Bot:
npm run docker:up
- Escaneie o QR Code: O código aparecerá diretamente no seu terminal.
- Parar o Bot:
npm run docker:down
Se preferir rodar sem Docker, instale o FFmpeg no seu sistema e execute:
pnpm install
pnpm run devO projeto utiliza uma arquitetura organizada por responsabilidades:
src/index.ts: Ponto de entrada da aplicação.src/bot.ts: Configuração do cliente WhatsApp e eventos globais.src/handlers/message.handler.ts: Gerenciamento de comandos e mensagens.src/services/sticker.service.ts: Lógica de download e conversão de mídias.src/config/bot.config.ts: Centralização de caminhos (FFmpeg/Chrome) e ambiente.
- Docker e Docker Compose (recomendado).
- Node.js (se rodar localmente).
- FFmpeg (se rodar localmente).
.wwebjs_auth/: Armazena sua sessão para evitar novos escaneamentos de QR Code..wwebjs_cache/: Cache de versões do WhatsApp Web para maior estabilidade.