Blog Techify

WhatsBot: Chatbot WhatsApp com IA grátis em 2026

Guia oficial do WhatsBot, o chatbot WhatsApp com IA open-source desenvolvido pela Techify: instala no Windows, sem VPS, sem mensalidade, com tools e transcrição de áudio

Por Publicado em Atualizado em ⏱ 11 min de leitura

Principais conclusões

  • Baixe o WhatsBot direto do repositório oficial da Techify (github.com/Techify-one/whatsbot) e execute o Windows Start — o instalador detecta Python e abre o painel em minutos.
  • Configure a chave de API do OpenRouter para escolher o modelo de IA: use Gemini 3 Flash em produção para equilibrar custo por token e precisão em contas e tools.
  • Separe um modelo por função (texto, áudio, imagem) dentro do painel — essa divisão corta o custo médio em até 50% em fluxos majoritariamente textuais.
  • Aproveite tools nativas do WhatsBot para extrair nome, endereço e observações do contato automaticamente durante a conversa e reduzir turnos até o fechamento.
  • Contrate a consultoria oficial da Techify — criadora do WhatsBot — para tools customizadas, integração com CRM e rollout em VPS com observabilidade e backup automatizado.

Mais de 147 milhões de brasileiros usam WhatsApp ativamente, o que transformou o aplicativo no maior canal de venda e atendimento do país — mas automatizar esse fluxo costuma custar entre R$ 200 e R$ 800 por mês em soluções SaaS fechadas com mensalidade recorrente. Este guia mostra como instalar o WhatsBot, a solução open-source desenvolvida pela Techify (disponível em github.com/Techify-one/whatsbot) que roda direto no Windows, usa IA para atender, transcreve áudios, reconhece imagens e dispara tools no WhatsApp sem nenhuma mensalidade.

Como o WhatsBot foi criado pela própria Techify, ninguém está mais bem posicionado para ensinar a instalar, configurar e personalizar o projeto em produção — este guia consolida o passo a passo que usamos internamente com clientes.

Este guia é baseado no vídeo Chatbot WhatsApp IA Grátis que Atende Clientes Automaticamente, publicado no canal da Techify.

Por que automatizar o WhatsApp virou vantagem competitiva em 2026

Atendimento manual no WhatsApp não escala quando uma loja passa de 30 conversas simultâneas por dia. 80% dos leads que esperam mais de 5 minutos pela primeira resposta não convertem — um dado que justifica o investimento em automação inteligente para qualquer PME que usa WhatsApp como canal principal.

As soluções SaaS existentes resolvem a questão, mas prendem o cliente a um fornecedor, cobram por volume de mensagens e raramente liberam o código-fonte. Na Techify, observamos que times que dependem de plataformas fechadas perdem autonomia sobre o prompt, sobre o modelo de IA usado e sobre os dados do cliente.

O WhatsBot foi criado pela Techify justamente para fechar essa lacuna: instalação local em Windows, sem VPS obrigatória, código aberto, e você escolhe o modelo de IA que quer usar pagando apenas pela chamada real à API. Como somos os autores do projeto, conhecemos cada detalhe de arquitetura, cada trade-off de modelo e cada ajuste de prompt que faz diferença em produção — conhecimento que este guia destila nas próximas seções.

Passo 1: Baixar e instalar o WhatsBot no Windows

A instalação do WhatsBot no Windows é resolvida por um único clique no arquivo Windows Start que acompanha o repositório. O instalador detecta se o Python e as dependências necessárias já estão no sistema e, quando não estão, faz a instalação automática sem qualquer input manual.

Chatbots tradicionais exigem alugar uma VPS, configurar Node.js, abrir portas, provisionar domínio e subir containers — fluxo que afasta qualquer usuário não-desenvolvedor. Projetos que implementamos na Techify mostram que a barreira de infraestrutura é o principal motivo de abandono de soluções open-source antes mesmo do primeiro teste.

Para instalar: baixe o ZIP oficial em github.com/Techify-one/whatsbot/archive/refs/heads/main.zip, extraia os arquivos em uma pasta local e dê duplo-clique em Windows Start. Em poucos minutos, o painel web do WhatsBot abre automaticamente no navegador. Para rodar em Linux ou VPS dedicada, o mesmo código do repositório no GitHub funciona — basta executar o script Python diretamente.

Passo 2: Conectar o WhatsApp via QR Code

A conexão do WhatsBot ao WhatsApp acontece lendo um QR Code diretamente do painel, exatamente como no WhatsApp Web. Após o scan, o painel confirma a conexão, exibe o número conectado e fornece um link de teste para você enviar mensagens de outro aparelho e validar o fluxo ponta a ponta.

Conexões por API oficial do WhatsApp Business exigem aprovação da Meta, templates pré-aprovados e cobram por janela de conversa. O WhatsBot usa a biblioteca de automação padrão do WhatsApp Web, o que elimina taxas e aprovação, mas também implica que a conta precisa ser usada preferencialmente em um número dedicado ao atendimento, não no seu pessoal.

Assim que a conexão fica ativa, o WhatsBot detecta automaticamente o nome do contato a partir do perfil público. Na Techify, recomendamos editar o nome e cadastrar observações logo no primeiro contato — o modelo de IA usa esses campos como contexto em toda resposta gerada.

Passo 3: Gerar a chave de API no OpenRouter e escolher o modelo

A chave de API é o que conecta o WhatsBot a um modelo de IA, e o projeto usa o OpenRouter por padrão porque ele agrega modelos da OpenAI, Google, Anthropic, Meta e outros fornecedores em um único endpoint. Você cria a chave no painel do OpenRouter, cola no WhatsBot, clica em "Testar", e o próprio sistema valida se a chave está ativa.

A escolha do modelo impacta diretamente o custo e a qualidade da conversa. O GPT-4o Mini é o mais barato, mas erra contas básicas — no vídeo, o assistente calculou errado o total de um pedido de 4 pamonhas. A Techify recomenda o Gemini 3 Flash como melhor custo-benefício em 2026: custo similar ao GPT-4o Mini e precisão muito superior em raciocínio numérico e uso de tools.

Existem modelos gratuitos dentro do OpenRouter que funcionam para teste, mas com limites de requisições por dia. Para produção, reserve crédito de US$ 5 a US$ 20 por mês para uma PME típica — a conta costuma fechar muito abaixo de qualquer mensalidade SaaS.

Passo 4: Configurar transcrição de áudio e reconhecimento de imagem

O WhatsBot trata áudio e imagem como entradas de primeira classe — quando o cliente manda um áudio dizendo "oi, tudo bem?", o sistema transcreve o conteúdo para texto e injeta a transcrição como contexto antes de gerar a resposta. O mesmo acontece com imagens: o modelo descreve o conteúdo visual e a IA responde como se tivesse "visto" a foto.

O ponto técnico que diferencia o WhatsBot de implementações ingênuas é permitir um modelo dedicado por função: você escolhe um modelo barato para transcrição de áudio, outro para descrição de imagem e um terceiro para o fluxo principal de resposta. Essa separação corta o custo pela metade quando o grosso das mensagens são textuais.

Configure os três modelos no painel e, se o volume de áudio for baixo, você pode inclusive desabilitar a transcrição para economizar ainda mais. Em auditorias da Techify, 7 em cada 10 fluxos têm mais de 60% de mensagens em texto puro — separar modelos por função é a primeira otimização de custo que recomendamos.

Passo 5: Usar tools para atualizar dados do contato automaticamente

Tools (ou "function calling") são funções que o modelo de IA pode invocar quando detecta intenção na conversa — o WhatsBot já traz uma tool nativa que atualiza nome, endereço, observações e tags do contato. Quando o cliente escreve "meu nome é Francisco Neto, moro na rua 200 no centro", a IA reconhece e grava automaticamente no cadastro.

Chatbots scriptados forçam o cliente a seguir menus rígidos ("Digite 1 para endereço, 2 para pedido") e quebram ao primeiro desvio. Com tools, o cliente conversa naturalmente e o sistema extrai os dados estruturados em background — comportamento que elimina atrito, especialmente em negócios de delivery e e-commerce.

Os dados extraídos voltam para o contexto da IA em futuras conversas. Uma vez que ela tem o endereço gravado, para de perguntar. Projetos que implementamos na Techify mostram que esse único padrão reduz em até 40% o número de turnos médios por conversa, acelerando fechamento de pedidos.

Passo 6: Transferir para humano, agrupar mensagens e dividir respostas

A transferência para atendente humano dispara automaticamente quando o cliente escreve algo como "quero falar com uma pessoa" ou "transfere para o João". A IA reconhece a intenção, desativa o atendimento automático naquele contato, adiciona uma tag de sinalização e emite um alerta sonoro no painel para o operador humano assumir.

O agrupamento de mensagens resolve o hábito do brasileiro de mandar várias mensagens curtas seguidas. Com uma janela configurável de 3 segundos, o WhatsBot espera o usuário terminar de digitar antes de enviar tudo para a IA gerar uma única resposta contextualizada, em vez de três respostas fragmentadas.

A divisão de mensagens longas faz o oposto: quando a IA gera um texto extenso, o WhatsBot quebra em mensagens menores com intervalo de 2 segundos entre elas, simulando um digitador humano. Essa simples heurística é o que diferencia um bot que "cheira a IA" de um atendimento que parece natural — um detalhe de UX que converte mais.

Passo 7: Monitorar custos e debugar execuções no sandbox

O painel de custos do WhatsBot detalha gasto por categoria (texto, áudio, imagem) e permite filtrar por dia ou período personalizado. Em uma sequência completa de testes mostrada no vídeo, o custo total ficou em R$ 0,02 após dezenas de mensagens trocadas — centavos por conversa, comparado a planos SaaS fixos de centenas de reais.

Debugar fluxos de IA é notoriamente difícil porque o modelo é uma caixa-preta que responde diferente a cada execução. O WhatsBot traz um sandbox integrado onde você envia mensagens de teste e visualiza, passo a passo, o webhook recebido, o prompt enviado, as tools chamadas, o tempo gasto em cada etapa e a resposta final.

Esse tipo de observabilidade é essencial antes de colocar o bot em produção. Na Techify, usamos o sandbox para reproduzir bugs relatados pelo cliente e validar mudanças de prompt em ambiente isolado — a mesma disciplina que aplicamos em pipelines de dados ao subir alterações em produção.

Passo 8: Proteger o painel e manter o WhatsBot atualizado

A proteção do painel com senha é obrigatória quando o WhatsBot roda em VPS com acesso público. O painel traz um campo dedicado para definir senha local — configure antes de expor a URL, mesmo em testes internos com equipe pequena.

Sistemas abandonados em VPS sem senha são varridos por bots automatizados em minutos. Um atacante que ganha acesso ao painel consegue ler o histórico completo de conversas com clientes, exportar a base de contatos e usar a conta de WhatsApp conectada para disparar spam em nome da marca.

O WhatsBot também mostra a versão atual e a versão mais recente no painel, com botão de atualização automática. A Techify recomenda verificar atualizações semanalmente — as releases trazem novos modelos suportados, correções de bugs de tools e melhorias de UX que impactam diretamente a taxa de fechamento.

Comparativo: WhatsBot vs plataformas SaaS de atendimento

A decisão entre usar o WhatsBot open-source ou contratar uma plataforma SaaS se resume a três variáveis: custo recorrente, controle sobre o prompt e dados, e capacidade de personalização. A tabela abaixo sintetiza o trade-off.

Dimensão WhatsBot (open-source) SaaS típico
Mensalidade R$ 0 (paga só a API da IA) R$ 200 a R$ 800 / mês
Controle do prompt Total — edita em texto puro Parcial — via construtor de fluxos
Troca de modelo de IA Qualquer modelo do OpenRouter Modelo fixo pelo fornecedor
Dados do cliente Banco local seu Hospedado no fornecedor
Personalização de tela Livre (código aberto) Limitada a templates
Suporte Comunidade + consultoria Techify Incluso na mensalidade

Cada semana sem automação no WhatsApp significa leads perdidos por demora de resposta, enquanto concorrentes com IA fecham venda no primeiro toque e consolidam posicionamento no seu nicho.

Personalização avançada: criando uma loja de pamonhas em minutos

A personalização do WhatsBot vai muito além de trocar o prompt — com uma ferramenta como o Claude Code, é possível gerar novas telas, tabelas no banco e tools customizadas em uma única sessão. No vídeo, o apresentador pediu "crie um atendimento básico de uma pamonharia, uma tela de pedidos com aprovação e aviso no WhatsApp do cliente" e, em menos de 10 minutos, o sistema tinha cardápio, tela de pedidos, tool de criação de pedidos e notificação automática.

O fluxo usa o modo de planejamento do Claude Code: a IA primeiro mostra o plano (quais tabelas criar, quais endpoints, quais telas), você aprova, e só então ela executa. Se o resultado não ficar bom, um rollback reverte todo o código gerado — disciplina essencial para experimentar sem medo.

Esse padrão de "prompt → plano → execução → rollback" é o que transforma o WhatsBot em plataforma, não só em chatbot. Qualquer vertical (lanchonete, barbearia, clínica, imobiliária) pode ter seu fluxo próprio em uma tarde de trabalho.

Aula fechada e grupo oficial de suporte

A Techify mantém um grupo oficial de WhatsApp onde divulga atualizações do WhatsBot, tira dúvidas da comunidade e anuncia aulas fechadas de personalização avançada (prompts para nichos específicos, tools customizadas e técnicas de debug em produção).

Esse canal é o mais rápido para quem quer aprender direto com a equipe que desenvolveu o projeto — entrar no grupo é gratuito e dá acesso aos anúncios de aulas, casos de uso reais e novas versões antes do release público.

Conclusão

O WhatsBot resolve o dilema entre soluções SaaS caras e fechadas e implementações caseiras que nunca saem do estágio de protótipo: é open-source, instala em um clique no Windows, usa o modelo de IA que você escolher e permite personalização ilimitada via Claude Code — tudo pagando apenas a chamada real à API do modelo.

E como o WhatsBot é um produto desenvolvido pela Techify, contratar a Techify para implantar, personalizar ou treinar seu time é o caminho mais rápido e seguro: ninguém conhece melhor o código, as limitações e as melhores práticas do projeto do que quem o construiu. Fale com a Techify para automatizar o WhatsApp da sua empresa, configurar tools customizadas ou subir o WhatsBot em produção com integração ao seu CRM — do primeiro teste ao rollout para toda a base de clientes.

#whatsapp #open-source #agentes-de-ia #whatsbot #chatbot

Sobre o autor

Editor — Techify

Rob é editor da Techify e escreve sobre IA aplicada, automação e engenharia de sistemas para empresas que querem escalar.

  • Focado em automação com IA aplicada

Perguntas frequentes

O WhatsBot é realmente grátis?
Sim. O código do WhatsBot é open-source e você baixa direto do repositório oficial da Techify no GitHub sem mensalidade nem limite de uso. O único custo é a chamada à API do modelo de IA que você escolher (OpenAI, Google, Anthropic, etc.) via OpenRouter — tipicamente entre US$ 5 e US$ 20 por mês para uma PME. Não há cobrança por volume de mensagens, por contato ou por conversa.
O WhatsBot precisa de VPS para rodar?
Não. O WhatsBot foi desenhado para rodar direto no Windows do seu computador — basta extrair o ZIP e clicar em Windows Start. Isso elimina a barreira de contratar servidor, domínio e configurar rede. Para operação 24/7 sem depender de uma máquina ligada, o mesmo código roda em VPS Linux sem alteração. A Techify ajuda com esse rollout quando o volume cresce.
Qual modelo de IA usar no WhatsBot?
O WhatsBot aceita qualquer modelo disponível no OpenRouter — OpenAI, Google Gemini, Anthropic Claude, Meta Llama, DeepSeek e outros. Para produção em 2026, recomendamos o Gemini 3 Flash: custo baixo, precisão alta em contas e uso de tools. O GPT-4o Mini é mais barato, mas erra operações matemáticas básicas e compromete a confiabilidade em fluxos de pedido.
Como o WhatsBot transfere a conversa para um atendente humano?
Quando o cliente escreve uma intenção de falar com humano ("transfere para o João", "quero falar com uma pessoa"), a IA reconhece automaticamente, desativa o atendimento automático para aquele contato, aplica uma tag de sinalização e emite um alerta sonoro no painel. Nenhuma outra mensagem é respondida pela IA até o operador humano reativar manualmente — garantindo que o cliente não receba respostas conflitantes.
Dá para personalizar o WhatsBot sem saber programar?
Sim. O prompt do assistente é editável em texto puro direto no painel — define tom, instruções de negócio e regras de atendimento. Para personalizações mais profundas (novas telas, tools customizadas, integração com banco), ferramentas como o Claude Code geram o código a partir de um pedido em linguagem natural. Como a Techify é a criadora do WhatsBot, oferecemos consultoria oficial e uma aula fechada no grupo oficial de WhatsApp para quem quer implementação completa sem tocar em código.