Um community node mantido pela equipe da 360Dialog conecta o n8n à WhatsApp Business API com registro automático de Webhooks, envio de texto, mídia e templates – tudo de dentro dos seus workflows. O node gerencia o ciclo de vida completo do webhook: ele registra uma nova URL na ativação e restaura a anterior quando você o desativa. Isso significa nenhuma chamada manual de API para configurar o roteamento de mensagens. Se você hospeda o n8n por conta própria e quer controle no nível de código sobre a sua automação de WhatsApp, esta integração conecta seus workflows diretamente a um número de WhatsApp em produção.
Principais conclusões
- Um community node mantido pela 360Dialog conecta o n8n à WhatsApp Business API com registro e desregistro automático de Webhooks.
- O node é mantido pela equipe da 360Dialog e licenciado sob MIT, garantindo total visibilidade do código-fonte.
- A configuração exige três etapas: instalar o community node, adicionar sua credencial da 360Dialog API e criar um workflow com os nodes de trigger e ação.
- O trigger node filtra mensagens de eco de saída e remove duplicatas de mensagens de entrada em uma janela de 24 horas, mantendo 500 IDs de mensagens em memória.
- Atualizações de status de entrega são reconhecidas, mas não disparam workflows, então o roteamento baseado em status exige um mecanismo separado.
Por que conectar o WhatsApp ao n8n?
O n8n é uma ferramenta de automação de workflows open-source e auto-hospedável. Conectar o WhatsApp ao n8n significa que suas mensagens rodam em infraestrutura própria, sem dependência de fornecedor entre seus workflows e a WhatsApp Business API.
O n8n não inclui uma integração nativa com o WhatsApp, mas o community node da 360Dialog encapsula os Endpoint da API no formato de node do n8n, para que você possa disparar workflows a partir de mensagens recebidas e enviar mensagens de saída como parte de qualquer cadeia de automação. Para equipes que já usam o n8n para atualizações de CRM ou pipelines de dados, adicionar o WhatsApp significa uma ferramenta a menos fora do seu stack.
O que a integração n8n com WhatsApp oferece?
A integração fornece dois tipos de node: um trigger node para mensagens recebidas e um action node para operações de saída. Juntos, eles cobrem o ciclo principal de mensagens, incluindo envio de texto, mídia e templates, além de recebimento e roteamento de conversas.[1]
Operações do action node
O action node (Dialog360) suporta quatro operações:
- Enviar texto: Envia uma mensagem de texto simples para um número de WhatsApp.
- Enviar mídia: Envia uma imagem, vídeo, documento ou arquivo de áudio via URL HTTPS pública.
- Enviar template: Busca seus templates aprovados da API em um dropdown em tempo real e gera automaticamente campos de entrada correspondentes às definições de variáveis de cada template.
- Verificar status de saúde: Consulta o status de saúde da sua conta WhatsApp (anteriormente WhatsApp Business Account, ou WABA) diretamente do workflow.
Comportamento do trigger node
O trigger node (Dialog360Trigger) gerencia a configuração de Webhooks automaticamente:
- Registro automático: Na ativação, o node envia uma requisição POST para
/v1/configs/webhookpara registrar sua URL como o webhook ativo para o seu número.[2] - Restauração: Na desativação, ele restaura a URL de webhook anterior, para que seus outros sistemas não fiquem desconectados.
- Filtragem de eco de saída: O node ignora mensagens enviadas pela própria conta, prevenindo loops infinitos em workflows que enviam e recebem ao mesmo tempo.
- Deduplicação: Uma janela de 24 horas com 500 IDs de mensagens em memória previne o processamento duplicado da mesma mensagem recebida.
- Atualizações de status: Confirmações de entrega (enviada, entregue, lida) são reconhecidas com uma resposta 200 OK, mas não disparam o workflow.
Se você precisa rotear workflows com base em status de entrega, será necessário tratar isso fora do trigger node.
Você deve conectar o WhatsApp ao n8n?
Conectar o WhatsApp ao n8n faz sentido se você hospeda o n8n por conta própria (ou planeja hospedar), se sua equipe inclui desenvolvedores confortáveis em ler TypeScript e se você quer total visibilidade sobre como suas mensagens de WhatsApp são processadas. A licença MIT significa que você pode inspecionar, fazer fork e modificar cada linha do código do node.[1]
Para equipes não técnicas que precisam de um construtor visual com templates prontos, considere o Zapier com o app nativo da 360Dialog ou explore o 360Dialog Marketplace.
Qual é a diferença entre automação e atendimento ao vivo?
Ferramentas de automação como o n8n lidam com eventos e fluxos de dados: rotear mensagens, atualizar bancos de dados, enviar notificações e disparar envios de templates com base em condições que você define. Elas não conduzem conversas. Quando um cliente responde com uma pergunta que exige uma resposta humana, a automação sozinha deixa aquela mensagem sem leitura.
A 360Dialog resolve isso com uma configuração multi-webhook. Seus workflows no n8n e uma caixa de entrada compartilhada podem rodar no mesmo número de WhatsApp simultaneamente.[2] A automação cuida do trabalho orientado a eventos, enquanto sua equipe cuida das conversas ao vivo em uma caixa de entrada compartilhada. Os dois sistemas coexistem porque a 360Dialog suporta múltiplos Endpoint de Webhooks por número via a API /multi_webhook.
O princípio central da automação de WhatsApp se aplica aqui: automatize o que é previsível, mantenha pessoas disponíveis para o que não é.
Como conectar sua conta em 3 passos?
Três passos: instale o community node, adicione suas credenciais da 360Dialog e crie seu primeiro workflow.
Passo 1: Instale o community node. Na sua instância do n8n, vá em Settings, depois Community Nodes. Digite @pmartino/n8n-nodes-360dialog e instale. O pacote adiciona dois nodes (Dialog360 e Dialog360Trigger) e um tipo de credencial (Dialog360Api).
Passo 2: Adicione sua credencial da 360Dialog. Crie uma nova credencial do tipo Dialog360Api. Cole sua chave de API no formulário de credenciais. É a mesma chave que você usa para chamadas diretas à API, com o nome de header D360-API-KEY.
Passo 3: Crie seu workflow. Adicione um node Dialog360Trigger como ponto de entrada para mensagens recebidas. Conecte-o a um node HTTP Request para atualizações de CRM, um node do Slack para alertas internos ou um action node Dialog360 para respostas automatizadas. Para workflows apenas de saída, use o action node Dialog360 diretamente.
Atenção: Ativar o trigger node registra uma nova URL de webhook na 360Dialog API, substituindo qualquer webhook existente naquele número. Desativar restaura a URL anterior. Teste esse comportamento em um ambiente de não-produção primeiro. Para consumidores de webhook simultâneos no mesmo número, use a configuração multi-webhook da 360Dialog via /multi_webhook.
Para começar com sua chave de API, Comece a usar a API e instale o community node na sua instância do n8n.
O que as pessoas automatizam com n8n e WhatsApp?
Quatro padrões aparecem com frequência nas mais de 400 integrações do n8n.
Roteamento de mensagens recebidas. Conecte o Dialog360Trigger a um node Switch que roteia mensagens por palavra-chave, número do remetente ou tipo de mensagem. Solicitações de suporte ao cliente vão para uma ramificação, consultas de pedidos para outra.
Atualização de CRM em nova conversa. Extraia o número do remetente do payload do trigger, consulte-o no seu CRM via HTTP Request e atualize o registro do contato.
Envio automático de template por evento. Use um webhook ou trigger agendado para disparar uma ação Dialog360 Send Template quando um pedido for despachado, um pagamento chegar ou um agendamento for confirmado.
Notificação interna no Slack. Conecte o Dialog360Trigger a um node do Slack. Cada mensagem recebida no WhatsApp publica um alerta formatado com o número do remetente e o texto da mensagem.
Quer sua equipe em uma única visualização compartilhada?
A automação cuida do lado estruturado e orientado a eventos das mensagens de WhatsApp. Conversas ao vivo com clientes que precisam de uma resposta humana exigem uma ferramenta diferente. A 360Dialog oferece uma caixa de entrada compartilhada que roda no mesmo número de WhatsApp dos seus workflows no n8n, com atribuição, marcação e colaboração entre múltiplos atendentes. Como a 360Dialog suporta múltiplos Webhooks por número, seus workflows automatizados e sua caixa de entrada compartilhada recebem mensagens simultaneamente.
Por que a 360Dialog?
A 360Dialog é uma parceira oficial da Meta como Solution Provider, oferecendo infraestrutura de WhatsApp Business API para mais de 100.000 empresas.[3] A plataforma oferece preços transparentes sem markup sobre as tarifas da Meta, a partir de EUR 49/mês.[3] O Support funciona 24/7 em sete idiomas. O community node para n8n é mantido pela equipe da 360Dialog.
Para equipes avaliando automação de workflows com WhatsApp, a escolha do provedor de API define o seu teto. Para conectar sua instância do n8n a um número de WhatsApp em produção, Comece a usar a API e siga a configuração em três passos acima.
Perguntas frequentes
O node de WhatsApp para n8n é uma integração oficial do n8n?
O community node da 360Dialog pode ser instalado pelas configurações de Community Nodes do n8n. Ele segue o formato de empacotamento de community nodes do n8n (usando a keyword n8n-community-node-package no npm) e é mantido pela equipe da 360Dialog sob a licença MIT.
O trigger node processa atualizações de status de entrega?
O trigger node reconhece atualizações de status de entrega (enviada, entregue, lida) com uma resposta 200 OK, mas esses eventos não disparam o workflow. Apenas mensagens recebidas ativam o trigger. Para agir com base em status de entrega, configure um Endpoint de webhook separado ou um mecanismo de polling fora deste node.
O que acontece com meu webhook existente quando eu ativo o node?
Ativar o node Dialog360Trigger registra uma nova URL de webhook na 360Dialog API, substituindo qualquer URL previamente configurada para aquele número. Desativar restaura a URL de webhook anterior. Para múltiplos consumidores de webhook no mesmo número, a 360Dialog suporta configuração multi-webhook via o Endpoint /multi_webhook.
Preciso hospedar o n8n por conta própria para usar esta integração?
O community node pode ser instalado em instâncias do n8n Cloud que suportam community nodes. No entanto, o controle total sobre dados e execução se alinha melhor com implantações auto-hospedadas. Consulte a documentação do plano cloud do n8n para verificar o suporte a community nodes no seu plano.
Qual versão da 360Dialog API o node utiliza?
O node se comunica com a API de mensagens da 360Dialog em https://waba-v2.360dialog.io/messages usando o header D360-API-KEY para autenticação. Ele usa o Endpoint de configuração de webhook v1 em /v1/configs/webhook para o registro automático de webhook. A versão da API de mensagens da 360Dialog é 1.49.6 conforme a documentação mais recente.
Fontes
[1] npm registry, “@pmartino/n8n-nodes-360dialog,” version 0.3.0, https://registry.npmjs.org/@pmartino/n8n-nodes-360dialog. Accessed September 9, 2026.
[2] 360Dialog, “Webhooks API Reference,” https://docs.360dialog.com/docs/messaging-api/api-reference/webhooks. Accessed September 9, 2026.
[3] 360Dialog, “WhatsApp Business Platform Pricing,” https://360dialog.com/pricing. Accessed September 9, 2026.
