Passar para o conteúdo principal

Conecte o HubSpot ao Fin para Vendas

Ative o Fin para Vendas para conectar diretamente à sua conta HubSpot e criar conectores de dados para você.

Escrito por Beth-Ann Sher

O Fin para Vendas pode se conectar diretamente à sua conta HubSpot e criar um conector de dados funcional para você em minutos. Não requer conhecimento de API, código ou mapeamento manual de campos.

Escolha um modelo, autentique-se com o HubSpot, e nosso gerador de IA inspeciona sua instância HubSpot (incluindo seus campos personalizados) para construir um conector totalmente configurado. Revise os mapeamentos sugeridos, ajuste o que quiser e adicione à sua configuração. A partir daí, o Fin pode puxar o contexto de contato ao vivo para cada conversa de vendas e sincronizar contatos qualificados de volta para o HubSpot.

O que você pode fazer:

📥 Enriquecer Contato (leitura)

📤 Sincronizar Contato (escrita)

O Fin puxa o contexto de contato ao vivo do HubSpot para suas conversas de vendas.

O Fin sincroniza contatos qualificados para o HubSpot. Isso é um upsert: atualiza o contato correspondente se existir, ou cria um novo contato se não existir.

Nota: Dois modelos estão disponíveis: Enriquecer contato do HubSpot (leitura) e Sincronizar dados da conversa para contato do HubSpot (escrita).

Importante: configure Enriquecer Contato e Sincronizar Contato juntos

  • O conector Sincronizar contato (escrita) é um upsert, baseado no endereço de e-mail do contato. O HubSpot atualiza o contato com esse e-mail ou cria um se nenhum contato o possuir — então a Sincronização não cria duplicatas sozinha.

  • No início de uma conversa, o Fin não conhece o ID do contato no HubSpot. O conector Enriquecer Contato (leitura) é o que resolve uma pessoa que retorna para seu registro existente no HubSpot (e seu ID de contato).

  • Enriquecer é o que faz a Sincronização valer a pena. Sem ele, o Fin escreve de volta para o contato certo, mas não tem contexto para qualificar em primeiro lugar.


Antes de começar

Você precisará de uma conta HubSpot conectada (você se autentica via OAuth durante a configuração).


Como configurar

Você conecta o HubSpot ao Fin para Vendas na seção "Serviços conectados" em Fin AI Agent > Vendas > Treinar > Integrações.

Passo 1: Autenticar

Conecte o HubSpot via OAuth se ainda não o fez.

Passo 2: Escolha um modelo

Escolha Enriquecer contato do HubSpot (leitura) ou Sincronizar dados da conversa para contato do HubSpot (escrita). Para sincronizar contatos de volta, configure ambos (veja o aviso acima).

Passo 3: Forneça um e-mail de teste

Isso executa uma busca real na conta HubSpot do seu workspace para que o conector possa ser criado e testado com dados ao vivo. O e-mail precisa pertencer a um contato existente no HubSpot.

Passo 4: Deixe a IA gerar o conector

Isso leva cerca de 15–30 segundos enquanto a IA inspeciona seu esquema HubSpot, executa uma solicitação de teste e monta o conector.

Passo 5: Revise os mapeamentos de campos

Você verá uma tabela de propriedade HubSpot → atributo Intercom que pode editar antes de confirmar. Qualquer propriedade HubSpot que não corresponda a um atributo Intercom existente é automaticamente mapeada para um novo atributo com prefixo hs_ que a IA cria para você.

Passo 6: Adicione à sua configuração

  • Conector de leitura: adicione-o ao enriquecimento - ele roda no início de cada conversa.

  • Conector de escrita: anexe-o a um resultado de roteamento - ele dispara quando esse resultado é alcançado.

Nota:

  • Sincronização é um upsert: Sincronizar contato é baseado no e-mail. O HubSpot atualiza o contato com esse endereço de e-mail ou cria um se nenhum contato o possuir.

  • Atualização automática: Tokens de acesso do HubSpot expiram periodicamente. O conector atualiza automaticamente, então você não precisa reconectar toda vez.

  • Propriedades personalizadas incluídas: O Fin lê suas propriedades personalizadas do HubSpot durante a configuração, para que seus dados personalizados também possam ser mapeados.


Solução de problemas

Se você vir…

O que fazer

“Nenhum contato encontrado no HubSpot para o e-mail…” ao criar um conector

O e-mail de teste não correspondeu a um contato na sua conta HubSpot. Verifique se o e-mail existe como contato e tente novamente.

Falha na configuração ao ler suas propriedades HubSpot

Geralmente um problema de permissões ou conexão. Reconecte o HubSpot em Configurações > Integrações e execute a configuração novamente.

Uma sincronização (escrita) falha com erro de "campo obrigatório ausente"

Sua conta HubSpot exige campos que não foram coletados na conversa. Certifique-se de que esses campos obrigatórios estão sendo capturados para o resultado que tem o conector de escrita.

Conector parou de funcionar após ~1 hora

Geralmente um problema de autenticação do HubSpot. O conector deve atualizar automaticamente e tentar novamente. Se persistir, reconecte o HubSpot.

Uma falha na marcação de reunião com erro genérico "Algo deu errado" logo após o lead confirmar um horário, mesmo com permissões concedidas e perguntas obrigatórias coletadas

Verifique se o link da reunião do HubSpot tem reCAPTCHA ativado. Formulários de reunião protegidos por reCAPTCHA não são suportados pelo Fin para Vendas e causarão falha na confirmação da marcação. Desative o reCAPTCHA no formulário de reunião no HubSpot e tente marcar novamente.

Falha na autorização ao conectar o HubSpot: "Falha na autorização porque este app não foi aprovado para acessar os escopos necessários [crm.schemas.contacts.read] na sua conta."

Esse erro significa que sua conta HubSpot usa governança de apps, e o app Intercom foi aprovado sem uma de suas permissões. Um Super Admin do HubSpot precisa corrigir isso no HubSpot, indo em: Configurações > Integrações > Apps conectados > Apps aprovados, clicar em Gerenciar acesso ao lado do Intercom Auth Only, abrir Permissões de dados e ativar as configurações de Visualizar detalhes sobre propriedade para contatos.
Depois, tente reconectar no Intercom.

Após ativar a permissão, volte ao Fin AI Agent > Vendas > Treinar > Integrações no Intercom e tente reconectar o HubSpot.

Respondeu à sua pergunta?