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

# Configurar a integração com o GoHighLevel

> Saiba como conectar o GoHighLevel às suas landing pages do LanderLab para sincronizar leads como contatos e acionar workflows em tempo real.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-GHL.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=3a555558695f500bfe94a2352d94ac18" alt="LL GHL" width="1200" height="600" data-path="images/LL-GHL.png" />
</Frame>

## O que é o GoHighLevel e por que usar esta integração?

O GoHighLevel (GHL) é uma plataforma completa de CRM e automação de marketing usada por agências e profissionais de marketing de performance para gerenciar contatos, pipelines e workflows automatizados. Quando você conecta o GoHighLevel a uma landing page do LanderLab, cada lead que envia o seu formulário é enviado instantaneamente para a sua subconta do GHL como um novo contato. Você também pode optar por acionar um workflow do GHL ao mesmo tempo, inscrevendo o lead em qualquer automação que você tenha configurado.

A conexão com o GoHighLevel funciona em duas etapas. Primeiro, você adiciona a sua subconta do GoHighLevel ao LanderLab usando o seu Location ID e a sua API Key. Depois, você conecta essa conta à sua landing page e configura a ação, o workflow, as tags e o mapeamento de campos.

<Note>
  As integrações com o GoHighLevel **são salvas globalmente na sua conta**. Depois que você adiciona a sua subconta do GHL, pode reutilizá-la em várias landing pages sem precisar informar as suas credenciais novamente.
</Note>

***

## Antes de começar

Você precisará de duas informações da sua conta do GoHighLevel:

**Location ID**

O Location ID é o identificador exclusivo da sua subconta do GHL. Para encontrá-lo:

1. Faça login na sua subconta do GoHighLevel
2. Acesse **Settings** no canto inferior direito
3. Clique em **Business Profile** na barra lateral esquerda
4. O seu **Location ID** é exibido nessa página

**API Key**

O LanderLab exige uma chave de API do GHL com os seguintes escopos ativados:

* `workflows.read`
* `contacts.read`
* `contacts.write`
* `customFields.readonly`
* `customFields.write`

Para gerar uma chave de API com esses escopos, acesse a sua subconta do GHL, vá até **Settings**, clique em **Private Integrations** e crie uma nova integração privada com os escopos listados acima. Copie o token gerado.

<Warning>
  O GHL não permite mais gerar novas chaves de API nas configurações padrão de Agency ou de Sub-account para contas que não as utilizavam antes. Use **Private Integrations** para gerar o seu token.
</Warning>

***

## Como adicionar o GoHighLevel

### Etapa 1: Adicionar a sua conta do GoHighLevel

<Steps>
  <Step title="Acesse sua landing page">
    Vá até **Landing Pages** e clique no **nome da landing page** à qual você quer adicionar o GoHighLevel.
  </Step>

  <Step title="Abra a aba de integrações">
    Clique em **Add Integration** para abrir o painel de integrações.
  </Step>

  <Step title="Selecione o GoHighLevel">
    Na lista de integrações disponíveis, encontre **GoHighLevel** (com a descrição "Sync leads with GoHighLevel as they come in") e clique nele.
  </Step>

  <Step title="Preencha as credenciais da sua conta">
    Informe os seguintes dados:

    | Campo           | Descrição                                                                                      |
    | :-------------- | :--------------------------------------------------------------------------------------------- |
    | **Name**        | Um nome para identificar esta conexão de conta (ex.: "Conta principal do GHL").                |
    | **Location ID** | O ID exclusivo da sua subconta do GHL. Fica em **Settings > Business Profile** no GoHighLevel. |
    | **API Key**     | O seu token de Private Integration do GoHighLevel, com os escopos necessários ativados.        |
  </Step>

  <Step title="Clique em Add GoHighLevel">
    Clique em **Add GoHighLevel** para fazer a autenticação e salvar a sua conta. O LanderLab verificará as credenciais e se conectará à sua subconta do GHL.
  </Step>
</Steps>

***

### Etapa 2: Configurar a ação, o workflow, as tags e o mapeamento de campos

Depois que a sua conta for adicionada, o assistente avança para a configuração da integração.

#### Passo 1: Configurar a ação e as tags

<Steps>
  <Step title="Defina um nome para esta integração">
    Dê a esta integração um nome fácil de reconhecer (ex.: "GHL - Leads de plano de saúde"). Isso ajuda você a identificá-la na lista de integrações da sua landing page.
  </Step>

  <Step title="Selecione uma ação">
    Escolha o que deve acontecer no GoHighLevel quando um lead for enviado. Você tem duas opções:

    | Ação                          | Descrição                                                                                                                                                                                             |
    | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Save contact**              | Cria o lead como um novo contato na sua subconta do GHL. Nenhum workflow é acionado.                                                                                                                  |
    | **Save and trigger workflow** | Cria o contato e o inscreve imediatamente em um workflow do GHL que você selecionar. Use esta opção para iniciar automações como sequências de e-mail, follow-ups por SMS ou atribuições a pipelines. |
  </Step>

  <Step title="Selecione um workflow (se for o caso)">
    Se você selecionou **Save and trigger workflow**, será exibido um menu suspenso **Workflow**. Selecione o workflow do GHL que você quer acionar para cada novo lead. O workflow precisa já existir na sua subconta do GoHighLevel.
  </Step>

  <Step title="Adicione tags (opcional)">
    No campo **Tags**, escolha entre as tags existentes ou digite para criar novas. As tags são aplicadas a todos os contatos criados por meio desta landing page e são úteis para segmentar os leads por campanha, oferta ou origem do tráfego.
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o passo de mapeamento de campos.
  </Step>
</Steps>

#### Passo 2: Mapear seus campos

<Steps>
  <Step title="Mapeie os campos do formulário para as propriedades de contato do GoHighLevel">
    Você verá, à esquerda, uma lista com todos os campos do formulário da sua landing page e, à direita, um menu suspenso para selecionar a propriedade de contato correspondente no GoHighLevel.

    Mapeie cada campo do formulário para a propriedade correspondente do GHL. No mínimo, mapeie o **Email** ou o **Phone**, pois o GHL exige pelo menos um deles para criar um contato.

    | Campo do formulário           | Propriedade do GoHighLevel |
    | :---------------------------- | :------------------------- |
    | Full Name                     | Full Name                  |
    | Email                         | Email\*                    |
    | Phone Number                  | Phone                      |
    | (outros campos do formulário) | Select field               |

    Os campos que você não mapear não serão enviados ao GoHighLevel. Use as caixas de seleção à esquerda para incluir ou excluir campos individualmente.

    <Tip>
      O LanderLab também inclui campos de sistema, como **LL Lander URL**, **LL Visitor IP**, **LL Visitor User Agent**, **LL Submission Time UTC** e **LL Variant ID**. Você pode mapeá-los para campos personalizados no GoHighLevel se quiser armazenar dados de rastreamento junto com os registros de contato.
    </Tip>
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o passo de revisão.
  </Step>
</Steps>

#### Passo 3: Revisar e conectar

<Steps>
  <Step title="Revise sua integração">
    O último passo mostra um resumo completo da sua integração com o GoHighLevel, incluindo o nome da integração, a ação selecionada, o workflow (se for o caso), as tags aplicadas e todos os campos mapeados. Revise tudo com atenção antes de ativar.

    Se algo parecer errado, clique em **Back** para voltar aos passos anteriores e fazer alterações.
  </Step>

  <Step title="Clique em Connect GoHighLevel">
    Clique em **Connect GoHighLevel** para salvar e ativar a integração. A partir de então, cada lead enviado nesta landing page será sincronizado com a sua subconta do GoHighLevel em tempo real.
  </Step>
</Steps>

***

## Dicas para a integração com o GoHighLevel

* **O e-mail ou o telefone é obrigatório** - O GoHighLevel precisa de pelo menos um desses dados para criar um contato. Certifique-se de que o seu formulário colete pelo menos um deles e de que ele esteja mapeado.
* **Contatos existentes são atualizados** - Se um lead for enviado com um e-mail ou telefone que já existe no GHL, o registro do contato existente será atualizado, em vez de ser criado um duplicado.
* **Use workflows para automações** - Se você quiser que os novos leads recebam automaticamente um SMS de follow-up, sejam adicionados a um pipeline ou iniciem uma sequência de e-mails, selecione **Save and trigger workflow** e escolha o workflow correspondente.
* **Verifique se o seu workflow está ativo** - O GHL só inscreve contatos em workflows publicados e ativos. Um workflow pausado ou em rascunho não será acionado, mesmo que esteja selecionado aqui.
* **Teste com um envio real** - Depois de conectar, envie um lead de teste na sua landing page e verifique se o contato aparece na sua subconta do GoHighLevel, em **Contacts**, em poucos segundos. Se você acionou um workflow, confira a inscrição do contato no workflow para confirmar que ele foi iniciado.