Como conectar WhatsApp Business ao n8n com webhook
Ligue um número de teste da WhatsApp Business Platform ao n8n, valide o webhook e responda apenas a mensagens autorizadas.
Um fluxo de homologação que recebe mensagem, registra o identificador e envia uma confirmação fixa pelo nó oficial.
Passo a passo aplicado
- 01
Configure o aplicativo
Crie ou selecione o aplicativo, adicione WhatsApp e mantenha o ambiente em desenvolvimento enquanto usa usuários de teste.
- 02
Crie o webhook no n8n
Use Webhook com caminho exclusivo. A URL precisa ser pública, HTTPS e responder à verificação exigida pela plataforma.
- 03
Valide o token
Defina um token de verificação longo e compare o valor recebido antes de devolver o challenge. Não use o token de acesso como token de verificação.
- 04
Assine os eventos necessários
Habilite apenas eventos usados pelo fluxo. Menos eventos reduzem ruído e exposição de dados.
- 05
Extraia a mensagem
Mapeie identificador do evento, remetente, tipo e corpo. Ignore status e tipos ainda não tratados.
- 06
Evite duplicidade
Consulte uma tabela de eventos processados antes da ação. Marque como concluído somente depois do envio bem-sucedido.
- 07
Envie uma resposta de teste
Use o nó WhatsApp Business Cloud ou a chamada HTTP oficial, com destinatário autorizado e mensagem fixa.
- 08
Troque tokens temporários
Antes da produção, use o processo de credenciais recomendado, permissões mínimas e rotação documentada.
Erros comuns e correções
URL não é aceita
Use HTTPS público e confirme que o endpoint responde rapidamente à validação.
Evento chega mais de uma vez
Implemente idempotência pelo identificador da mensagem.
Token expirou
Revise o tipo de token, permissões, usuário do sistema e processo de renovação.
Valide antes de colocar em produção.
Envie uma mensagem permitida, reenvie o mesmo payload e simule token inválido. Deve haver uma única resposta e dois registros de segurança sem ação externa.
Perguntas frequentes
Posso usar WhatsApp Web?
Para integração empresarial, use a plataforma oficial e seus provedores autorizados.
Preciso deixar o n8n público?
O webhook precisa ser alcançável pela plataforma; proteja o restante da instância e valide toda requisição.
O webhook deve responder rápido?
Sim. Receba, valide e coloque o trabalho pesado em uma etapa assíncrona quando necessário.
Documentação e fontes
Quer isso implementado
na sua empresa?
Veja como a IAX conecta essa tarefa ao restante da operação.
Próximos passos
