Como criar bot WhatsApp: passo a passo do planejamento ao ar

Dá para criar bot WhatsApp numa tarde com uma ferramenta de arrastar blocos. Também dá para passar três meses construindo um assistente com IA integrado ao ERP. Os dois são “bots de WhatsApp”, e a diferença entre eles está menos na tecnologia e mais no planejamento.

Este guia mostra o caminho completo para criar bot WhatsApp para uma empresa: do papel ao servidor, passando pelas decisões que mais pesam no resultado. Serve tanto para quem quer fazer sozinho quanto para quem vai contratar e quer saber o que perguntar.

Eu crio bots de WhatsApp na yourobot e tenho um bot em Node.js com Docker publicado no meu GitHub. Os passos abaixo são, basicamente, a ordem em que eu trabalho.

Antes de tudo: o que o bot vai resolver?

O erro mais comum é começar pela ferramenta. Comece pelo problema. Responda por escrito:

• Qual tarefa repetitiva o bot vai assumir? Exemplo: confirmar consultas do dia seguinte.
• Quem vai usar? Clientes, funcionários, fornecedores?
• De onde vêm as informações? Agenda, ERP, planilha, cabeça do dono?
• Quando o bot deve chamar um humano?
• Como você vai saber se deu certo? Menos faltas, menos mensagens manuais, resposta mais rápida.

Se você não consegue responder a terceira pergunta, o projeto ainda não é um bot. É organização de dados, e talvez uma planilha bem feita resolva primeiro.

Passo 1: desenhe o fluxo da conversa

Pegue papel, um quadro ou uma ferramenta de diagrama e desenhe a conversa ideal. Para cada mensagem do cliente, o que o bot responde? E se o cliente responder algo inesperado?

Um fluxo de confirmação de consulta, por exemplo:

1. Bot envia: lembrete com data, horário e dois botões, Confirmar e Remarcar.
2. Cliente toca em Confirmar: bot agradece e marca como confirmado na agenda.
3. Cliente toca em Remarcar: bot mostra horários livres.
4. Cliente escreve texto livre: bot encaminha para a recepção.

Desenhar antes evita o bot que entra em loop ou que não sabe sair de uma situação.

Passo 2: escolha a forma de conexão

Existem três caminhos principais:

Caminho	Prós	Contras
API oficial direto com a Meta	Estável, sem risco de bloqueio por automação, recursos completos	Exige conta verificada, modelos aprovados e desenvolvimento
Provedor (BSP) sobre a API oficial	Painel pronto, suporte, menos configuração	Custo do provedor somado ao da Meta, menos controle
Biblioteca não oficial	Rápido e barato para testar	Viola os termos de uso, risco de banimento do número

Para atendimento e envio a clientes, eu recomendo a API oficial, direta ou por um provedor. Os detalhes estão em WhatsApp Business API: o que é.

Passo 3: escolha como construir

Ferramentas sem código

Plataformas visuais de fluxo resolvem bots de menu e notificação simples. São boas para validar uma ideia. O limite aparece quando você precisa de lógica mais complexa ou de integração com um sistema que a plataforma não suporta.

Ferramentas de automação com pouco código

O n8n, por exemplo, permite montar fluxos que recebem o webhook do WhatsApp, consultam APIs e respondem, com a opção de escrever trechos de código quando necessário. É um meio-termo bom para muita empresa pequena.

Código próprio

Um serviço em Node.js ou Python recebendo os webhooks e chamando a API. Dá controle total sobre regras, integrações e custos. É o caminho que eu uso quando o bot é parte central da operação, porque fica mais fácil testar, versionar e manter.

Passo 4: monte a estrutura técnica

Para quem vai pela API oficial com código próprio, a estrutura mínima é:

1. Conta no Meta Business verificada e um número dedicado ao WhatsApp Business Platform.
2. Aplicativo na Meta for Developers com o produto WhatsApp configurado e um token de acesso.
3. Servidor com HTTPS para receber os webhooks. Pode ser uma VPS, um serviço de nuvem ou até um container Docker num servidor seu.
4. Endpoint de webhook que valida a assinatura da Meta e processa as mensagens recebidas.
5. Banco de dados para guardar o estado de cada conversa e o histórico.
6. Modelos de mensagem aprovados para iniciar conversas com o cliente, como lembretes e cobranças.

Rodar em Docker ajuda muito: o mesmo ambiente roda no seu computador e no servidor, e atualizar vira trocar um container.

Passo 5: conecte com seus sistemas

O bot fica útil de verdade quando conversa com o resto da empresa:

• ERP (Bling, Tiny, Omie) para status de pedido, estoque e notas.
• Agenda para consultar e marcar horários.
• Financeiro para segunda via e confirmação de pagamento.
• Planilhas quando é ali que a informação vive hoje.

Na yourobot eu faço essas integrações com frequência. A regra que sigo: o bot só executa ações específicas e validadas, nunca tem acesso livre aos dados. Isso protege contra erro de interpretação e contra abuso.

Passo 6: adicione IA, se fizer sentido

Se as perguntas dos clientes são muito variadas, um modelo como Claude ou GPT pode interpretar a mensagem e escolher a ação certa. Mas IA não é obrigatória. Muitos bots excelentes são só fluxos bem desenhados com botões.

Se for usar, siga três cuidados: limite o que a IA pode responder, faça ela consultar só as suas fontes e garanta uma saída para humano. Mais sobre isso em IA no atendimento ao cliente.

Passo 7: teste, publique e monitore

Antes de ligar para todos os clientes:

• Teste com números da equipe, tentando quebrar o fluxo de propósito.
• Libere para um grupo pequeno de clientes por uma ou duas semanas.
• Leia as conversas reais e ajuste.
• Configure alertas para quando o bot parar de responder. Eu uso Zabbix para monitorar sistemas 24/7, e bot é um dos que mais merecem esse cuidado.

Erros que eu vejo com frequência

• Mandar mensagem em massa pelo número pessoal com biblioteca não oficial. Bloqueio quase certo.
• Texto longo demais. Ninguém lê parágrafo de cinco linhas no celular.
• Não ter dono. Alguém precisa ser responsável por revisar o bot e atualizar as respostas.
• Deixar acessos no nome do desenvolvedor. Código, conta da Meta e domínio devem estar no nome da empresa. É assim que eu entrego.

Perguntas frequentes

Preciso saber programar para criar bot WhatsApp?

Para um bot simples de menu, não: ferramentas visuais resolvem. Para integrar com ERP, usar IA ou ter controle total, conhecer programação ou contratar quem conheça faz diferença.

Qual linguagem é melhor para um bot de WhatsApp?

Node.js e Python são as mais comuns e têm boas bibliotecas para HTTP e para as APIs de IA. A melhor é a que a sua equipe consegue manter.

Quanto custa manter um bot no ar?

Os custos vêm do servidor, da cobrança da Meta conforme a tabela oficial, de um eventual provedor e do modelo de IA, se houver. O total depende do volume de conversas e das integrações.

Posso testar sem gastar?

A Meta oferece um número de teste no ambiente de desenvolvedor, útil para validar o fluxo antes de conectar o número real.

Próximo passo

Se você quer entender melhor a parte conceitual antes de construir, leia bot WhatsApp: como funciona. Se prefere que alguém cuide do projeto inteiro, veja como funciona o serviço de automação de WhatsApp e me chame pela página de contato. Mando proposta com escopo, prazo e preço fechado em até 3 dias úteis.