Fin for Sales pode se conectar diretamente à sua conta HubSpot e criar um conector de dados funcional para você em minutos. Não exige conhecimento de API, nem código, nem mapeamento manual de campos.
Escolha um modelo, autentique-se no HubSpot e nosso gerador de IA inspeciona sua instância do HubSpot (incluindo seus campos personalizados) para criar um conector totalmente configurado. Revise os mapeamentos sugeridos, ajuste o que quiser e adicione à sua configuração. A partir de então, Fin pode puxar o contexto de contatos em tempo real para cada conversa de vendas e sincronizar contatos qualificados de volta para o HubSpot.
O que você pode fazer:
📥 Enriquecer contato (leitura) | 📤 Sincronizar contato (gravação) |
Fin puxa o contexto de contato em tempo real do HubSpot para suas conversas de vendas. | Fin sincroniza contatos qualificados com o HubSpot. Isso é um upsert: atualiza o contato correspondente se existir, ou cria um novo contato se não existir. |
Observação: Dois modelos estão disponíveis: Enriquecer contato do HubSpot (leitura) e Sincronizar dados da conversa para contato do HubSpot (gravação).
Importante: configure Enriquecer contato e Sincronizar contato juntos
O conector Sincronizar contato (gravação) é um upsert, com chave 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 — portanto, a Sincronização não criará duplicatas por si só.
No início de uma conversa, o Fin não conhece o ID de contato do HubSpot. O conector Enriquecer contato (leitura) é o que resolve uma pessoa recorrente 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 grava de volta no contato correto, mas não tem contexto para qualificar em primeiro lugar.
Antes de começar
Você precisará de uma conta HubSpot conectada (você se autenticará via OAuth durante a configuração).
Como configurar
Você conecta o HubSpot ao Fin for Sales na seção "Serviços conectados" em Fin AI Agent > Sales > Train > Integrations.
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 (gravação). Para sincronizar contatos de volta, configure ambos (veja o aviso acima).
Passo 3: Forneça um e-mail de teste
Isso executa uma pesquisa real contra a 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 HubSpot existente.
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 você pode editar antes de confirmar. Qualquer propriedade do 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 enrichment - ele é executado no início de cada conversa.
Conector de gravação: anexe-o a um resultado de roteamento - ele é acionado quando esse resultado é alcançado.
Observação:
A sincronia é um upsert: O Sync contact é indexado pelo 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: os tokens de acesso do HubSpot expiram periodicamente. O conector atualiza automaticamente, portanto você não precisa reconectar toda vez.
Propriedades personalizadas incluídas: Fin lê suas propriedades personalizadas do HubSpot durante a configuração, para que seus dados personalizados também possam ser mapeados.
Resoluçã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. |
A configuração falha ao ler suas propriedades do HubSpot | Normalmente 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 (gravação) falha com o erro "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 gravação. |
O conector parou de funcionar após ~1 hora | Normalmente um problema de autenticação do HubSpot. O conector deve atualizar automaticamente e tentar novamente. Se persistir, reconecte o HubSpot. |
Ainda travado? Entre em contato com nossa equipe e nós ajudaremos você a configurar.