Como criar chatbot whatsapp com n8n 100% grátis com IA

Neste tutorial prático, você vai aprender como criar chatbot WhatsApp com n8n integrado à inteligência artificial do gpt-4o-mini da OpenAI sem gastar nada. Você precisa apenas de um computador com Node.js instalado, uma conta de desenvolvedor da Meta e quarenta minutos de dedicação para concluir a configuração.

O que você vai precisar

Para executar este projeto do início ao fim, certifique-se de ter os seguintes itens à disposição no seu computador:

Uma conta ativa no portal Meta Developer para gerenciar as credenciais oficiais de envio de mensagens do WhatsApp.
Uma chave de API gerada no painel oficial da OpenAI para alimentar as respostas do agente de inteligência artificial.
O ambiente de execução Node.js instalado localmente na versão LTS 20 ou em uma versão superior compatível com o seu sistema operacional.
Uma conta criada no ngrok para realizar o redirecionamento de tráfego de rede externo para a sua máquina local de desenvolvimento.
Tempo estimado de execução: 40 minutos.
Custo aproximado do projeto: R$ 0 reais utilizando apenas as camadas gratuitas de testes e créditos iniciais de desenvolvimento.

Passo a passo de como criar chatbot WhatsApp com n8n

Prepare o seu ambiente de desenvolvimento local e inicie os servidores

O primeiro passo consiste em preparar o ambiente no qual o fluxo do n8n e o redirecionamento público de rede vão funcionar. Abra o seu terminal de comandos padrão e instale o pacote global do n8n utilizando o gerenciador de pacotes npm.

Adicionalmente, você precisa do utilitário ngrok para abrir uma porta local segura para receber as chamadas de webhook que o Facebook enviará a cada nova mensagem recebida. Com o terminal aberto, execute a sequência de comandos descrita abaixo para iniciar o ecossistema.
```
npm install -g n8n ngrok
n8n start
ngrok http 5678
```
Mantenha as duas janelas do terminal abertas e funcionando em segundo plano durante todo o período de testes. Você deve ver na tela o endereço público gerado pelo ngrok apontando para o seu localhost na porta 5678.
Crie o aplicativo de testes na plataforma de desenvolvedores da Meta

Acesse a plataforma de desenvolvedores da Meta com as suas credenciais pessoais ou de empresa. Clique no botão “Meus aplicativos” localizado no canto superior direito e depois clique em “Criar aplicativo” para iniciar a integração.

Selecione a opção “Outro” para ter acesso a todas as APIs disponíveis e avance para a próxima página de configuração. Escolha o tipo de aplicativo “Empresa”, preencha o campo de nome do aplicativo com o identificador de sua preferência e finalize clicando em “Criar aplicativo”.

Na tela de seleção de produtos do aplicativo, role até encontrar a caixa correspondente ao WhatsApp e clique em “Configurar” para criar o seu ambiente temporário de envio. Você deve ver na tela a página inicial do produto contendo o “Phone Number ID” do seu número de teste e o token temporário de acesso.
Monte o fluxo de webhook de recepção e validação no n8n

Abra o painel do seu n8n local digitando o endereço fornecido no seu navegador de internet de preferência. Clique no botão “Add first step” e selecione o nó “Webhook” para capturar as mensagens de entrada do chat.

Configure o nó Webhook definindo o método HTTP como “GET” para realizar a validação inicial do token que o Facebook exige durante o cadastro do webhook. Mude a opção “Respond” para “Using Respond to Webhook Node” e crie um nó subsequente chamado “Respond to Webhook” no fluxo.

Para aprender como tratar objetos em formato JSON no n8n, você pode ler a documentação técnica da Mozilla sobre estruturas de dados web. No corpo do nó de resposta, insira a expressão exata contendo o parâmetro de desafio enviado pela Meta.
```
{
  "respondWith": "text",
  "responseBody": "={{ $json.query['hub.challenge'] }}"
}
```
Você deve ver os dois nós conectados na tela de desenho do fluxo com um círculo verde indicando que o ponto de entrada está ativo.
Conecte a URL do seu webhook local no painel do WhatsApp

Copie a URL de produção do seu webhook gerada no painel do n8n, lembrando de substituir a parte inicial do localhost pelo endereço fornecido pelo túnel do ngrok. Volte ao painel de desenvolvedores da Meta e clique no menu lateral esquerdo em “Configuração” abaixo da aba do WhatsApp.

Clique em “Editar” na seção de configuração de webhooks para abrir o formulário de associação externa. Cole a URL de produção copiada do n8n no campo de URL de retorno e defina uma senha de segurança de sua escolha no campo de token de verificação.

Para concluir, configure o mesmo token de verificação dentro dos parâmetros do seu nó de webhook no n8n para que a validação mútua funcione corretamente. Você deve ver o status do webhook ativo no painel da Meta após clicar no botão “Salvar e verificar”.
Adicione o agente de inteligência artificial da OpenAI ao seu fluxo

Adicione um nó do tipo “AI Agent” logo após o recebimento das requisições do tipo “POST” que o WhatsApp enviará sempre que uma nova mensagem for gerada. Arraste um nó “OpenAI Chat Model” e conecte-o diretamente ao conector inferior do seu agente.

Para baixar os arquivos e pacotes de integração necessários, você pode conferir o repositório público no GitHub do n8n onde toda a comunidade contribui com melhorias de código. Insira a sua chave secreta de desenvolvimento da OpenAI e selecione o modelo gpt-4o-mini na lista de opções.

No painel lateral de configurações do nó do agente, localize a caixa destinada ao prompt do sistema e insira a instrução exata de comportamento que guiará a conversa do robô.
```
Você é um assistente virtual profissional focado em sanar dúvidas de clientes.
Responda de maneira direta, assertiva e evite textos excessivamente longos.
Limite todas as suas respostas a no máximo três linhas de conteúdo textual.
Nunca utilize caracteres especiais que possam quebrar a visualização no smartphone.
```
Você deve ver o nó do agente com as conexões devidamente estabelecidas, exibindo o status de pronto para execução.
Configure o nó de disparo de mensagem de resposta para o usuário

Crie um nó do tipo “HTTP Request” no painel do n8n para enviar a resposta formulada pela inteligência artificial de volta para os servidores do WhatsApp. Mude o método de requisição para “POST” e insira a URL de destino da API de mensagens.

Substitua o termo identificador pelo ID do seu número obtido no painel de desenvolvedores da Meta. Adicione o cabeçalho de autenticação denominado “Authorization” contendo a palavra “Bearer” seguida do seu token de acesso.

Configure a carga útil do JSON de envio definindo os parâmetros de destino e o conteúdo dinâmico gerado pelo assistente virtual de inteligência artificial no passo anterior.
```
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{ $json.message.from }}",
  "type": "text",
  "text": {
    "preview_url": false,
    "body": "{{ $json.output }}"
  }
}
```
Você deve ver a mensagem de teste enviada do seu smartphone ser respondida pelo robô do n8n de forma totalmente automatizada no chat.

Erros mais comuns

Durante a montagem e os primeiros testes práticos com o robô, falhas de conectividade e de formatação de cabeçalhos podem interromper o processamento das mensagens. Veja abaixo as três falhas mais comuns e suas respectivas mensagens de erro extraídas dos logs.

Chave de API inválida ou sem fundos na conta OpenAI

O erro ocorre quando a chave secreta inserida no nó da OpenAI foi digitada incorretamente ou quando a conta de testes esgotou o limite de saldo disponível para novas consultas.

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Token do WhatsApp Business Cloud API expirado

Esse comportamento acontece rotineiramente porque o token fornecido de forma inicial no painel do Meta Developer possui expiração curta de apenas 24 horas a partir de sua criação.

{
  "error": {
    "message": "Invalid OAuth access token - Cannot parse access token",
    "type": "OAuthException",
    "code": 190,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Signature verification failed"
    }
  }
}

Falha de verificação por resposta inadequada do webhook

A falha ocorre no painel de desenvolvedores do Facebook caso o seu nó de resposta do n8n não devolva especificamente a string do desafio enviada pela requisição GET inicial.

{
  "error": {
    "message": "The Webhook verification failed because the challenge response did not match.",
    "type": "HookValidationException",
    "code": 100,
    "fbtrace_id": "D9F8E7D6C5B4A3"
  }
}

Quanto custa

Iniciar o desenvolvimento de um assistente virtual utilizando a metodologia apresentada neste guia possui custo imediato de zero reais. O n8n executado de maneira local não realiza nenhuma cobrança e o utilitário de túnel ngrok disponibiliza um plano de uso individual totalmente gratuito.

Para cenários comerciais de maior escala, o plano pago mais barato de hospedagem na nuvem para o n8n gira em torno de US$ 20.00 dólares mensais nas plataformas oficiais de cloud. As taxas de cobrança por uso da API de linguagem natural da OpenAI para o modelo gpt-4o-mini custam aproximadamente US$ 0.15 dólares por milhão de tokens de entrada. Recomendamos acompanhar a tabela atualizada diretamente na página de preços da plataforma para verificar alterações.

A API oficial do WhatsApp da Meta possui uma política comercial que oferece as primeiras 1.000 conversas de cada mês de maneira gratuita para o usuário do sistema. Conversas adicionais de atendimento iniciadas pelos clientes após ultrapassar o limite gratuito possuem tarifas variáveis estimadas em US$ 0.03 dólares por sessão de atendimento.

Perguntas frequentes

Como posso gerar um token permanente que não expire após 24 horas?

Você precisa acessar as configurações de negócios da Meta e criar um usuário do sistema com a função de administrador do sistema de mensagens. Gere um token permanente associado a esse usuário específico e utilize este novo identificador de forma definitiva no nó do n8n.

É possível usar o mesmo número do meu WhatsApp pessoal no robô?

Não é recomendado utilizar o número de uso pessoal por questões de concorrência de mensagens do aplicativo. A API de nuvem do WhatsApp assume o controle total do tráfego do número e impede o uso simultâneo do aplicativo padrão no seu smartphone.

O assistente de inteligência artificial consegue se lembrar do que foi dito antes?

Sim, o nó de agente de inteligência artificial do n8n possui suporte para conexão de memória persistente. Você deve arrastar o nó “Window Buffer Memory” para dentro do conector de memória para que o robô consiga ler as mensagens anteriores.

O túnel do ngrok muda de endereço sempre que eu reinicio o meu computador?

Sim, as contas gratuitas do ngrok geram um endereço dinâmico diferente a cada inicialização do terminal do sistema. Para evitar a necessidade de reconfigurar a URL no painel da Meta constantemente, configure uma conta paga ou defina um domínio estático gratuito no painel deles.

Posso conectar outras ferramentas de banco de dados no fluxo do n8n?

Sim, o n8n possui conectores integrados nativos para diversos sistemas de gerenciamento de banco de dados do mercado. Você pode salvar os dados dos clientes e os históricos em ferramentas estruturadas criando nós paralelos à entrega da resposta.

Conclusão

A união do n8n com a API de mensagens do WhatsApp e os recursos avançados de modelos de linguagem da OpenAI forma uma ferramenta excelente para automação de atendimento de clientes sem custo inicial. Toda a estrutura de testes apresentada serve como base segura para escalar o seu negócio de atendimento automático.

Se você encontrou alguma dúvida durante o processo de configuração do fluxo, comente aqui embaixo para que possamos trocar experiências sobre a ferramenta.