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

# HubSpot

> Sincronize contatos nos dois sentidos com o HubSpot, registre cada conversa na timeline do HubSpot e envie modelos de WhatsApp a partir dos workflows do HubSpot.

A integração com o HubSpot mantém seus contatos em dia entre o HubSpot e a Ciarem. Cada conversa é registrada na timeline do HubSpot com um resumo de IA, as propriedades do HubSpot podem ser usadas em modelos e pelo agente de IA, e sua equipe pode enviar modelos de WhatsApp a partir dos workflows do HubSpot e para as listas do HubSpot. Os administradores a configuram em **Configurações > Integrações > HubSpot**.

## Planos

O HubSpot está incluído no **Growth** e no **Scale**, e durante o teste gratuito. Não está incluído no **Solo**. Quando um teste continua no Solo, o HubSpot para de sincronizar, e não é possível escolher o Solo com o HubSpot ainda conectado: desconecte-o antes, ou escolha Growth ou Scale. Suas configurações são mantidas, então fazer upgrade depois retoma a sincronização. Veja [Planos e faturamento](/pt/billing/plans-and-billing).

## Conectar o HubSpot

<Steps>
  <Step title="Abra a integração com o HubSpot">
    Vá em **Configurações**, depois em **Integrações**, e clique em **Conectar** no cartão do HubSpot.
  </Step>

  <Step title="Entre no HubSpot">
    Entre com um usuário do HubSpot que possa administrar o portal e aprove o acesso da Ciarem.
  </Step>

  <Step title="Conclua a configuração do HubSpot">
    De volta à Ciarem, uma configuração curta pede seus filtros de importação, seu mapeamento de propriedades e qual propriedade do HubSpot guarda as etapas do seu funil. Nada sincroniza até você concluí-la, então suas escolhas valem desde o primeiro contato.
  </Step>
</Steps>

## Enquanto o HubSpot está conectado

Os contatos são gerenciados no HubSpot. A seção **Contatos** fica oculta na Ciarem, e as variáveis de modelo usam os dados sincronizados do HubSpot. Na Caixa de entrada, o painel de detalhes de uma conversa mostra quando o contato foi sincronizado pela última vez, com **Ver no HubSpot** e **Atualizar do HubSpot**.

## O que sincroniza

* **Contatos, nos dois sentidos.** Use os **Filtros de importação** para escolher exatamente quais contatos do HubSpot sincronizam, com condições sobre as propriedades deles. Sem condições, cada contato que a Ciarem consegue acessar é importado. Um contato novo que chega por um dos seus canais é criado no HubSpot assim que tem nome ou e-mail.
* **Propriedades.** Em **Mapeamento de propriedades**, escolha as propriedades do HubSpot que você traz para a Ciarem para que os modelos e a IA as usem. O mapeamento é somente leitura por padrão. Leitura e escrita também envia ao HubSpot as alterações feitas pela IA ou pela sua equipe. Cada propriedade mapeada precisa de uma **Descrição para a IA** de até 150 caracteres. A IA aprende com ela o que a propriedade significa e quando preenchê-la, então escreva como uma instrução, por exemplo "Marcar como verdadeiro quando o contato pedir uma demo". A IA só preenche uma propriedade a partir do que o contato escreveu.
* **Etapas do funil.** Em **Etapas do funil**, escolha a propriedade de lista suspensa do HubSpot que representa seu funil, como a etapa do ciclo de vida ou o status do lead. As opções dela viram suas etapas na Ciarem, as mudanças de etapa sincronizam nos dois sentidos, e a IA as usa para acompanhar o avanço de cada contato. Uma descrição curta por etapa ajuda a IA. Trocar depois para outra propriedade substitui todas as etapas e suas configurações de IA, e redefine a etapa de cada contato a partir do HubSpot. Isso não pode ser desfeito.
* **Conversas na timeline.** Cada conversa é registrada na timeline do contato no HubSpot com um resumo de IA.
* **Tarefas, nos dois sentidos.** Com **Sincronizar tarefas** ativo (aba **Tarefas**), as [tarefas](/pt/using-ciarem/tasks) criadas na Ciarem pela sua equipe ou pela IA aparecem no HubSpot, e as tarefas criadas no HubSpot em um contato sincronizado aparecem na Ciarem. Concluir, editar e excluir também sincronizam. Tarefas associadas só a um negócio ou a uma empresa não são importadas. O proprietário do contato na Ciarem é o responsável pela tarefa, qualquer que seja o proprietário dela no HubSpot.
* **Envios via workflows e listas.** Os workflows do HubSpot podem enviar um modelo de WhatsApp, e as [transmissões](/pt/channels/broadcasts) podem ter como alvo suas listas do HubSpot.
* **Envios a partir de um registro.** Um cartão nos registros de contatos, empresas e negócios do HubSpot envia um modelo de WhatsApp sem sair do HubSpot. Um administrador do HubSpot adiciona o cartão uma vez. Veja [Enviar WhatsApp a partir de um registro do HubSpot](/pt/integrations/hubspot/record-card).

## Saúde da sincronização

A página da integração mostra a **Saúde da sincronização**: a última sincronização, quantos contatos estão vinculados e quantos não, os contatos aguardando criação no HubSpot e os erros das últimas 24 horas. Um aviso indica quando algo precisa de atenção:

* **Sincronização pausada**: a conexão precisa ser autorizada de novo. Reconecte pelo aviso.
* **Desatualizado**: os valores dos contatos em modelos e respostas da IA podem estar desatualizados até a próxima sincronização.
* **Permissão necessária**: enviar para os contatos de uma empresa ou de um negócio precisa de mais uma permissão do HubSpot. Clique em **Conceder acesso**. Sua conexão e suas configurações são mantidas.

## Desconectar

**Desconectar** interrompe a sincronização e traz de volta a seção Contatos na Ciarem. Remove o que o HubSpot trouxe: as etapas do funil sincronizadas (os contatos perdem a etapa), as propriedades importadas do HubSpot com seus valores e suas configurações de sincronização. Seus dados no próprio HubSpot não são alterados.


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