Ticker

6/recent/ticker-posts

Como Integrar a API Oficial do WhatsApp no N8N - Tutorial NoCode Startup

powernet telecomunicacoes setembro 18, 2026

📱 Como Integrar a API Oficial do WhatsApp no N8N

Material de apoio do vídeo "Como usar API WhatsApp Oficial: Passo a Passo
integração API WhatsApp Oficial no N8N" — NoCode Startup

🧭 O que você vai aprender

Nesse guia você vai aprender a ativar a API Oficial do WhatsApp da Meta e conectar
ela ao N8N usando os nodes nativos do WhatsApp — para receber e enviar mensagens
de forma automática, do zero, sem precisar programar.

Ao final você vai ter:

  • Um App criado no Meta for Developers com a API do WhatsApp ativada
  • Duas credenciais configuradas no N8N (uma para receber, uma para enviar)
  • Um workflow completo: trigger de recebimento + envio de resposta

⚠️ Antes de começar

  • Conta no Facebook/Meta (pessoa física)
  • Acesso ao Meta Business Manager — crie em business.facebook.com
  • N8N instalado — Cloud ou self-hosted

Passo 1 — Criar o App no Meta for Developers

  1. Acesse developers.facebook.com e faça login
  2. Clique em Meus Apps → Criar App
  3. Selecione o tipo: Business
  4. Preencha:
    • Nome do App → nome do seu negócio ou projeto
    • E-mail de contato → já vem preenchido
    • Conta Business Manager → vincule a sua, se tiver
  5. Clique em Criar App
  6. No painel do App, localize o produto WhatsApp e clique em Configurar
  7. Você entrará na área WhatsApp > Introdução

💡 A Meta disponibiliza automaticamente um número de teste gratuito nessa tela
(formato: +1 555-XXX-XXXX). É esse número que vamos usar ao longo do tutorial.

Passo 2 — Obter as Credenciais

Você vai precisar de 3 informações. Anote todas antes de ir ao N8N.

🔑 Token de Acesso Permanente

O token temporário expira em 24h. Gere um permanente seguindo os passos abaixo.

  1. Acesse business.facebook.com → Configurações
    → Usuários do Sistema
  2. Clique em Adicionar → dê um nome → defina como Administrador
  3. Clique em Gerar Token Novo:
    • Selecione o App que você criou
    • Expiração: Nunca
    • Permissão: ✅ whatsapp_business_messaging
  4. Clique em Gerar Token e salve em lugar seguro — ele não aparece novamente

📞 Phone Number ID

  1. Volte ao Meta for Developers → WhatsApp > Introdução
  2. Copie o valor ID do número de telefone (abaixo do número de teste)

🏢 WhatsApp Business Account ID (WABA ID)

  1. Na mesma tela, copie o valor ID da Conta do WhatsApp Business

Passo 3 — Configurar as Credenciais no N8N

⚠️ Esse workflow usa dois tipos diferentes de credencial no N8N — uma para
o node de recebimento e outra para o node de envio. Configure as duas agora.

Credencial A — WhatsApp account (para envio)

  1. No N8N, vá em Credenciais → Adicionar Credencial
  2. Busque por WhatsApp e selecione WhatsApp account
  3. Preencha:
    • Access Token → cole o token permanente que você gerou
    • Phone Number ID → cole o ID do número de telefone
    • Business Account ID → cole o WABA ID
  4. Dê o nome WhatsApp account e clique em Salvar

Credencial B — WhatsApp OAuth account (para recebimento)

  1. Ainda em Credenciais → Adicionar Credencial
  2. Busque por WhatsApp e selecione WhatsApp OAuth account
  3. Siga o fluxo de autenticação OAuth com sua conta do Facebook/Meta
  4. Dê o nome WhatsApp OAuth account e clique em Salvar

Passo 4 — Node de Recebimento (WhatsApp Trigger)

  1. Crie um Workflow novo no N8N
  2. Adicione o node WhatsApp Trigger
  3. Configure:
    • Credential to connect with → selecione WhatsApp OAuth account
    • Trigger On → Messages
  4. Clique em Webhook URLs (no topo do node) para expandir e copiar a URL gerada
  5. Salve o workflow e ative-o — o trigger só funciona com o workflow ativo

⚠️ Atenção: O N8N permite apenas um WhatsApp Trigger por App do Facebook.
Se você criar um segundo trigger com o mesmo App, o anterior vai parar de funcionar.

Configurar o Webhook no Meta

  1. No Meta for Developers → WhatsApp > Configuração
  2. Na seção Webhook, clique em Editar
  3. Cole a URL do webhook gerada pelo N8N no campo URL de Callback
  4. Defina um Token de Verificação (qualquer texto, ex: nocodestartup)
  5. Clique em Verificar e Salvar → ✅ deve aparecer confirmação de sucesso
  6. Clique em Gerenciar e assine o evento: ✅ messages

Passo 5 — Node de Envio (Send Message)

  1. Adicione um novo node WhatsApp após o trigger
  2. Configure:

    • Credential to connect with → selecione WhatsApp account

    • Resource → Message

    • Operation → Send

    • Sender Phone Number (or ID) → selecione o número de teste no dropdown
      (ele aparece automaticamente após a credencial ser conectada)

    • Recipient's Phone Number → número do destinatário com código do país
      (ex: +5548988642237)

      Para pegar o número de quem enviou a mensagem dinamicamente, use:

     {{ $json.messages[0].from }}
  • MessageType → Text
  • Text Body → o texto da sua resposta automática
  1. Conecte esse node ao Trigger e salve

Passo 6 — Testar o Ciclo Completo

  1. No Meta for Developers → WhatsApp > Introdução
  2. No campo Para, clique em Adicionar número de telefone e adicione
    o seu número pessoal como número de teste
  3. Selecione o template Hello World e clique em Enviar Mensagem
  4. Verifique no seu celular que a mensagem chegou
  5. Abra o N8N e confira se o Trigger executou ✅
  6. Verifique no celular que a resposta automática chegou ✅

📦 Estrutura de dados do Trigger

Quando uma mensagem é recebida, o node WhatsApp Trigger entrega os dados
já organizados. Esses são os campos mais usados:

Nome de quem enviou:
{{ $json.contacts[0].profile.name }}

Número de quem enviou:
{{ $json.messages[0].from }}

Texto da mensagem:
{{ $json.messages[0].text.body }}

ID da mensagem:
{{ $json.messages[0].id }}

Tipo da mensagem:
{{ $json.messages[0].text.type }}

✅ Checklist Final

  • [ ] App criado no Meta for Developers (tipo Business)
  • [ ] Produto WhatsApp adicionado e configurado
  • [ ] Token permanente gerado e salvo
  • [ ] Phone Number ID anotado
  • [ ] WABA ID anotado
  • [ ] Credencial WhatsApp account criada no N8N (para envio)
  • [ ] Credencial WhatsApp OAuth account criada no N8N (para recebimento)
  • [ ] Node WhatsApp Trigger adicionado com WhatsApp OAuth account
  • [ ] Trigger On configurado como Messages
  • [ ] Webhook verificado no Meta ✅
  • [ ] Evento messages assinado
  • [ ] Node Send Message configurado com WhatsApp account
  • [ ] Número do remetente dinâmico configurado com {{ $json.messages[0].from }}
  • [ ] Workflow ativo no N8N
  • [ ] Ciclo completo testado — mensagem recebida e resposta enviada ✅

🚀 Próximos Passos

O que você configurou aqui usa o número de teste da Meta — funciona para
validar a integração, mas só permite enviar mensagens para números cadastrados
manualmente como teste.

Para atender clientes reais você vai precisar de:

  • Um número real cadastrado e verificado na API
  • Business Manager verificado pela Meta
  • Templates de mensagem aprovados para iniciar conversas ativas

Quer aprender tudo isso? Acesse a formação completa da NoCode Startup e
tenha acesso às aulas exclusivas sobre número real, integração com Chatwoot,
Template Mestre no N8N e muito mais.

Postar um comentário

0 Comentários