> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com n8n

> A integração do MessageSync com o n8n permite conectar sua camada de mensagens de WhatsApp diretamente com . Isso possibilita automações avançadas, como gatilhos baseados em mensagens, envio de mensagens, sincronização de conversas e construção de lógica personalizada que vai além dos workflows padrão do CRM.

Com esta integração, você pode:

* Acionar workflows com mensagens de WhatsApp recebidas ou enviadas
* Enviar mensagens de WhatsApp programaticamente
* Construir lógica de automação complexa usando o ecossistema do n8n
* Combinar as mensagens com ferramentas externas, APIs, CRMs e bancos de dados

***

## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos")

Antes de começar, certifique-se de ter:

* Uma conta ativa
* Uma **subconta CRM** para integrar com o n8n
* Acesso ao **n8n** (self-hosted)
* Permissão para criar chaves de API no painel da integração

***

## Passo 1: Instalar o Community Node do MessageSync no n8n[​](#passo-1-instalar-o-community-node-do-messagesync-no-n8n "Link direto para Passo 1: Instalar o Community Node do MessageSync no n8n")

<Steps>
  <Step>
    Faça login no seu **painel do n8n**
  </Step>

  <Step>
    Abra **Settings** (Configurações)
  </Step>

  <Step>
    Navegue até **Community Nodes** (Nós da Comunidade)
  </Step>

  <Step>
    Clique em **Install** (Instalar)
  </Step>

  <Step>
    Cole o seguinte nome de pacote:

    ```text theme={null}
    n8n-nodes-message-sync-ai
    ```
  </Step>

  <Step>
    Conclua a instalação e reinicie o n8n, se solicitado
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif?s=a9b59b7550bf9c5bb0ff825732da0d3c" alt="Instalar o Community Node MessageSync.ai no n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif" />
</Frame>

Adicione rapidamente o Community Node MessageSync.ai à sua instância do n8n pelo painel de Community Nodes.

***

## Passo 2: Criar Credenciais no n8n[​](#passo-2-criar-credenciais-no-n8n "Link direto para Passo 2: Criar Credenciais no n8n")

Depois que o pacote estiver instalado, você precisa configurar as credenciais.

<Steps>
  <Step>
    Vá para **Credentials** (Credenciais) no n8n
  </Step>

  <Step>
    Clique em **MessageSync.ai** ou em Adicionar Credencial e pesquise por MessageSync.ai
  </Step>

  <Step>
    Abra a credencial **MessageSync.ai Account**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif?s=8c24bfec89ffef5e6efe7c88bb0126b1" alt="Instalar o Community Node MessageSync.ai no n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif" />
</Frame>

Abra o painel de credenciais do MessageSync.ai no n8n para iniciar a configuração.

***

## Passo 3: Gerar a Chave de API nas configurações da instância[​](#passo-3-gerar-a-chave-de-api-nas-configuracoes-da-instancia "Link direto para Passo 3: Gerar a Chave de API nas configurações da instância")

Agora você vai gerar a chave de API necessária para o n8n.

<Steps>
  <Step>
    Faça login no seu **painel**
  </Step>

  <Step>
    Selecione a **subconta** que você deseja conectar
  </Step>

  <Step>
    Vá para **Settings** (Configurações)
  </Step>

  <Step>
    Role para baixo até a seção **API Keys** (Chaves de API)
  </Step>

  <Step>
    Crie uma nova **Chave de API** para o n8n
  </Step>

  <Step>
    Copie:

    * **Chave de API**
    * **ID da Subconta**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif?s=49c2409dba0bbeedc6c9525e866f6975" alt="Instalar o Community Node MessageSync.ai no n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif" />
</Frame>

Abra seu painel e copie a Chave de API e o ID da Subconta no painel de credenciais do MessageSync.ai no painel do n8n.

***

## Passo 4: Configurar as Credenciais no n8n[​](#passo-4-configurar-as-credenciais-no-n8n "Link direto para Passo 4: Configurar as Credenciais no n8n")

<Steps>
  <Step>
    Volte para a **credencial do MessageSync.ai** no n8n
  </Step>

  <Step>
    Cole:

    * Chave de API
    * ID da Subconta
  </Step>

  <Step>
    Salve a credencial
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=d398eda582f843d548e4e4d9d6ab5ded" alt="Instalar o Community Node MessageSync.ai no n8n" width="3456" height="1758" data-path="images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png" />
</Frame>

Cole sua Chave de API e o ID da Subconta no painel de credenciais do MessageSync.ai no n8n e salve para concluir a integração.

Depois de salvar, sua conta estará conectada com segurança ao n8n.

***

## Passo 5: Criar Seu Primeiro Workflow[​](#passo-5-criar-seu-primeiro-workflow "Link direto para Passo 5: Criar Seu Primeiro Workflow")

<Steps>
  <Step>
    Vá para **Workflows**
  </Step>

  <Step>
    Clique em **Create Workflow** (Criar Workflow)
  </Step>

  <Step>
    Clique em **Add Node** (Adicionar Nó)
  </Step>

  <Step>
    Pesquise por **MessageSync**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=2eaca868f74cc691813d14a2b262f8bf" alt="Instalar o Community Node MessageSync.ai no n8n" width="3456" height="1758" data-path="images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png" />
</Frame>

***

## Gatilhos Disponíveis[​](#gatilhos-disponíveis "Link direto para Gatilhos Disponíveis")

Você pode iniciar workflows usando os seguintes gatilhos:

### Gatilho de Mensagem Recebida[​](#gatilho-de-mensagem-recebida "Link direto para Gatilho de Mensagem Recebida")

Dispara quando uma mensagem de WhatsApp é recebida no sistema.

Casos de uso:

* Respostas automáticas
* Qualificação de leads
* Encaminhamento de webhooks
* Atualizações no CRM

### Gatilho de Mensagem Enviada[​](#gatilho-de-mensagem-enviada "Link direto para Gatilho de Mensagem Enviada")

Dispara quando uma mensagem de WhatsApp é enviada pelo sistema.

Casos de uso:

* Registro de mensagens
* Análises
* Sincronização com sistemas externos

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif?s=a691d0112ed0bec6f7081bc2ff6cc857" alt="Instalar o Community Node MessageSync.ai no n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif" />
</Frame>

Exemplos de Gatilhos: Configure automações que começam quando você recebe ou envia uma mensagem de WhatsApp usando o nó MessageSync.ai no n8n.

***

## Enviando uma Mensagem Usando o n8n[​](#enviando-uma-mensagem-usando-o-n8n "Link direto para Enviando uma Mensagem Usando o n8n")

Você também pode enviar mensagens de WhatsApp diretamente do n8n.

<Steps>
  <Step>
    Adicione um nó **MessageSync → Send Message** (Enviar Mensagem)
  </Step>

  <Step>
    Selecione suas credenciais configuradas
  </Step>

  <Step>
    Forneça os campos obrigatórios:

    * ID do Contato (do CRM) ou Número de Telefone
    * Conteúdo da mensagem
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif?s=9821e481f47a744b471516c80b8e0d12" alt="Instalar o Community Node MessageSync.ai no n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif" />
</Frame>

Envie uma mensagem de WhatsApp definindo o ID do contato (ou Número de Telefone) e a mensagem no nó MessageSync.ai.

### Exemplo: Enviar Mensagem Usando o ID de Contato do CRM[​](#exemplo-enviar-mensagem-usando-o-id-de-contato-do-ghl "Link direto para Exemplo: Enviar Mensagem Usando o ID de Contato do CRM")

Isso permite que você:

* Envie mensagens para contatos existentes
* Acione mensagens de WhatsApp a partir de qualquer lógica do n8n
* Combine com webhooks, formulários ou bancos de dados

***

## Boas Práticas[​](#boas-práticas "Link direto para Boas Práticas")

* Use gatilhos de entrada para automações orientadas a eventos
* Mantenha as chaves de API restritas a subcontas específicas
* Registre os workflows durante os testes para evitar envios duplicados
* Combine a lógica do n8n com os recursos de drip (envio gradual) e limitação de taxa do sistema

***

## Solução de Problemas[​](#solução-de-problemas "Link direto para Solução de Problemas")

**O nó não aparece após a instalação**

* Reinicie o n8n
* Certifique-se de que os community nodes estão habilitados

**Erro de autenticação**

* Verifique novamente a chave de API e o ID da subconta
* Certifique-se de que a chave está ativa no painel

**As mensagens não são enviadas**

* Confirme que o contato existe no CRM
* Valide que o número de WhatsApp está conectado

***

## Suporte[​](#suporte "Link direto para Suporte")

Se você precisar de ajuda para configurar isso ou construir workflows:

* Fale conosco pelo **Chat do WhatsApp**
* Entre em contato: [**support@messagesync.ai**](mailto:support@messagesync.ai)

Teremos prazer em ajudar você a projetar workflows ou depurar configurações.

***

## Perguntas Frequentes[​](#perguntas-frequentes "Link direto para Perguntas Frequentes")

<AccordionGroup>
  <Accordion title="Preciso de uma subconta CRM para usar esta integração?">
    Sim. A integração se conecta no nível da subconta, então você precisará de uma subconta CRM para integrar com o n8n. A chave de API e o ID da subconta usados nas credenciais são gerados a partir dessa subconta.
  </Accordion>

  <Accordion title="Posso usar isso com várias subcontas?">
    Sim. Cada subconta requer sua própria chave de API e credencial.
  </Accordion>

  <Accordion title="Isso substitui os workflows do CRM?">
    Não. O n8n complementa os workflows do CRM e possibilita automações avançadas.
  </Accordion>
</AccordionGroup>

***

Agora você está pronto para construir automações poderosas de WhatsApp usando **MessageSync + n8n**.