Como Integrar a API Oficial do WhatsApp ao N8N e Automatizar a Comunicação da Sua Empresa: Guia Completo

Etapa 1: Criando um Aplicativo na Meta Para Usar a API do WhatsApp

1. Acesse: https://developers.facebook.com

2. Faça login com sua conta do Facebook.

3. Vá até Meus Apps > Criar Aplicativo.

4. Escolha o tipo "Business" e clique em "Avançar".

5. Preencha as informações básicas (nome, e-mail, finalidade).

6. No painel do app criado, vá até WhatsApp > Começar.

7. Associe esse app a um Business Manager verificado.

8. Cadastre um número de telefone válido, que não esteja em uso no WhatsApp.

Etapa 2: Enviando Sua Primeira Mensagem Automatizada

1. No painel da Meta, gere seu token de acesso (Bearer Token).

2. Identifique o ID da conta WhatsApp Business e o ID do número de telefone.

3. Copie a URL base da API (geralmente no formato https://graph.facebook.com/v19.0/<ID_DO_NUMERO>/messages).

4. Envie uma requisição POST usando cURL ou Postman com os seguintes dados:

json
Copiar código
POST https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/messages
Headers:
  Authorization: Bearer YOUR_ACCESS_TOKEN
  Content-Type: application/json

Body:
{
  "messaging_product": "whatsapp",
  "to": "whatsapp:+5511999999999",
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": {
      "code": "pt_BR"
    }
  }
}

Lembre-se: a primeira mensagem precisa ser obrigatoriamente um template aprovado pela Meta. Após o primeiro contato, a sessão é aberta por 24h.

Etapa 3: Integrando o WhatsApp ao N8N Para Envio de Mensagens Automatizadas

1. Acesse o painel do N8N (local ou self-hosted).

2. Crie um novo workflow (fluxo de automação).

3. Adicione um nó inicial com Manual Trigger para testes.

4. Em seguida, adicione o nó HTTP Request.

5. Configure o método como POST.

6. Preencha:
• URL: https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/messages
• Headers:
• Authorization: Bearer SEU_TOKEN
• Content-Type: application/json
• Body Parameters em formato JSON (exemplo do Hello World acima).

7. Execute o fluxo clicando em Execute Workflow.

Etapa 4: Criando Respostas Automáticas com Webhooks (Entrada de Mensagens)

• Respostas imediatas a perguntas frequentes;

• Abertura de tickets de suporte;

• Registro automático em CRM;

• Início de atendimento humano com base em palavras-chave.

1. No N8N:
• Crie novo workflow.
• Adicione o nó Webhook.
• Defina o método como POST.
• Copie a URL gerada.

2. No painel da Meta:
• Vá em Configurações > Webhooks.
• Clique em Adicionar Callback URL.
• Cole a URL do N8N.
• Adicione o Token de verificação personalizado.
• Selecione os eventos desejados (messages, message_deliveries, etc.).

3. Volte ao N8N:
• Adicione um nó IF, Switch ou Set para processar o conteúdo da mensagem.
• Com isso, você pode responder dinamicamente com base no que foi enviado.

4. Use novamente o nó HTTP Request para enviar uma resposta automatizada, utilizando o mesmo modelo do envio inicial.

Como Funciona por Trás dos Bastidores: Entendendo a Estrutura da API

• URL Base: é a porta de entrada das requisições.

• Headers:
• Authorization: Bearer TOKEN
• Content-Type: application/json

• Body: estrutura em JSON contendo:
• O tipo de mensagem (text, template, image, interactive);
• O destinatário (to);
• O conteúdo da mensagem.

Benefícios Reais da Integração WhatsApp + N8N

• Atendimento instantâneo e 24h por dia.

• Redução de carga operacional de equipes humanas.

• Integração com CRMs, planilhas, bancos de dados e sistemas internos.

• Fluxos altamente personalizados com respostas condicionais, palavras-chave, categorização automática.

• Criação de chatbots híbridos, com IA + intervenção humana.

Considerações Finais

Autor do artigo

AGENDE AGORA !