Como conectar ChatGPT ao WhatsApp grátis usando n8n

Neste guia prático, você vai aprender passo a passo como conectar chatgpt ao whatsapp usando a ferramenta de automação n8n de forma totalmente gratuita. Para executar este projeto de trinta minutos, você precisa ter um computador com Docker, uma conta ativa na OpenAI e um celular para realizar os testes de envio.

O que você vai precisar

Para construir essa integração, certifique-se de providenciar os seguintes requisitos técnicos e de cadastro:

Contas criadas nas plataformas:
- Uma conta de desenvolvedor cadastrada no painel da Meta para acesso à API oficial do WhatsApp.
- Uma conta ativa na plataforma da OpenAI com créditos válidos de API carregados.
Ferramentas instaladas e configuradas:
- O software GitHub ou o site oficial do Docker para baixar o ambiente de execução de contêineres.
- O utilitário de contêiner Docker para rodar a aplicação localmente.
Tempo estimado: Exatamente 30 minutos de dedicação para configurar e testar.
Custo aproximado: R$ 0,00 para executar a aplicação localmente no seu computador e cerca de US$ 5,00 de saldo inicial para pagar o consumo de tokens da API de inteligência artificial.

Passo a passo

Muitas empresas gastam fortunas com plataformas de atendimento prontas quando poderiam aprender como conectar chatgpt ao whatsapp de maneira independente e flexível. Siga detalhadamente cada uma das etapas abaixo para construir o seu próprio fluxo de atendimento automatizado sem intermediários.

Inicie o n8n no seu computador

Abra a aplicação de terminal ou prompt de comando do seu computador para inicializar a imagem do servidor de automação. Você deve executar o comando Docker abaixo, que baixa a imagem oficial da automação, mapeia a porta de rede local e inicializa um túnel seguro de testes fornecido gratuitamente pelo próprio sistema.
```
docker run -it --rm --name n8n -p 5678:5678 -e N8N_ENFORCE_SETTINGS_FILE_FOR_OAUTH=true n8nio/n8n n8n start --tunnel
```
Aguarde a finalização do download da imagem e observe as linhas do log que aparecem no seu console de comandos. Procure por uma linha que indica a URL pública temporária de desenvolvimento com o subdomínio correspondente terminado em “.hooks.n8n.cloud”. Abra o navegador do seu computador e acesse o endereço “http://localhost:5678” para criar as suas credenciais de acesso administrador e acessar o painel gráfico.

Ao final deste passo, você deve ver a tela inicial vazia do editor de fluxos do n8n no seu navegador.
Crie o aplicativo de testes no painel da Meta

Acesse a plataforma de desenvolvimento de aplicativos da Meta e realize o login com as suas credenciais de desenvolvedor. No painel inicial, clique na opção de criar um novo aplicativo, selecione a categoria de uso “Outro” e avance as etapas. Escolha o tipo de aplicativo “Empresa”, preencha o nome de exibição do projeto com o texto “Meu Assistente n8n” e confirme clicando no botão para concluir a criação.

Procure pelo produto chamado “WhatsApp” listado na tela de recursos disponíveis e clique no botão de configuração inicial para associar o serviço de mensagens ao seu aplicativo. O sistema direcionará você para a tela de início rápido, onde serão exibidos dados como identificação de telefone de teste e chaves de acesso. Copie o valor do identificador numérico que está localizado abaixo do campo rotulado como “Identificação do número de telefone”.

Ao final deste passo, você deve ver a tela de início rápido do WhatsApp com os dados do número de teste de envio exibidos.
Configure o Webhook de recepção de dados no n8n

No editor de fluxos, adicione um nó do tipo “Webhook” para gerenciar as notificações de novas mensagens vindas dos servidores de teste. Configure o nó definindo o campo “HTTP Method” como “GET” e escreva o termo “webhook” no campo de edição de caminho. Modifique o campo de resposta de webhook para a opção de usar o nó de resposta e acrescente logo em seguida um nó “Respond to Webhook”, escrevendo a instrução que recupera o token de verificação enviado pela Meta.
```
{{ $json.query["hub.challenge"] }}
```
Crie um segundo nó de webhook configurado especificamente para processar o recebimento dos textos. Defina o campo “HTTP Method” para o valor “POST” e adote o mesmo nome de caminho utilizado anteriormente. Deixe o formato do webhook configurado para responder imediatamente com o código padrão “200” para sinalizar que o servidor recebeu a mensagem. Abaixo, você confere o formato do payload de dados que a Meta envia para este webhook quando uma mensagem é recebida:
```
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "109283746562345",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550100001",
              "phone_number_id": "105938472938475"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Maria Silva"
                },
                "wa_id": "5511999999999"
              }
            ],
            "messages": [
              {
                "from": "5511999999999",
                "id": "wamid.HBgLNTUxMTk5OTk5OTk5OQYVAgIdEhg0N0M1RDREQzg3RDY4Q0E4MDcA",
                "timestamp": "1672531199",
                "text": {
                  "body": "Olá, qual o horário de funcionamento?"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
```
Ao final deste passo, você deve ver dois nós de webhook posicionados no seu editor do n8n, um configurado para o método GET e outro configurado para o método POST.
Valide e conecte o Webhook no painel da Meta

Acesse novamente o painel de configurações do WhatsApp dentro do console de desenvolvedores da Meta para vincular o link externo de processamento. Clique no item “Configuração” no menu esquerdo e selecione a opção de edição de dados do Webhook. Copie o endereço completo de produção gerado no nó “GET” da sua automação, cujo formato segue a estrutura abaixo, e cole no campo de endereço de retorno:
```
https://sua-subdominio-temporario.hooks.n8n.cloud/webhook/webhook
```
Preencha o campo do token de validação com a sua chave personalizada, como por exemplo “meu_token_secreto_123”, e execute a confirmação dos dados inseridos. Clique no botão de gerenciar assinaturas localizado no mesmo bloco de controle de dados e realize a assinatura na opção específica associada ao evento “messages” para dar permissão de envio em tempo real.

Ao final deste passo, você deve ver a tabela de configurações do Webhook preenchida com a sua URL ativa e o status de inscrição no campo de mensagens.
Adicione o nó da OpenAI para processar a mensagem

Clique no símbolo de soma que aparece no fluxo para adicionar um novo componente de processamento diretamente conectado ao seu nó de recebimento do tipo “POST”. Pesquise pela extensão “OpenAI” e adicione o bloco de ações de chat na sua tela de desenho técnico. Selecione o campo de criação de credenciais de acesso de segurança e adicione a sua chave secreta privada fornecida pela plataforma de inteligência artificial.

Defina o modelo de interpretação de dados selecionando a versão rápida “gpt-4o-mini” para garantir respostas dinâmicas com consumo reduzido de créditos da sua conta. No editor de contexto do assistente de inteligência artificial, determine que o comportamento do robô seja predefinido com orientações de sistema para agir de forma educada. Na caixa de dados do usuário, configure o mapeamento de variáveis para repassar o texto exato digitado no aplicativo de mensagens utilizando a expressão de leitura interna do fluxo:
```
{{ $json.body.entry[0].changes[0].value.messages[0].text.body }}
```
Ao final deste passo, você deve ver o nó da OpenAI conectado ao webhook de recebimento, mostrando a estrutura de mensagens configurada e pronta para execução de testes.
Envie a resposta de volta ao WhatsApp usando requisição HTTP

Crie um nó “HTTP Request” no seu editor para fazer a chamada que encaminhará o conteúdo final de texto formatado pelo robô direto ao cliente. Modifique o campo “Method” para o formato “POST” e configure o link de destino da requisição externa de acordo com a URL fornecida pela Meta, substituindo o trecho numérico com o ID do seu número obtido anteriormente:
```
https://graph.facebook.com/v18.0/105938472938475/messages
```
Adicione as credenciais de autenticação no tipo de cabeçalho definindo o nome fixo “Authorization” e informando o valor da palavra “Bearer” seguido da chave temporária disponibilizada no painel de desenvolvedores. Configure o formato dos dados para envio de conteúdo no tipo de carga útil de formato “JSON” bruto e cole a estrutura descritiva de envio do aplicativo:
```
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{ $('Webhook').item.json.body.entry[0].changes[0].value.messages[0].from }}",
  "type": "text",
  "text": {
    "preview_url": false,
    "body": "{{ $json.choices[0].message.content }}"
  }
}
```
Inicie a execução de testes do fluxo usando o botão de ativação de teste do n8n para colocar as conexões em modo de escuta ativa. Envie uma mensagem do seu celular cadastrado de teste para o número virtual configurado no painel da Meta e confira a chegada do retorno automático de mensagem gerada pelo robô.

Ao final deste passo, você deve ver a mensagem gerada pelo ChatGPT impressa na tela de conversa do seu aplicativo do WhatsApp.

Erros mais comuns

Abaixo estão descritos os três problemas mais comuns encontrados por profissionais que tentam realizar essa configuração pela primeira vez, junto aos logs de erro que aparecem no sistema:

Erro ao validar a URL do Webhook na Meta:

{"error":{"message":"The URL couldn't be validated. Response must match hub.challenge value.","type":"OAuthException","code":100}}

Este problema ocorre quando o nó “GET” de verificação do n8n não está configurado para devolver a variável exata enviada nos parâmetros da chamada de verificação da Meta. Certifique-se de ativar o nó de resposta para Webhooks no n8n.

Erro de chave secreta inválida na OpenAI:

{"error":{"message":"Incorrect API key provided: sk-proj-***. You can find your API key at https://platform.openai.com/account/api-keys.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}

Esta falha aponta que a chave de autenticação utilizada no n8n possui caracteres incorretos ou não possui mais créditos válidos. Você deve gerar uma nova chave secreta na interface administrativa do painel da OpenAI.

Erro de token de segurança expirado da API da Meta:

{"error":{"message":"Keep-alive failed or token expired","type":"OAuthException","code":190,"error_subcode":463,"fbtrace_id":"A1b2C3d4E5f6G7h8"}}

Este erro ocorre quando o token de desenvolvimento provisório atinge o limite de 24 horas de validade e é desativado pela Meta. Você precisará atualizar a chave no cabeçalho do nó de requisição HTTP ou criar um token definitivo.

Quanto custa

O custo para manter essa infraestrutura integrada de atendimento é extremamente competitivo quando comparado a soluções comerciais do mercado nacional.

A ferramenta principal de automação n8n possui um custo mensal de R$ 0,00 se você decidir executar o contêiner Docker localmente no seu computador ou servidor próprio. Caso queira colocar esse fluxo para funcionar na nuvem sem interrupções de conexão, você pode alugar um servidor em serviços de nuvem como Railway ou Render por valores baixos que variam entre US$ 5,00 e US$ 7,00 mensais, ou servidores virtuais na DigitalOcean com pacotes que começam por volta de US$ 6,00 ao mês.

A precificação do uso do processador de inteligência artificial da OpenAI é feita de acordo com o consumo real de tokens no modelo gpt-4o-mini, que é a versão de melhor custo-benefício. Os preços de tabela deste modelo ficam em torno de US$ 0,15 para cada milhão de tokens fornecidos na entrada e US$ 0,60 para cada milhão de tokens gerados no texto de saída. Uma interação típica com seu cliente gasta menos de US$ 0,01 de saldo, exigindo apenas uma recarga mínima inicial de créditos de US$ 5,00.

Por fim, a API oficial do WhatsApp Business Cloud garante que as primeiras 1000 sessões de conversas mensais de suporte abertas por usuários sejam completamente livres de cobranças. Se a sua empresa superar essa volumetria de mil interações gratuitas por mês, a Meta cobrará uma tarifa por sessão que varia entre R$ 0,15 e R$ 0,30 para a modalidade de suporte no Brasil. É recomendável consultar as taxas atualizadas de envio no painel de controle do seu gerenciador comercial.

Perguntas frequentes

Se você ainda tiver dúvidas pontuais sobre a implementação do fluxo, as perguntas frequentes abaixo ajudam a esclarecer a operação técnica:

Posso conectar meu número pessoal do WhatsApp de uso diário nesta automação?

Não é recomendável realizar esse procedimento com seu chip telefônico principal ativo de rotina comercial ou pessoal. A API oficial do WhatsApp Cloud oferecida pela Meta exige um número exclusivo que esteja completamente desvinculado de contas comuns do aplicativo para que as mensagens sejam tratadas apenas de forma sistêmica.

Como faço para obter um token de autenticação permanente que nunca expira?

Você precisa ir nas configurações do painel do seu Gerenciador de Negócios da Meta e adicionar um novo Usuário do Sistema administrativo para o projeto. Atribua as permissões de controle necessárias e clique no botão para gerar um token de autenticação de longa duração que não sofra com a expiração automática de 24 horas.

É necessário manter o meu computador pessoal ligado ininterruptamente para o robô funcionar?

Sim, no formato de instalação local executado pelo terminal do Docker, as mensagens dos clientes só serão respondidas se o seu computador estiver ligado e conectado. Caso precise de uma operação ininterrupta, transfira o ambiente do n8n para uma hospedagem virtual em nuvem.

Quais são as limitações de tráfego impostas no número gratuito de testes?

Na conta de desenvolvedor padrão, você tem autorização para disparar mensagens de teste para uma lista de até 5 números de telefones de testes previamente verificados no console. Além disso, existe um limite técnico de controle de tráfego definido em até 250 mensagens por dia no ambiente de testes.

Como fazer o robô ler o histórico de conversas antigas para reter contexto?

Para construir um comportamento de histórico na sua automação, é preciso conectar um módulo de persistência de banco de dados no seu fluxo do n8n. Você pode utilizar nós de armazenamento estruturado como PostgreSQL para buscar o registro de conversas anteriores com base no número de telefone do usuário antes de repassar a instrução para o nó da OpenAI.

Conclusão

Integrar o ChatGPT de forma direta ao aplicativo de mensagens oficial da Meta é o melhor caminho técnico para criar assistentes inteligentes de baixo custo e com total controle sobre o fluxo. Essa independência no desenvolvimento abre espaço para você plugar novas funcionalidades conforme seu negócio cresce, sem taxas mensais abusivas de plataformas terceiras. Se você teve qualquer problema técnico ou dúvida no seu fluxo, compartilhe sua pergunta nos comentários abaixo e vamos conversar!