Conecte a API Oficial do WhatsApp ao N8N com IA (Gemini): Tutorial Completo

---

Quer automatizar o atendimento de um número oficial do WhatsApp com a inteligência artificial do Google Gemini, tudo de graça e dentro do N8N?

Neste artigo, vamos construir do zero um fluxo completo que não só responde mensagens, mas também lida com o processo de autenticação exigido pela Meta. Você vai entender a lógica por trás dos webhooks GET e POST e como configurá-los corretamente para uma operação sem falhas.

Bora pra ação!

O Que Você Vai Precisar (Pré-requisitos)

• N8N Instalado: Nossa plataforma de automação onde toda a mágica acontece.
• Conta no Facebook Developers: Essencial para criar seu aplicativo e acessar a API do WhatsApp.
• Número de API Oficial do WhatsApp: Você precisa já ter um número conectado ao seu aplicativo da Meta. Se ainda não tem, confira o vídeo no link de apoio acima.

O Segredo da API Oficial: A Autenticação com Dois Webhooks

Diferente de outras APIs, a Cloud API da Meta exige um processo de autenticação em duas etapas para garantir que seu webhook é seguro. Para isso, nosso fluxo no N8N precisará de dois nós de Webhook apontando para o mesmo caminho (Path):

1. Webhook GET: Usado apenas uma vez, para autenticação. A Meta envia um "desafio" (challenge) e espera que seu webhook devolva esse mesmo desafio como resposta. Se a resposta for correta, a rota é validada.
2. Webhook POST: Após a autenticação, todas as interações (mensagens recebidas, status de entrega, etc.) são enviadas para este webhook. É aqui que nosso chatbot vai trabalhar.

Passo 1: Configurando a Autenticação (O Webhook GET)

O primeiro passo é dizer para a Meta que nosso webhook está pronto para receber o desafio de autenticação.

1. Adicione um nó Webhook ao seu fluxo.
2. No painel de configurações:
   • Authentication: None
   • HTTP Method: GET
   • Path: Dê um nome único, por exemplo, waba-hook. Anote este nome.
3. Agora, adicione um nó Respond to Webhook e conecte-o ao nó Webhook GET.
4. Na configuração do nó de resposta, vamos retornar o desafio da Meta dinamicamente. Clique em "Add Expression" no campo Body e insira a seguinte expressão:

   {{ $json.query['hub.challenge'] }}

5. Em Response Code, mantenha 200.

Passo 2: Recebendo as Mensagens (O Webhook POST)

Com a autenticação pronta, vamos configurar o webhook que receberá as mensagens.

1. Adicione um segundo nó Webhook ao seu fluxo.
2. Nas configurações:
   • Authentication: None
   • HTTP Method: POST
   • Path: Use exatamente o mesmo nome do passo anterior (ex: waba-hook).

Passo 3: Adicionando a Inteligência Artificial (Gemini)

Agora, vamos conectar a IA para processar as mensagens recebidas.

1. Adicione um nó AI Agent e conecte-o ao Webhook POST.
2. Configure o nó:
   • Chat Model: Selecione Gemini.
   • Credential: Conecte sua credencial do Google AI Studio.
   • Prompt (Expression): Mapeie o texto da mensagem recebida. A expressão correta é:

     {{ $json.body.entry[0].changes[0].value.messages[0].text.body }}

   • Memory: Selecione Simple Memory para que a IA se lembre do contexto da conversa.
   • Memory Key (Expression): Use o número do remetente como chave única. A expressão é:

     {{ $json.body.entry[0].changes[0].value.messages[0].from }}

Passo 4: O Pulo do Gato - Filtrando Apenas Mensagens de Texto

A API da Meta envia vários eventos (status de leitura, entrega, etc.), que causariam erros se fossem enviados para a IA. Vamos usar um nó IF para processar apenas mensagens de texto.

1. Adicione um nó IF entre o Webhook POST e o nó AI Agent.
2. Configure a condição para verificar o tipo de mensagem:
   • Value 1 (Expression): {{ $json.body.entry[0].changes[0].value.messages[0].type }}
   • Operation: String > Equals
   • Value 2: text
3. Agora, o fluxo só continuará para a IA se a condição for verdadeira (TRUE).

Passo 5: Enviando a Resposta de Volta via WhatsApp

A IA gerou a resposta. Vamos enviá-la de volta para o usuário.

1. Adicione um nó WhatsApp Business e conecte-o após o nó AI Agent (na saída do IF).
2. Conecte sua credencial da API Oficial do WhatsApp.
3. Configure os campos:
   • Operation: Message > Send
   • To (Expression): Mapeie o número de quem enviou a mensagem original.

     {{ $json.body.entry[0].changes[0].value.messages[0].from }}

   • Message Type: Text
   • Body (Expression): Mapeie a resposta gerada pela IA.

     {{ $('AI Agent').json.output }}

Passo 6: Ativando para Produção

Seu fluxo está pronto! Para colocá-lo para rodar de verdade:

1. Ative o workflow no botão "Active" no canto superior do N8N.
2. Copie a URL de Produção do seu Webhook GET.
3. Vá até o painel do seu aplicativo no Facebook Developers > WhatsApp > Configuração.
4. Na seção de Webhooks, clique em "Editar".
5. Cole a URL de Produção no campo "URL de Callback" e crie um "Token de verificação" (pode ser qualquer senha, como 123456).
6. Clique em "Verificar e Salvar". Se tudo estiver correto, a Meta fará a chamada GET, seu fluxo responderá e a rota será validada!

Por que Você Precisa de uma Interface? A Solução Z-PRO

A API Oficial do WhatsApp é poderosa, mas não tem uma interface gráfica. Você não consegue ver o histórico de conversas ou intervir manualmente. É aí que uma plataforma profissional se torna essencial.

O Z-PRO é nosso sistema SaaS Omnichannel que já vem preparado para se integrar perfeitamente com a API Oficial. Com ele, você obtém:

• Uma caixa de entrada unificada para visualizar todas as conversas.
• Integração com múltiplos canais: Instagram, Facebook, SMS, Webchat e mais.
• Conexão nativa com diversas IAs, incluindo o fluxo que você acabou de criar no N8N.
• Um CRM completo e a possibilidade de fazer e receber ligações.

Se você quer não só usar, mas revender uma solução de atendimento robusta e completa, conheça o Z-PRO.

Forte abraço, beijo no coração de todos, fiquem com Deus! Qualquer dúvida é só chamar.