Configuração de Webhooks

⚡ Performance: Webhook vs Polling

⚙️ Passo 4: Configurar Webhook no Business Manager

Agora vamos conectar o WhatsApp ao N8N configurando o webhook:

1. No campo "URL do Webhook", cole a URL do N8N

   ✅ Formato correto

   https://seu-n8n.app/webhook/whatsapp-webhook

   ❌ Formatos incorretos

   http://... (deve ser HTTPS)

   localhost:5678/... (deve ser público)

   192.168.1.1/... (deve ser público)
2. No campo "Token de Verificação", crie um token único

   🔐 Sugestão de token

   Copiar

   Importante: Guarde esse token! Você precisará dele no N8N.

3. Selecione os "Campos de Webhook" que quer receber:
   messages - Mensagens recebidas (obrigatório)message_deliveries - Status de entregamessage_reads - Status de leituramessage_reactions - Reações (opcional)
4. Clique em "Verificar e Salvar"

   🔄 O que acontece na verificação

   O WhatsApp fará uma requisição GET para sua URL com parâmetros de verificação. Seu N8N precisa responder corretamente para a verificação passar.

💬 Passo 4: Processar Mensagens Reais

Na saída "1" (mensagem) do Switch, vamos processar as mensagens que chegam:

1. Adicione um node "Set" para extrair dados da mensagem

   Campos a extrair:

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

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

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

   message_id: {{ $json.body.entry[0].changes[0].value.messages[0].id }}
2. Adicione um node "Function" para processar a lógica:

   // Processar mensagem WhatsApp
   const message = $input.item.json.message.toLowerCase();
   const from = $input.item.json.from;
   
   // Lógica de resposta automática
   let response;
   if (message.includes('oi') || message.includes('olá')) {
     response = 'Olá! 👋 Como posso ajudar você hoje?';
   } else if (message.includes('preço') || message.includes('valor')) {
     response = 'Nossos preços começam em R$ 50. Quer saber mais detalhes?';
   } else if (message.includes('horário') || message.includes('funcionamento')) {
     response = 'Funcionamos de segunda a sexta, das 9h às 18h. 🕘';
   } else {
     response = 'Interessante! Pode me contar mais sobre isso? Ou digite "menu" para ver opções.';
   }
   
   return {
     to: from,
     reply: response,
     processed_at: new Date().toISOString(),
     original_message: $input.item.json.message
   };

3. Adicione um node "Respond to Webhook" para confirmar recebimento:
   Response Code: 200

   Response Body: {"status": "received"}

   WhatsApp precisa receber status 200 para confirmar que a mensagem foi entregue com sucesso.

🔬 Teste 4: Analisar Dados Recebidos

Vamos examinar em detalhes os dados que o WhatsApp está enviando para seu N8N:

1. Na execução da mensagem, clique no node "Webhook"
2. Analise a estrutura JSON completa:

   🔍 Campos importantes para extrair:

   Remetente: entry[0].changes[0].value.messages[0].from

   Mensagem: entry[0].changes[0].value.messages[0].text.body

   Timestamp: entry[0].changes[0].value.messages[0].timestamp

   ID da Mensagem: entry[0].changes[0].value.messages[0].id

   Tipo: entry[0].changes[0].value.messages[0].type
3. No node "Set", confirme se os dados foram extraídos corretamente
4. No node "Function", veja se a lógica processou adequadamente

📵 Problema: N8N não recebe mensagens

Verificação passou, mas quando você envia mensagem real, nada acontece no N8N.

🔧 Preparação para Próxima Aula