whatsbot

KO | EN

gitlite — search

#javascript #ai #typescript #llm #golang #android #rust #docker #windows #cli #kubernetes #vue #pytorch #mcp

(★ 14)

Bot de WhatsApp com IA via OpenRouter

whatsbot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WhatsBot

**Inteligência artificial no seu WhatsApp em menos de 5 minutos. Sem mensalidade. Sem complicação.**

Feito para empresários, prestadores de serviço e qualquer pessoa que queira um atendimento automatizado no WhatsApp — sem precisar entender nada de programação.

Baixou, instalou, escaneou o QR Code, escreveu como a IA deve se comportar e pronto — sua IA já está respondendo no WhatsApp automaticamente. Na primeira vez, um assistente de configuração cria sua chave de API sozinho (com crédito grátis para começar) — você não precisa criar conta em lugar nenhum.

100% gratuito, código aberto, tudo roda no seu computador.

**Tutorial completo no blog da Techify:** [WhatsBot: Chatbot WhatsApp com IA grátis em 2026](https://techify.one/blog/whatsbot-chatbot-whatsapp-com-ia-gratis-em-2026)

---

## Para quem é o WhatsBot?

- Donos de loja que querem responder clientes automaticamente
- Profissionais liberais (dentistas, advogados, contadores) que precisam de uma secretária virtual
- Prestadores de serviço que recebem muitas mensagens e não conseguem responder a tempo
- Qualquer pessoa que queira uma IA atendendo no WhatsApp sem pagar mensalidade de plataforma

**Você não precisa saber programar.** O WhatsBot foi feito para ser simples de usar. E se um dia quiser personalizar algo no código, basta pedir para qualquer ferramenta de IA (como ChatGPT, Claude, Cursor, etc.) fazer a alteração — o código é aberto e as mudanças funcionam na hora, sem processo complicado.

---

## Como começar

### 1. Baixe e abra o programa

Baixe o WhatsBot, extraia a pasta e dê dois cliques no arquivo **start.bat**. O programa vai preparar tudo sozinho e abrir automaticamente no seu navegador.

> **Por que um .bat e não um .exe?** Porque assim você (ou qualquer ferramenta de IA) pode abrir, ler e modificar o código livremente. Com um .exe isso não seria possível. O WhatsBot foi pensado para ser fácil de personalizar.

### 2. Siga o assistente de configuração

Na primeira vez, abre um assistente que cuida de tudo em poucos passos:

- **Conecte seu WhatsApp** escaneando o QR Code (igual ao WhatsApp Web)
- **Sua chave de API é criada automaticamente** — o WhatsBot conversa com a Techify pelo seu WhatsApp, cria sua conta e já libera um crédito grátis para você começar a testar. Você não precisa criar conta em nenhum site nem copiar e colar chave nenhuma.
- Quando o crédito estiver acabando, o próprio painel avisa e mostra o link para recarregar. Você só paga pelo que usar — sem mensalidade.

> Quer pular o assistente e configurar manualmente? Dá para fechar o wizard e ir direto para o chat — a chave e os modelos ficam disponíveis na tela de Configurações.

### 3. Escreva o prompt (personalidade da IA)

O prompt é o texto onde você diz para a IA como ela deve se comportar. Pense nele como as "instruções" que você daria a um funcionário novo. Exemplos:

- *"Você é um assistente de vendas da loja XYZ. Seja educado e objetivo. Nossos produtos são: ..."*
- *"Você é a secretária virtual do Dr. João. Agende consultas e tire dúvidas sobre horários."*
- *"Você é um atendente de suporte técnico. Responda de forma clara e simples."*

Quanto mais detalhado o prompt, melhor a IA vai atender seus clientes.

### 4. Pronto!

A IA já está respondendo automaticamente as mensagens que chegam no seu WhatsApp. Você pode acompanhar todas as conversas pelo painel.

---

## Funcionalidades

### Resposta automática com IA

- **Responde mensagens sozinha** — quando alguém manda mensagem no seu WhatsApp, a IA responde automaticamente
- **Entende texto, áudio e imagens** — se mandarem um áudio, a IA transcreve e responde; se mandarem uma foto, a IA analisa e responde
- **Junta mensagens rápidas** — se a pessoa mandar várias mensagens seguidas, a IA espera um pouco e responde tudo de uma vez (evita respostas pela metade)
- **Simula digitação** — antes de responder, mostra "digitando..." para parecer mais natural, como se fosse uma pessoa de verdade
- **Mensagens picadas** — a IA pode dividir a resposta em várias mensagens separadas, como uma pessoa faria no WhatsApp (ex: uma saudação, depois o conteúdo, depois uma despedida)
- **Intervalo entre mensagens** — você controla quantos segundos a IA espera entre cada parte da mensagem picada

---

### Painel de conversas

Uma tela parecida com o WhatsApp Web onde você acompanha tudo o que está acontecendo:

- **Lista de contatos** com prévia da última mensagem, horário e foto de perfil (a foto é buscada do WhatsApp e atualizada sozinha quando o contato troca a imagem)
- **Chat completo** com cada contato — veja todo o histórico de conversa entre a IA e o cliente, com separadores de data
- **Enviar mensagens manualmente** — você pode intervir a qualquer momento e digitar uma mensagem você mesmo
- **Anexar qualquer arquivo** — envie imagens (com legenda), documentos (PDF, planilhas, etc., preservando o nome original) ou qualquer outro tipo de arquivo direto pelo chat
- **Gravar e enviar áudio** — grave áudio direto pelo painel e envie para o contato
- **Reagir com emoji** — reaja a qualquer mensagem com um emoji, igual ao WhatsApp
- **Responder mensagem específica** — cite uma mensagem anterior ao responder
- **Apagar mensagem** — apague uma mensagem que você enviou (para todos)
- **Fixar conversas** — fixe os contatos mais importantes no topo da lista
- **Marcar como lida / não lida** — controle manualmente o que já viu, ou marque todas de uma vez
- **Menções em grupos** — escreva `@nome` ou `@todos` e o WhatsBot transforma na menção real; menções que chegam aparecem com o nome do contato em vez do número, e o grupo é destacado quando mencionam você
- **Indicador de digitação** — veja quando o contato está digitando ou gravando áudio em tempo real
- **Mensagens não lidas** — contador verde mostra quantas mensagens do cliente você ainda não viu, e contador azul mostra quantas respostas a IA enviou que você ainda não conferiu. Ao abrir a conversa, ambos zeram e o WhatsApp marca as mensagens como lidas (✓✓ azul) automaticamente
- **Reenviar mensagens com erro** — se uma mensagem falhar, você pode tentar enviar de novo com um clique
- **Busca de contatos** — encontre qualquer contato rapidamente pela barra de pesquisa
- **Iniciar conversa com número novo** — digite um número de telefone na barra de pesquisa (em qualquer formato: com espaços, parênteses, traços, código do país) e inicie uma conversa. O sistema verifica automaticamente se o número possui WhatsApp e já busca o nome do contato

---

### Memória de contatos

A IA lembra de quem está falando e coleta informações automaticamente:

- **Salva informações automaticamente** — quando o cliente menciona nome, email, profissão, empresa ou endereço durante a conversa, a IA salva isso sozinha no banco de dados local
- **Observações e anotações** — adicione notas sobre cada contato manualmente (ex: "cliente VIP", "prefere atendimento pela manhã")
- **Histórico completo** — todas as conversas ficam salvas no banco de dados local e sobrevivem mesmo se você fechar o programa
- **Ligar/desligar IA por contato** — desative a resposta automática para contatos específicos (ex: família, amigos, fornecedores) com clique direito no contato
- **Editar informações** — clique no nome do contato no chat para abrir a ficha e editar nome, email, profissão, empresa, endereço e observações

---

### Configurações

Personalize tudo do jeito que você quiser:

- **Escolher modelo de IA** — escolha qual modelo usar para conversa (com busca por nome)
- **Prompt do sistema** — defina a personalidade e comportamento da IA, com editor em tela cheia para textos longos
- **Testar chave** — verifique se sua chave de API está funcionando antes de salvar
- **Recarregar crédito** — acesse direto o link da sua conta para adicionar crédito quando precisar
- **Tempo de espera** — controle quantos segundos a IA espera antes de responder (para juntar mensagens rápidas do mesmo contato)
- **Resposta automática** — ligue ou desligue a resposta automática a qualquer momento
- **Responder a todos ou só contatos salvos** — escolha se a IA responde para qualquer pessoa ou só para quem já tem cadastro
- **Mensagens de contexto** — defina quantas mensagens anteriores a IA leva em consideração ao responder (mais mensagens = respostas mais inteligentes, porém custam um pouco mais)
- **Mensagens picadas** — ative ou desative a divisão de respostas em várias mensagens, e controle o intervalo entre elas

---

### Conexão com WhatsApp

- **QR Code** — conecte seu WhatsApp escaneando o código, igual ao WhatsApp Web
- **Status em tempo real** — veja se está conectado ou desconectado a qualquer momento
- **Reconectar** — se a conexão cair, reconecte com um clique
- **Desconectar** — desconecte seu WhatsApp do programa quando quiser
- **Reconexão automática** — se o programa detectar que a conexão caiu, tenta reconectar sozinho

---

### Painel de custos

Acompanhe quanto você está gastando com a IA:

- **Custo total** — veja o valor gasto em dólar e em real
- **Filtrar por período** — escolha ver os custos das últimas 24 horas, 3 dias, 7 dias, 30 dias ou um período personalizado
- **Custo por contato** — descubra quais contatos estão gerando mais gasto
- **Separação por tipo** — veja quanto gastou com mensagens de texto, áudio e imagem separadamente
- **Quantidade de chamadas** — acompanhe quantas vezes a IA foi acionada
- **Aviso de saldo baixo** — quando o crédito está acabando, o painel avisa automaticamente e mostra o link para recarregar, para a IA não parar de responder de surpresa

---

### Área de testes (Sandbox)

Teste a IA antes de colocar para funcionar:

- **Conversa de teste completa** — mande mensagens para a IA e veja como ela responde, sem enviar nada pelo WhatsApp. Funciona como um chat de verdade, inclusive com envio de mídia (imagens, áudio, arquivos)
- **Testar prompt** — experimente diferentes personalidades e instruções e veja o resultado na hora
- **Logs em tempo real** — acompanhe o que está acontecendo nos bastidores (útil para resolver problemas)

---

### Sistema de plugins (avançado)

Quem quiser ir além do básico pode adicionar funcionalidades extras sem mexer no núcleo do programa:

- **Ações novas para a IA** — ensine novas habilidades ao assistente (consultar pedidos, agendar horários, buscar no seu sistema, etc.)
- **Filtros de mensagem** — bloqueie palavras-chave, números específicos, ou modifique mensagens antes de salvar/responder
- **Reação a eventos** — execute algo automaticamente quando algo acontece (mensagem recebida, IA respondeu, contato novo, etc.)
- **Telas próprias no painel** — adicione abas customizadas na interface
- **Configurações próprias** — cada plugin pode ter sua tela de configurações

Plugins ficam isolados na pasta `storages/plugins/` e podem ser instalados, ativados, desativados, exportados (`.zip`) ou removidos diretamente pela interface, sem afetar o resto do programa. Atualizar o WhatsBot **não** mexe nos seus plugins.

Para criar um plugin do zero, abra o projeto no Claude Code e rode `/new-plugin` — a IA pergunta o que você quer fazer e gera tudo (código, banco, tela, configurações) automaticamente.

Documentação técnica completa em [CLAUDE.md](CLAUDE.md) (Sistema de plugins, Events e Filters).

---

### Privacidade e segurança

- **Tudo roda no seu computador** — seus dados, conversas e informações de contatos ficam salvos em um banco de dados local na sua máquina
- **Sem servidor externo** — o programa não envia seus dados para nenhum lugar (a única comunicação externa é com a IA para processar as mensagens)
- **Seus dados são seus** — se você apagar o programa, todos os dados vão junto. Ninguém mais tem acesso

---

## O que você precisa

Em qualquer opção, **você não precisa criar conta de IA nem copiar chave** — o assistente de configuração cria sua chave automaticamente na primeira execução, com crédito grátis para começar.

### Opção 1: Windows (direto)
- **Windows 10** ou mais recente
- **Conexão com internet**
- **WhatsApp ativo no celular** — para escanear o QR Code na primeira vez

### Opção 2: macOS (direto)
- **macOS** — dê dois cliques em **start.command** (na primeira vez ele baixa sozinho o que precisa)
- **Conexão com internet**
- **WhatsApp ativo no celular** — para escanear o QR Code na primeira vez

### Opção 3: Docker (Windows, Mac ou Linux)
- **Docker** instalado ([docker.com](https://www.docker.com/get-started))
- **Conexão com internet**
- **WhatsApp ativo no celular** — para escanear o QR Code na primeira vez

---

## Perguntas frequentes

**O WhatsBot é grátis?**
Sim! O programa é 100% gratuito e de código aberto. O único custo é o uso da IA, cobrado por mensagem processada (geralmente centavos por conversa) — sem mensalidade. Na primeira execução você ganha um crédito grátis para testar.

**Como funciona a chave de API?**
Você não precisa criar conta nem copiar chave nenhuma. Na primeira vez, o assistente de configuração conversa com a Techify pelo seu próprio WhatsApp, cria sua conta e gera a chave automaticamente, já com um crédito inicial grátis. Quando o saldo estiver acabando, o painel avisa e mostra o link para recarregar.

**Quanto custa o uso da IA?**
Depende do modelo escolhido e do volume de mensagens. Na prática, a maioria dos usuários gasta menos de R$ 1 por dia. Você acompanha os custos e o saldo em tempo real pelo painel.

**Meus dados ficam seguros?**
Sim. Tudo fica salvo em um banco de dados local no seu computador. O programa não tem servidor próprio — as conversas, contatos e configurações ficam apenas na pasta do WhatsBot na sua máquina.

**Posso usar qualquer modelo de IA?**
Sim. Há dezenas de modelos disponíveis (GPT, Gemini, Claude, Llama, e muitos outros). Você escolhe qual usar na tela de Configurações.

**Posso desligar a IA para alguns contatos?**
Sim. Clique com o botão direito em qualquer contato e escolha "Desativar IA". A IA para de responder para aquele contato, mas você ainda pode enviar mensagens manualmente.

**Funciona com grupos?**
A opção "Responder a todos" inclui mensagens de grupos. Você pode desativar isso nas configurações.

**Preciso deixar o computador ligado?**
Sim. Como tudo roda no seu computador, o programa precisa estar aberto para a IA funcionar.

**O que acontece se a internet cair?**
O programa tenta reconectar automaticamente. Quando a internet voltar, ele retoma o funcionamento normalmente.

**Posso usar no Mac ou Linux?**
Sim! No **Mac**, além do Docker, há um atalho nativo: dê dois cliques em **start.command** (sem precisar de Docker). No **Windows**, use o **start.bat**. E em qualquer sistema (Windows, Mac ou Linux) você pode rodar via **Docker**.

**Quero personalizar algo no programa, como faço?**
O WhatsBot é de código aberto e roda direto do código (sem precisar compilar). Você pode pedir para qualquer ferramenta de IA (como ChatGPT, Claude Code, Cursor, Cowork, etc.) fazer alterações — é só salvar o arquivo, fechar e abrir o iniciar.bat de novo. As mudanças já funcionam. Não precisa saber programar.

**Posso contribuir com o projeto?**
Sim! O WhatsBot é um projeto de código aberto. Contribuições são bem-vindas.

---

## Licença

Projeto de código aberto. Livre para uso pessoal e comercial.

---

Mantido por [Techify](https://github.com/Techify-one) — leia mais em [techify.one/blog](https://techify.one/blog).

whatsbot

whatsbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

whatsbot

whatsbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README