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

# LeadConnector (GoHighLevel)

> Como conectar sua subconta do LeadConnector (GoHighLevel) a um agente do ChatNorris com um token de Private Integration, e o que o agente faz com os seus contatos: criá-los ou atualizá-los, etiquetá-los e adicionar a eles uma nota com a conversa.

# LeadConnector (GoHighLevel)

Com a integração do LeadConnector, os contatos que o seu agente do ChatNorris confirma chegam sozinhos à sua subconta do LeadConnector / GoHighLevel. Quando o visitante confirma o email ou o telefone, conforme o que você ativar, o agente:

* cria o contato na sua subconta ou atualiza o que já existe;
* adiciona uma etiqueta a ele, útil para disparar seus workflows no LeadConnector;
* adiciona a ele uma nota com o link para a conversa no ChatNorris.

O ChatNorris nunca lê nem modifica mais nada da sua conta do LeadConnector.

## Requisitos

* Uma conta do ChatNorris no plano **Standard** ou **Premium**. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md).
* Acesso à subconta do LeadConnector / GoHighLevel em que você quer receber os contatos, com permissão para criar uma Private Integration.
* Função **Owner** ou **Admin** na sua organização do ChatNorris.

## Conectar o LeadConnector

Cada agente se conecta a uma subconta. Você precisa de dois dados: um **Token de Private Integration** e o **Location ID** da subconta.

**1. Crie o token na subconta**

Entre na subconta (não na agência) e vá para **Settings → Private Integrations → Create new Integration**. Se você não vê Private Integrations em Settings, ative primeiro em **Settings → Labs**.

**2. Marque as permissões e copie o token**

Dê um nome a ela (por exemplo "ChatNorris") e marque as permissões `contacts.readonly` e `contacts.write`. Crie a integração e copie o token: ele é mostrado uma única vez.

**3. Copie o Location ID**

Ele está em **Settings → Business Profile**. Também aparece na URL da subconta, depois de `/location/`.

**4. Abra o hub de Integrações do agente**

No ChatNorris, entre em `Agentes → [seu agente] → Integrações` e escolha **LeadConnector**.

**5. Cole os dois dados e conecte**

Cole o token em **Token de Private Integration** (começa com `pit-`) e o identificador em **Location ID**, e clique em **Conectar**. Com **Testar conexão**, você confirma que eles funcionam antes de usá-los na Ação.

O hub só mostra os últimos 4 caracteres do token. Se você trocá-lo no LeadConnector, use **Substituir chave** no menu **···** da linha: a conexão continua sendo a mesma e a Ação não é afetada.

## Configurar a Ação

Conectar a subconta ainda não envia nada. Para escolher o que o agente faz no LeadConnector:

**1. Crie a Ação LeadConnector**

Entre em `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **LeadConnector**.

**2. Escolha os recursos**

Ative os que você quiser (veja a tabela abaixo). **Adicionar etiqueta** e **Nota com a conversa** exigem que **Sincronizar contato** esteja ativo.

**3. Ative a Ação e salve**

Com **Ação habilitada** ativa, clique em **Salvar**. A partir desse momento, os contatos confirmados deste agente chegam à sua subconta.

| Recurso | O que faz no LeadConnector |
| - | - |
| **Sincronizar contato** | Cria ou atualiza o contato quando o visitante confirma o email ou o telefone. O LeadConnector procura duplicados conforme a configuração da sua subconta. Nome e empresa só são preenchidos se estiverem vazios: nunca são sobrescritos. |
| **Adicionar etiqueta** | Adiciona uma etiqueta ao contato sem remover as que ele já tem. Por padrão é `chatnorris`; você pode mudá-la em **Etiqueta** (até 50 caracteres). Útil para disparar seus workflows no LeadConnector. |
| **Nota com a conversa** | Adiciona ao contato uma nota com o link para a conversa no ChatNorris, uma única vez por lead. |

> [!NOTE]
>
> Excluir a Ação não apaga a conexão do hub: a subconta continua conectada em **Integrações**.

## Desconectar

Em `Agentes → [seu agente] → Integrações → LeadConnector`, clique em **Desconectar** (também está no menu **···** da linha). A sincronização de contatos é desabilitada: a Ação LeadConnector é desativada, mas não é apagada e mantém sua configuração. O token é apagado do ChatNorris. Para voltar a enviar contatos, conecte a subconta novamente e reative a Ação.

Se você só quiser interrompê-la por um tempo, desative a chave **Ativa** da integração: o token é mantido e a Ação não chama o LeadConnector até que você a reative.

## Perguntas frequentes

> [accordion] Não vejo Private Integrations em Settings
>
> Ative primeiro em **Settings → Labs** da subconta. Lembre-se de criar o token dentro da subconta, não na agência.

> [accordion] Perdi o token. Posso vê-lo de novo?
>
> Não. O LeadConnector mostra o token uma única vez. Crie um novo em **Settings → Private Integrations** e cole-o com **Substituir chave**.

> [accordion] Os contatos ficam duplicados?
>
> O LeadConnector procura duplicados conforme a configuração da sua subconta. Se encontrar o contato, ele o atualiza: nome e empresa só são preenchidos se estiverem vazios, e a etiqueta é somada às que ele já tem.

> [accordion] Conectar o LeadConnector consome créditos?
>
> Não. Conectar e testar a integração não tem custo em créditos. Veja [Modelos de IA e créditos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md).

> [accordion] Posso conectar duas subcontas no mesmo agente?
>
> Não. Cada provedor admite uma única conexão por agente. Se você precisar de subcontas diferentes, use agentes separados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.