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

# Integração com n8n

> A integração do GoGHL 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 HighLevel.

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 do GoGHL 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 no **GoGHL.ai**
* Acesso ao **n8n** (self-hosted)
* Permissão para criar chaves de API no GoGHL

***

## Passo 1: Instalar o Community Node do GoGHL no n8n[​](#passo-1-instalar-o-community-node-do-goghl-no-n8n "Link direto para Passo 1: Instalar o Community Node do GoGHL 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/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif?s=21aa09edbbd6fec03eeb773d6d6515ea" 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/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif?s=51a221414a0feb1ea9979204ab095be2" 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 no GoGHL[​](#passo-3-gerar-a-chave-de-api-no-goghl "Link direto para Passo 3: Gerar a Chave de API no GoGHL")

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

<Steps>
  <Step>
    Faça login no seu **painel do GoGHL.ai**
  </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/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif?s=5b74a7c325775058fbd37f98e25d1ac4" 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 do GoGHL 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/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=940d1d1fb21c90a2495c1b90c7ebc0ad" 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 do GoGHL 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 do GoGHL 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/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=cb3518e5c1d05876d2b5930db719699d" 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 GoGHL.

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 GoGHL.

Casos de uso:

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

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif?s=3106684b0419189d713e6ec5a7d89003" 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 via GoGHL 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 GoHighLevel) ou Número de Telefone
    * Conteúdo da mensagem
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif?s=67bd80b0fad713849181ea9f608b41ab" 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 GHL[​](#exemplo-enviar-mensagem-usando-o-id-de-contato-do-ghl "Link direto para Exemplo: Enviar Mensagem Usando o ID de Contato do GHL")

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 GoGHL

***

## 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 GoGHL

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

* Confirme que o contato existe no GHL
* 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@goghl.ai**](mailto:support@goghl.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="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 GoHighLevel?">
    Não. O n8n complementa os workflows do GHL e possibilita automações avançadas.
  </Accordion>
</AccordionGroup>

***

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