Pular para o conteúdo principal

Minotaur × HubSpot — Guia de Integração

App: Integração Minotaur HubSpot
Publicado por: Minotaur Sales
Compatível com: app.minotaursales.io

Visão geral​

A integração do Minotaur com o HubSpot permite que você enriqueça registros existentes do HubSpot com dados do seu CRM do Minotaur:

  • Envie dados de contatos do Minotaur para contatos correspondentes no HubSpot.
  • Envie dados de empresas do Minotaur para empresas correspondentes no HubSpot.
  • Sincronize registros selecionados ou uma lista de contatos inteira sob demanda.
  • Monitore o progresso da sincronização via notificações no app e um registro de integração dedicado.

Comportamento importante: Esta integração é somente de atualização e unidirecional (Minotaur → HubSpot). Ela apenas atualiza registros que já existem no HubSpot. Se um contato ou empresa do Minotaur não corresponder a um registro existente no HubSpot, esse registro será ignorado — nada é criado. Nenhum dado é obtido do HubSpot para o Minotaur.

Escopo desta integração: Apenas Contatos e Empresas. A sincronização de Negócios (Deals) não é suportada.

Pré-requisitos​

RequisitoDetalhes
Conta do HubSpotUma conta do HubSpot (Sales Hub ou qualquer plano que inclua o CRM).
Permissões do HubSpotVocê deve ter permissão para instalar apps e ler/editar contatos e empresas no HubSpot.
Registros existentes no HubSpotOs registros devem existir no HubSpot para serem atualizados. O Minotaur não cria novos contatos ou empresas no HubSpot.
Conta do MinotaurVocê deve estar autenticado em app.minotaursales.io e ter acesso a Configurações.

Adicionar a integração (Instalar e Conectar)​

  1. Faça login em app.minotaursales.io.
  2. Navegue até Configurações → Conexões → HubSpot.
  3. Clique em Conectar.
  4. Uma nova aba se abre com a página de autorização do HubSpot. Faça login na sua conta do HubSpot e revise as permissões solicitadas.
  5. Clique em Conectar app.
  6. A aba se fecha e você é redirecionado para o Minotaur. A página de conexão mostra Conectado com o nome e ID do portal do HubSpot.

Configurar o mapeamento de campos (Obrigatório antes de sincronizar)​

Antes de sincronizar dados, você deve configurar quais campos do Minotaur correspondem a quais campos do HubSpot. A sincronização falhará com um erro de "mapping not found" se esta etapa for ignorada.

  1. Vá para Configurações → Conexões → HubSpot → Mapeamento de campos.
  2. Configure o mapeamento de campos de contatos.
  3. Configure o mapeamento de campos de empresas.
  4. Revise e salve seus mapeamentos.

Os campos de e-mail e telefone estão excluídos da sincronização (usados apenas para correspondência, não são gravados no HubSpot).

Usar a integração​

Sincronizar contatos selecionados​

  1. Vá para Meus Contatos (ou qualquer tabela de contatos).
  2. Selecione um ou mais contatos usando as caixas de seleção.
  3. Clique em Sincronizar com HubSpot na barra de ferramentas.
  4. Confirme a ação. O Minotaur enfileira os contatos selecionados para sincronização.
  5. Você receberá uma notificação quando a sincronização for concluída. Veja os resultados em Configurações → Registros de integração → HubSpot.

Sincronizar empresas selecionadas​

  1. Vá para a tabela de Empresas.
  2. Selecione uma ou mais empresas.
  3. Clique em Sincronizar com HubSpot e confirme.

Sincronizar uma lista de contatos inteira​

  1. Vá para Listas e abra uma lista de contatos.
  2. Clique em Sincronizar com HubSpot.
  3. Confirme a ação. Todos os contatos da lista são enfileirados para sincronização.

Como funciona a correspondência​

O Minotaur faz a correspondência de um contato do Minotaur com um contato do HubSpot usando:

  1. Os campos designados como campos-chave no seu mapeamento.
  2. O e-mail de trabalho ou e-mail pessoal do contato (sempre usado como pesquisa).

Se nenhum contato correspondente for encontrado no HubSpot, o registro é ignorado (não é criado).

Pausar sincronização​

  1. Vá para Configurações → Conexões → HubSpot.
  2. Clique em Pausar sincronização no cartão de status.

Enquanto pausada, os botões "Sincronizar com HubSpot" ficam ocultos. Ative novamente para Retomar sincronização.

Remover a integração​

  1. Vá para Configurações → Conexões → HubSpot.
  2. Clique em Desconectar e confirme.
  3. O Minotaur remove seus tokens OAuth armazenados e revoga o token de atualização do HubSpot.

Solução de problemas / Perguntas frequentes​

Erro "Mapping not found" ao sincronizar​

Os mapeamentos de campos não foram configurados. Vá para Configurações → Conexões → HubSpot → Mapeamento de campos e complete o mapeamento antes de sincronizar.

Os registros foram enfileirados, mas nada foi atualizado no HubSpot​

O Minotaur não conseguiu encontrar um contato ou empresa correspondente no HubSpot. Esta integração é somente de atualização — se o registro não existir no HubSpot com o mesmo e-mail ou campo-chave, será ignorado.

Os Negócios (Deals) não estão sincronizando​

A sincronização de Negócios não é suportada na versão atual. Apenas Contatos e Empresas podem ser sincronizados.

A conexão mostra "Expirada"​

Vá para Configurações → Conexões → HubSpot, clique em Desconectar e depois em Conectar novamente.

Dados e Privacidade​

Tipo de dadoComo é usado
Tokens OAuth do HubSpotArmazenados com segurança no banco de dados do Minotaur, com escopo para o seu usuário.
Informações do portal do HubSpotExibidas no cartão de status da conexão. Não são compartilhadas externamente.
Campos de enriquecimento do MinotaurEnviados unidirecionalmente ao HubSpot para atualizar registros correspondentes. Os valores de e-mail e telefone nunca são gravados no HubSpot.

Suporte​

Para obter ajuda com esta integração, entre em contato com o suporte do Minotaur:

Para problemas específicos do HubSpot: