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 AI inspeciona sua instância 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 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 por conta própria.
No início de uma conversa, o Fin não sabe 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 inicialmente.
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 destaque 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 AI gerar o conector
Isso leva cerca de 15–30 segundos enquanto a AI inspeciona seu esquema HubSpot, executa uma solicitação de teste e monta o conector.
Passo 5: Revise os mapeamentos de campo
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 AI 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 requer 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 reserva de reunião falha 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 reserva. Desative o reCAPTCHA no formulário de reunião no HubSpot e tente reservar novamente. |