> ## 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. # HubSpot > Como conectar o HubSpot a um agente do ChatNorris com uma chave de serviço e o que o agente sincroniza no seu CRM: contatos, empresas e objetos Lead. # HubSpot Com a integração do HubSpot, os leads que o seu agente do ChatNorris confirma chegam sozinhos ao seu CRM, sem sair do chat nem exportar nada manualmente. Quando o agente tem o email de um visitante confirmado, conforme o que você ativar, ele: * cria ou atualiza o visitante como Contact no HubSpot; * procura ou cria a empresa dele e a associa ao contato; * cria um registro Lead associado ao contato. O ChatNorris nunca lê nem modifica nenhum outro dado da sua conta do HubSpot. ## 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). * Uma conta do HubSpot em que você possa criar uma chave de serviço (ou um token de Private App que você já tenha). * Para o recurso **Criar objeto Lead**, que a sua conta do HubSpot tenha a ferramenta Leads disponível. * Função **Owner** ou **Admin** na sua organização do ChatNorris. ## Conectar o HubSpot Cada agente se conecta a uma conta do HubSpot. **1. Crie a chave de serviço no HubSpot** No HubSpot, vá para **Desenvolvimento → Chaves → Chaves de serviço** e crie uma chave nova. Um token de Private App existente também funciona. **2. Conceda os escopos** Os escopos de contatos são obrigatórios. Os de empresas e leads só são necessários se você for ativar esses recursos na Ação: | Escopos | Para quê | | - | - | | `crm.objects.contacts.read` e `crm.objects.contacts.write` | Obrigatórios: **Sincronizar contato**. | | `crm.objects.companies.read` e `crm.objects.companies.write` | **Sincronizar empresa**. | | `crm.objects.leads.read` e `crm.objects.leads.write` | **Criar objeto Lead**. | Crie a chave e copie-a. **3. Abra o hub de Integrações do agente** No ChatNorris, entre em `Agentes → [seu agente] → Integrações` e escolha **HubSpot**. **4. Cole a chave e conecte** Cole a chave em **Chave de serviço** e clique em **Conectar**. Com **Testar conexão**, você confirma que a chave funciona antes de usá-la na Ação. A chave é salva no ChatNorris e o hub só mostra os últimos 4 caracteres. Se você trocá-la no HubSpot, 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 o HubSpot ainda não sincroniza nada. Para escolher o que o agente faz no seu CRM: **1. Crie a Ação HubSpot** Entre em `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **HubSpot**. **2. Escolha os recursos** Ative os que você quiser (veja a tabela abaixo). Os três são independentes, mas hierárquicos: **Sincronizar empresa** e **Criar objeto Lead** 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 leads confirmados deste agente chegam ao HubSpot. | Recurso | O que faz no HubSpot | Escopos do HubSpot | | - | - | - | | **Sincronizar contato** | Cria ou atualiza um Contact sempre que o email de um visitante é confirmado. Os contatos novos entram como Lead com status **Novo**; os existentes nunca são sobrescritos. | `crm.objects.contacts.read` e `.write` | | **Sincronizar empresa** | Procura a empresa do visitante pelo nome exato, cria-a se não existir e a associa ao contato. Usa a propriedade Empresa do lead ou, se ela não existir, o campo personalizado "Empresa"/"Company". | `crm.objects.companies.read` e `.write` | | **Criar objeto Lead** | Cria um registro Lead associado ao contato, uma única vez por lead. Requer que a sua conta do HubSpot tenha a ferramenta Leads disponível. | `crm.objects.leads.read` e `.write` | > [!NOTE] > > A sincronização se repete sempre que o agente tem o email do visitante confirmado: o HubSpot cria o contato ou atualiza o existente (procura por email), então um telefone ou um nome que o visitante preencher mais tarde também chega ao HubSpot, desde que esse dado esteja vazio no contato. Só o objeto Lead é criado uma única vez por lead. ## Desconectar Em `Agentes → [seu agente] → Integrações → HubSpot`, clique em **Desconectar** (também está no menu **···** da linha). A sincronização de leads é desabilitada: a Ação HubSpot é desativada, mas não é apagada e mantém sua configuração. A chave é apagada do ChatNorris. Para voltar a sincronizar, conecte o HubSpot novamente e reative a Ação. Se você só quiser interrompê-la por um tempo, desative a chave **Ativa** da integração: a chave de serviço é mantida e a Ação não chama o HubSpot até que você a reative. ## Perguntas frequentes > [accordion] Posso usar um token de Private App em vez de uma chave de serviço? > > Sim. Um token de Private App existente continua funcionando: cole-o no mesmo campo **Chave de serviço**. Confira se ele tem os escopos dos recursos que você vai ativar. > [accordion] A sincronização sobrescreve os dados que eu já tenho no HubSpot? > > Não. Se o contato já existe (o ChatNorris o procura por email), só são preenchidos o nome, o sobrenome e o telefone que estiverem vazios no HubSpot; se não faltar nada, o contato não é alterado. A etapa e o status de lead dele também não mudam, porque ele pode estar mais avançado no seu funil. Os contatos novos entram como Lead com status **Novo**. > [accordion] O objeto Lead não é criado > > Confira se **Criar objeto Lead** está ativo, se a chave tem os escopos `crm.objects.leads.read` e `crm.objects.leads.write` e se a sua conta do HubSpot tem a ferramenta Leads disponível. O objeto Lead é criado uma única vez por lead. > [accordion] Conectar o HubSpot 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 contas do HubSpot no mesmo agente? > > Não. Cada provedor admite uma única conexão por agente. Se você precisar de contas diferentes, use agentes separados. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.