# Integração via n8n

### O que este pacote oferece

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

<table><thead><tr><th width="302.44921875">Nó</th><th>Função</th></tr></thead><tbody><tr><td><strong>Hyperflow WhatsApp</strong></td><td>Envia mensagens (texto, mídia, listas, templates HSM, catálogo, flows, etc.).</td></tr><tr><td><strong>Hyperflow WhatsApp Trigger</strong></td><td>Inicia fluxos quando ocorrem eventos do WhatsApp (mensagem recebida, status, botão, lista, resposta de flow).</td></tr></tbody></table>

### Instalação

{% hint style="info" %}
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](https://docs.n8n.io/integrations/community-nodes/installation/).
{% endhint %}

**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](https://integracoes.hyperflow.global/whatsapp), selecione a conta de WhatsApp desejada e clique em Editar.

<figure><img src="/files/xgDNtwj73Anl7xjflQde" alt=""><figcaption><p>Imagem 1 - Editando contas do WhatsApp no Hyperflow integrações.</p></figcaption></figure>

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

<figure><img src="/files/ePbXrCDsoiiQt5mIKBtD" alt=""><figcaption><p>Imagem 2 - Obtenção do token da conta de WhatsApp desejada.</p></figcaption></figure>

3. 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).

<figure><img src="/files/rSJIB1KDmpivmDyBCnPf" alt=""><figcaption><p>Imagem 3 - Configuração parcial do n8n</p></figcaption></figure>

<figure><img src="/files/ygTCyQ9gbjdLjFqmfEcW" alt=""><figcaption><p>Imagem 4 - Inserção da chave de API obtida da conta do WhatsApp</p></figcaption></figure>

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

<figure><img src="/files/7uK5065f6KwWIR0DXR5b" alt=""><figcaption><p>Imagem 5 - Configuração do Webhook para recebimento de mensagens em tempo real.</p></figcaption></figure>

<figure><img src="/files/iueM7TCEGLFpPf5aX3FZ" alt=""><figcaption><p>Imagem 6 - URLs geradas serão vinculadas nesses campos setados.</p></figcaption></figure>

### Utilização dos nodes

{% file src="/files/XsrbulFkwrzBUnn2T1YT" %}

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.

<figure><img src="/files/MlV7rpwB9SLKzXtMfsnJ" alt=""><figcaption><p>Imagem 7 - Exemplo de configuração no n8n</p></figcaption></figure>

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:

<figure><img src="/files/Orp2KuKN9H2KX4TpmZSg" alt=""><figcaption><p>Imagem 8 - Onde pegar o numero de teste da conta do WhatsApp sendo configurada</p></figcaption></figure>

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.

<figure><img src="/files/rG4F5SI9a1YbICa8lwdP" alt=""><figcaption><p>Imagem 9 - Envio de mensagem teste 'proxy AULEU8JW' para testar conversa</p></figcaption></figure>

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

<figure><img src="/files/BwISGkeKMAKhgTLE2Eop" alt=""><figcaption><p>Imagem 10 - Visualização do output de pergunta recebida</p></figcaption></figure>

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

<figure><img src="/files/Y0zpVdLBxG6bj5fIjHcf" alt=""><figcaption><p>Imagem 11 - Visualização do output de resposta enviada</p></figcaption></figure>

{% hint style="success" %}
Sucesso! Agora sua conta WhatsApp está conectada a um workflow do n8n!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.hyperflow.global/docs/whatsapp-api-hyperflow/integracao-via-n8n.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.