Integração via n8n

Utilize este guia para configurar nosso Community Node no n8n e automatizar suas interações via WhatsApp.

O que este pacote oferece

Concluída a instalação, o n8n disponibilizará dois novos módulos em sua biblioteca de nós:

Nó	Função
Hyperflow WhatsApp	Envia mensagens (texto, mídia, listas, templates HSM, catálogo, flows, etc.).
Hyperflow WhatsApp Trigger	Inicia fluxos quando ocorrem eventos do WhatsApp (mensagem recebida, status, botão, lista, resposta de flow).

Instalação

No momento, o Community Node está disponível exclusivamente para versões Self-hosted do n8n (não sendo compatível com o n8n Cloud). A instalação pode ser realizada diretamente pelo painel administrativo ou via terminal. Para detalhes técnicos sobre os métodos de instalação, consulte a Install and manage community nodes.

Instalação via Interface

1. Acesso: Faça login no n8n com privilégios de administrador.

2. Navegação: Vá em Settings > Community Nodes.

3. Instalação: Selecione a opção para instalar um novo nó e insira o nome oficial do pacote: @hyperflow-global/n8n-nodes-hyperflow-whatsapp

4. Finalização: Caso solicitado pelo seu ambiente, reinicie a instância do n8n para aplicar as alterações.

Autenticação

Configuração de Autenticação

A comunicação com a API é protegida e exige uma API Key. Siga os passos abaixo para obter e configurar sua credencial:

1. Obter a Chave: Acesse o Painel de Integrações, selecione a conta de WhatsApp desejada e clique em Editar.

Imagem 1 - Editando contas do WhatsApp no Hyperflow integrações.

1. Visualizar: Clique no ícone de visualização (olho) para exibir a API Key completa e copie o código.

Imagem 2 - Obtenção do token da conta de WhatsApp desejada.

1. o seu workflow do n8n, acesse o campo 'Credential to connect with' e insira o token em qualquer um dos módulos. Ao configurar a credencial em um deles, ela será aplicada automaticamente ao outro módulo da integração.

   • Hyperflow WhatsApp (para envio de mensagens).

   • Hyperflow WhatsApp Trigger (para recebimento de eventos).

Imagem 3 - Configuração parcial do n8n

Imagem 4 - Inserção da chave de API obtida da conta do WhatsApp

1. Não esqueça de configurar a Webhook URL no campo correspondente para habilitar o recebimento de mensagens em tempo real.

Imagem 5 - Configuração do Webhook para recebimento de mensagens em tempo real.

Imagem 6 - URLs geradas serão vinculadas nesses campos setados.

Utilização dos nodes

Workflow.json

3KB

Open

Para mostragem foi feito um workflow simples:

1. Adicionado o node Hyperflow WhatsApp Trigger para iniciar um workflow quando eu receber uma mensagem no número WhatsApp que configurei anteriormente;

2. Adicionado um node AI Agent para comunicar um modelo IA;

3. Adicionado o node Hyperflow WhatsApp para me devolver via mensagem de WhatsApp o que o meu modelo respondeu.

Imagem 7 - Exemplo de configuração no n8n

Para iniciar a conversa, acesse a tela WhatsApp Accounts onde temos um link de conversa com WhatsApp para configuração do proxy do número que estaremos utilizando, envie a mensagem de proxy e ele já estará conectado ao seu workflow:

Imagem 8 - Onde pegar o numero de teste da conta do WhatsApp sendo configurada

Para iniciar a conversa, clique no link mencionado e envie a mensagem pré-configurada (ex: proxy AULEU8JW). A partir disso, o chat é ativado, permitindo interagir com a IA no n8n ou executar fluxos personalizados conforme as definições no painel de Integrações Hyperflow.

Imagem 9 - Envio de mensagem teste 'proxy AULEU8JW' para testar conversa

E visualizando a configuração dentro do nosso workflow, node por node:

Imagem 10 - Visualização do output de pergunta recebida

E por fim a visualização da resposta obtida no output.

Imagem 11 - Visualização do output de resposta enviada

Sucesso! Agora sua conta WhatsApp está conectada a um workflow do n8n!