EXPERTDIGITAL
    Voltar ao blog
    Automações

    Agente de IA no WhatsApp n8n: passo a passo completo para criar

    Por Publicado em 16 min de leitura
    Agente de IA no WhatsApp n8n: passo a passo completo para criar
    Automações

    Agente de IA no WhatsApp n8n: passo a passo completo para criar

    Agente de IA no WhatsApp é um sistema automatizado que combina WhatsApp Business API, plataforma de automação n8n e modelos de linguagem (como GPT-4 ou Claude) para responder mensagens, qualificar leads e executar ações sem intervenção humana. A integração permite atendimento 24/7, redução de até 70% no tempo de resposta e escalabilidade para empresas que recebem alto volume de mensagens diariamente.

    TL;DR — Resumo
    • Configure WhatsApp Business API via provedores como Twilio ou 360dialog (a partir de R$ 89/mês)
    • Instale n8n em servidor próprio ou use versão cloud (US$ 20/mês)
    • Crie webhook para receber mensagens do WhatsApp em tempo real
    • Conecte modelo de IA (OpenAI, Anthropic ou Google) via API
    • Configure contexto, prompts e regras de negócio para respostas personalizadas
    • Teste, ajuste e coloque em produção com monitoramento ativo

    Por que criar um agente de IA no WhatsApp em 2026

    O WhatsApp registrou 2,8 bilhões de usuários ativos mensais em 2026, segundo dados da Meta divulgados em março/2026. No Brasil, 96% da população com smartphone usa o aplicativo diariamente, tornando-o o canal preferencial para comunicação entre empresas e clientes.

    A adoção de agentes de IA no WhatsApp cresceu 340% entre 2024 e 2026, segundo relatório da Gartner (fevereiro/2026). As principais razões para esse crescimento incluem:

    • Redução de custos operacionais: empresas economizam entre 45% e 60% em atendimento humano
    • Disponibilidade contínua: atendimento 24 horas, 7 dias por semana, sem pausas
    • Escalabilidade: capacidade de atender milhares de conversas simultâneas
    • Qualificação automática: filtro de leads antes do contato humano
    • Integração com CRM: registro automático de interações e dados

    Lucas Cruz, founder da Expert Digital e ex-Google, implementou agentes de IA em mais de 180 negócios entre 2024 e 2026, obtendo média de 68% de redução no tempo de primeira resposta e aumento de 34% na taxa de conversão de leads qualificados.

    Pré-requisitos técnicos para começar

    Antes de iniciar a construção do agente, você precisa dos seguintes recursos:

    1. WhatsApp Business API

    Diferente do WhatsApp Business (app gratuito), a API oficial permite integração programática e é obrigatória para automações profissionais. Você não contrata diretamente com a Meta, mas sim através de Business Solution Providers (BSPs) homologados.

    Principais provedores em 2026 e custos aproximados:

    Provedor Custo mensal base Custo por conversa Diferencial
    360dialog € 0 R$ 0,15 - R$ 0,35 Sem mensalidade, pague por uso
    Twilio US$ 0 R$ 0,20 - R$ 0,40 Infraestrutura robusta, multi-canal
    Zenvia R$ 89 R$ 0,18 - R$ 0,32 Suporte em português, fácil configuração
    Infobip US$ 25 R$ 0,16 - R$ 0,30 Melhor para alto volume

    2. Plataforma n8n

    O n8n é uma ferramenta de automação open-source que permite criar workflows visuais sem código. Em 2026, existem duas opções:

    • Self-hosted (auto-hospedado): instalação em servidor próprio (VPS, AWS, Google Cloud, etc.). Custo apenas da infraestrutura (a partir de R$ 45/mês em VPS básica)
    • n8n Cloud: versão gerenciada pela própria n8n. Planos a partir de US$ 20/mês para 2.500 execuções mensais

    3. Modelo de IA (LLM)

    Você precisará de acesso a um modelo de linguagem via API. Opções principais em 2026:

    • OpenAI GPT-4o: US$ 0,15 por 1M tokens de entrada, US$ 0,60 por 1M tokens de saída
    • Anthropic Claude 3.5 Sonnet: US$ 0,30 por 1M tokens de entrada, US$ 1,50 por 1M tokens de saída
    • Google Gemini 1.5 Pro: US$ 0,125 por 1M tokens de entrada, US$ 0,50 por 1M tokens de saída

    Passo 1: Configurar WhatsApp Business API

    1.1
    Escolha e cadastre-se em um BSP

    Para este tutorial, usaremos a 360dialog por não ter mensalidade. Acesse 360dialog.com, crie conta e complete verificação de identidade (processo leva 24-48h).

    1.2
    Configure seu número de WhatsApp Business

    Você precisará de um número dedicado que ainda não esteja registrado em nenhuma conta WhatsApp. Siga o processo de verificação via SMS ou chamada.

    1.3
    Obtenha credenciais da API

    No painel da 360dialog, acesse "API Keys" e gere uma nova chave. Guarde em local seguro: você precisará do API Key e do Phone Number ID.

    1.4
    Configure webhook URL

    Esta URL receberá todas as mensagens recebidas. Deixe em branco por enquanto — preencheremos após configurar o n8n no passo 2.

    Passo 2: Instalar e configurar n8n

    Para este guia, usaremos n8n self-hosted em VPS Ubuntu 22.04. Se preferir usar n8n Cloud, pule para o passo 2.4.

    2.1
    Provisione um servidor VPS

    Recomendação mínima: 2 vCPU, 2GB RAM, 20GB SSD. Provedores: DigitalOcean (US$ 12/mês), Vultr (US$ 10/mês), Contabo (€ 5/mês).

    2.2
    Instale n8n via Docker

    Conecte-se ao servidor via SSH e execute:

    docker run -it --rm \
      --name n8n \
      -p 5678:5678 \
      -e N8N_HOST="seu-dominio.com" \
      -e N8N_PROTOCOL="https" \
      -e NODE_ENV="production" \
      -v ~/.n8n:/home/node/.n8n \
      n8nio/n8n
    
    2.3
    Configure domínio e SSL

    Aponte um domínio (ou subdomínio) para o IP do servidor. Configure Nginx como proxy reverso e instale certificado SSL via Let's Encrypt. O n8n exige HTTPS para webhooks.

    2.4
    Acesse interface do n8n

    Abra https://seu-dominio.com:5678 no navegador. Crie usuário administrador na primeira execução.

    Passo 3: Criar workflow de recebimento de mensagens

    3.1
    Adicione nó Webhook

    No n8n, clique em "+" e busque por "Webhook". Configure método HTTP como POST e caminho como /webhook/whatsapp. Copie a URL gerada (será algo como https://seu-dominio.com/webhook/whatsapp).

    3.2
    Configure webhook no 360dialog

    Volte ao painel da 360dialog, cole a URL do webhook do n8n e defina o Verify Token (qualquer string aleatória). Salve e teste conexão.

    3.3
    Adicione nó Function para extrair dados

    As mensagens chegam em formato JSON complexo. Adicione nó "Code" (JavaScript) após o Webhook para extrair:

    const message = $json.entry[0].changes[0].value.messages[0];
    return {
      from: message.from,
      messageId: message.id,
      timestamp: message.timestamp,
      text: message.text.body,
      name: $json.entry[0].changes[0].value.contacts[0].profile.name
    };
    

    Passo 4: Integrar modelo de IA

    Agora conectaremos um LLM para processar as mensagens e gerar respostas inteligentes.

    4.1
    Obtenha API Key do modelo escolhido

    Para OpenAI: acesse platform.openai.com/api-keys e gere nova chave. Para Anthropic: console.anthropic.com. Para Google: aistudio.google.com.

    4.2
    Configure credenciais no n8n

    No n8n, vá em Settings → Credentials → Add Credential. Busque por "OpenAI" (ou outro modelo) e insira sua API Key.

    4.3
    Adicione nó OpenAI Chat Model

    Adicione o nó após o Function. Configure modelo (recomendo gpt-4o para melhor custo-benefício em 2026), temperatura (0.7 para equilíbrio entre criatividade e precisão) e max tokens (500-1000).

    4.4
    Defina o System Prompt

    No campo "System Message", configure o contexto e comportamento do agente:

    Você é um assistente de atendimento da [SUA EMPRESA].
    Seu objetivo é responder dúvidas sobre [PRODUTOS/SERVIÇOS],
    qualificar interesse do lead e agendar conversas com time comercial.
    
    Regras:
    - Seja cordial mas direto
    - Faça no máximo 2 perguntas por mensagem
    - Quando identificar interesse, pergunte melhor horário para contato
    - Não invente informações: se não souber, diga que verificará com equipe
    - Mantenha respostas com no máximo 3 parágrafos curtos
    
    Informações da empresa:
    - Horário de atendimento: 9h às 18h, segunda a sexta
    - Produtos principais: [LISTE AQUI]
    - Valores: [INFORME SE APROPRIADO]
    

    Passo 5: Enviar resposta de volta ao WhatsApp

    5.1
    Adicione nó HTTP Request

    A 360dialog (e maioria dos BSPs) usa API padrão do WhatsApp. Configure nó HTTP Request com método POST para:

    URL: https://waba.360dialog.io/v1/messages
    Headers:
      D360-API-KEY: [sua-api-key-360dialog]
      Content-Type: application/json
    
    5.2
    Configure body da requisição

    No campo Body (JSON), insira:

    {
      "to": "{{ $('Function').item.json.from }}",
      "type": "text",
      "text": {
        "body": "{{ $('OpenAI Chat Model').item.json.message.content }}"
      }
    }
    
    Dica: Use a sintaxe de expressões do n8n (entre chaves duplas) para referenciar dados de nós anteriores. O auto-complete facilita encontrar campos disponíveis.

    Passo 6: Adicionar memória de contexto

    Para conversas coerentes, o agente precisa "lembrar" mensagens anteriores da mesma pessoa.

    6.1
    Adicione banco de dados

    Use PostgreSQL (recomendado) ou MySQL. No servidor, instale via Docker ou serviço gerenciado (Supabase gratuito oferece 500MB).

    6.2
    Configure credencial no n8n

    Em Credentials, adicione Postgres e preencha host, porta, database, usuário e senha.

    6.3
    Crie tabela de histórico

    Execute SQL para criar estrutura:

    CREATE TABLE whatsapp_messages (
      id SERIAL PRIMARY KEY,
      phone VARCHAR(20),
      role VARCHAR(10),
      content TEXT,
      timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP
    );
    
    6.4
    Recupere histórico antes de chamar IA

    Adicione nó Postgres antes do OpenAI para buscar últimas 10 mensagens do contato:

    SELECT role, content 
    FROM whatsapp_messages 
    WHERE phone = '{{ $('Function').item.json.from }}'
    ORDER BY timestamp DESC 
    LIMIT 10
    
    6.5
    Inclua histórico no prompt

    No nó OpenAI, use campo "Messages" ao invés de apenas System Prompt, combinando histórico recuperado + nova mensagem do usuário.

    6.6
    Salve nova interação

    Após enviar resposta, adicione nó Postgres INSERT para gravar tanto mensagem do usuário quanto resposta da IA no banco.

    Passo 7: Recursos avançados opcionais

    Transferência para humano

    Configure palavras-chave ou comando especial (ex: "atendente humano") que desativa automação e notifica sua equipe via Slack, email ou outro sistema.

    Integração com CRM

    Adicione nós para criar/atualizar leads em HubSpot, RD Station, Pipedrive ou outro CRM sempre que conversa atingir critério específico (ex: interesse confirmado).

    Webhooks de status

    Configure webhook adicional para receber confirmações de entrega e leitura das mensagens, permitindo análises de engajamento.

    Respostas com mídia

    O WhatsApp Business API suporta envio de imagens, PDFs, áudios e vídeos. Útil para catálogos, manuais ou confirmações visuais.

    Botões interativos

    Em 2026, a API suporta botões de resposta rápida e listas interativas, melhorando UX e taxa de conversão em 40-60% segundo dados da Meta (abril/2026).

    Monitoramento e otimização

    Após colocar o agente em produção, acompanhe métricas essenciais:

    • Taxa de resolução automática: % de conversas concluídas sem intervenção humana (meta: acima de 60%)
    • Tempo médio de resposta: deve ficar abaixo de 3 segundos
    • Taxa de transferência: % de conversas transferidas para humano (ideal: 15-25%)
    • Satisfação do usuário: implemente pesquisa rápida ao final (escala 1-5)
    • Custo por conversa: soma de custos de API WhatsApp + modelo de IA + infraestrutura
    Atenção: A Meta pode bloquear números que recebam muitas denúncias de spam. Nunca envie mensagens não solicitadas. Sempre aguarde o usuário iniciar contato ou garanta opt-in explícito em campanhas.

    Custos totais estimados mensais

    Para operação processando 5.000 conversas/mês (média de 6 mensagens por conversa = 30.000 mensagens):

    • WhatsApp Business API: R$ 600 - R$ 1.050 (360dialog, R$ 0,20 média por conversa)
    • n8n self-hosted: R$ 45 - R$ 150 (VPS básica a intermediária)
    • OpenAI GPT-4o: R$ 90 - R$ 180 (média 600 tokens por interação, considerando US$ 5,50 = R$ 1)
    • Banco de dados: R$ 0 - R$ 50 (Supabase grátis ou managed postgres)

    Total estimado: R$ 735 - R$ 1.430/mês para 5.000 conversas, ou R$ 0,15 - R$ 0,29 por conversa completa.

    Comparação: atendente humano (salário + encargos) custa em média R$ 3.500/mês e atende 800-1.200 conversas, resultando em R$ 2,90 - R$ 4,40 por conversa. Economia de 85-95%.

    Aprenda automações avançadas com especialistas

    Este tutorial cobre fundamentos de um agente de IA no WhatsApp. Para dominar automações complexas, integrações multi-plataforma e estratégias de escala, conheça o n8n na Prática, imersão presencial intensiva onde você constrói automações reais com prática guiada e suporte de especialistas.

    Além de WhatsApp, você aprenderá a integrar Google Sheets, CRMs, email marketing, redes sociais e muito mais. Ideal para quem quer implementar automações que realmente geram resultado.

    Prefere aprender online? O Curso Online de n8n na Prática oferece mesmo conteúdo em formato assíncrono, com acesso vitalício e atualizações constantes.

    Se busca criar especificamente um agente de vendas completo sem programação, veja Crie seu Vendedor de IA sem Programar, curso focado em conversão e qualificação automatizada.

    Perguntas frequentes

    Posso usar meu número pessoal do WhatsApp para o agente de IA?

    Não. O WhatsApp Business API exige número dedicado que nunca foi registrado em conta WhatsApp comum. Se você já usa um número no WhatsApp pessoal ou Business (app), precisará de outro número exclusivo para API. Não há como migrar número existente para API sem perder histórico.

    Quanto tempo leva para configurar um agente funcional do zero?

    Com conhecimento técnico básico e seguindo este tutorial, entre 4-8 horas para versão simples funcional. Isso inclui criação de contas, configuração de servidor, workflow básico e testes. Recursos avançados (memória, CRM, botões) adicionam 3-6 horas. Aprovação da conta WhatsApp Business pode levar 24-72h.

    O agente funciona com áudios e imagens enviadas pelos usuários?

    Sim, mas requer processamento adicional. Para áudios, você pode usar API de transcrição (Whisper da OpenAI custa US$ 0,006/minuto em 2026) e converter para texto antes de enviar ao LLM. Para imagens, GPT-4o e Claude 3.5 Sonnet têm visão computacional nativa e podem "ver" imagens enviadas, útil para análise de documentos ou produtos.

    Como evitar que o agente invente informações falsas (alucinações)?

    Configure system prompt detalhado com instruções claras de quando dizer "não sei"; forneça base de conhecimento específica via RAG (Retrieval Augmented Generation) conectando documentos/FAQ da empresa; use temperatura baixa (0.3-0.5) para respostas mais conservadoras; implemente camada de validação que detecta respostas incertas e transfere para humano.

    Posso criar agente multilíngue que detecta idioma automaticamente?

    Sim. Modelos como GPT-4o e Claude 3.5 Sonnet identificam idioma automaticamente e respondem na mesma língua. No system prompt, instrua: "Detecte o idioma da mensagem e responda no mesmo idioma. Idiomas suportados: português, inglês, espanhol." Funciona bem para até 5-6 idiomas simultaneamente sem perda significativa de qualidade.

    Qual a diferença entre usar n8n e ferramentas como Manychat ou Chatfuel?

    Manychat e Chatfuel são plataformas focadas especificamente em chatbots com interface visual simples, mas limitadas em integrações e lógicas complexas. N8n é plataforma de automação genérica muito mais flexível: permite integrar centenas de serviços, criar lógicas condicionais avançadas, processar dados complexos e customizar completamente comportamento. Trade-off: n8n tem curva de aprendizado maior mas oferece infinitamente mais possibilidades.

    Domine automações com n8n e IA

    Este artigo mostrou como criar um agente de IA no WhatsApp do zero. Mas este é apenas o começo do que você pode construir com n8n e automações inteligentes.

    No n8n na Prática, você vai além: aprende a criar automações completas para marketing, vendas e operações, integrar dezenas de ferramentas e construir sistemas que realmente escalam seu negócio.

    A imersão presencial oferece prática guiada e suporte de especialistas para você sair implementando automações imediatamente. Vagas limitadas por turma.

    Quero dominar n8n na prática →

    Quer aplicar isso na prática?

    Claude e ChatGPT na Prática — Bauru

    Bauru/SP · 16, 17 ou 18 de Outubro · 8h

    Quero Minha Vaga Agora
    Cursos para Este Tema
    Agenda Presencial
    Online ao Vivo