Guia prático de configuração do Doninha
O Doninha é uma ferramenta de automação para WhatsApp muito usada no Brasil. Funciona como um bot que envia mensagens em massa, lida com listas de contatos e responde automaticamente conforme regras que você define. A versão conhecida como doninha esquadrão suicida traz funcionalidades adicionais que a tornam mais popular entre quem trabalha com disparos comerciais. A instalação começa baixando o arquivo source do GitHub oficial. Você vai precisar de Node.js instalado, pelo menos versão 18. O processo de setup leva cerca de 10 a 15 minutos se o seu computador estiver atualizado. Primeiro você clona o repositório, entra na pasta e roda o comando npm install. Depois precisa configurar o arquivo .env com as credenciais que a ferramenta gera ao escanear o QR code via qrcode-terminal ou similar.
Configurando o doninha esquadrão suicida
Depois de rodar o setup inicial, a ferramenta exibe um QR code na tela. Você abre o WhatsApp no celular, vai em Dispositivos conectados e escaneia. Isso cria a sessão que fica ativa enquanto o computador permanecer ligado. O problema é que a sessão expira quando há logout em todos os dispositivos ou quando o WhatsApp web detecta comportamento suspeito. A lista de contatos pode ser importada via CSV. Cada linha deve ter número e nome opcional. Use ponto e vírgula como separador se os nomes tiverem vírgulas. Eu já perdi pelo menos duas horas num projeto porque a importação falhava em silêncio e só percebi quando comecei a receber mensagens de erro dos destinatários. A correção foi simple: converter o CSV para UTF-8 sem BOM usando um conversor online antes de carregar no Doninha. Ferramentas parecem ignorar encoding mal formatado.
👉 Clique no botão abaixo para saber mais sobre o assunto!
As regras de automação ficam num arquivo de configuração em formato JSON. Você define disparos, intervalos entre mensagens e respostas automáticas. Intervalo mínimo recomendado é 30 segundos entre cada mensagem para evitar bloqueios. Enviar mais rápido que isso normalmente resulta em banimento da conta em menos de 48 horas. Eu configurei uma fila com randomização de 25 a 40 segundos e consegui enviar 800 mensagens num único dia sem problemas. A média de envio segura pela maioria dos usuários é entre 50 e 100 mensagens por hora. Um detalhe importante que poucos mencionam: o Doninha faz login via sessão WebSocket, mas o WhatsApp descontinua sessões antigas periodicamente. Se você deixar a ferramenta rodando por semanas sem monitorar, ela para de funcionar silenciosamente. Sempre coloque um script de health check que reinicie o processo automaticamente após reconexões forçadas.
Existem alternativas mais robustas como Z-API e WPPConnect com version management profissional, mas o custo é significativamente maior. O Doninha ainda é a opção mais acessível para quem está começando ou opera com baixo volume. O arquivo original pode ser encontrado no repositório do projeto no GitHub. Procure por "Doninha" seguido do nome do mantenedor. Versões alteradas chamadas de "esquadrão suicida" costumam ser forks com patchs de third parties. Verifique se o fork é mantido ativamente antes de usar em produção. Eu conheço um caso em que um fork abandonado parou de funcionar em dezembro de 2025 por incompatibilidade com atualização do WhatsApp Business API e ninguém respondeu nos issues do repositório.
