Integração do nexo com o HubSpot

Como conectar o HubSpot ao nexo, quais permissões o aplicativo pede, o que ele lê, o que ele escreve e como desconectar.

Última atualização: 3 de outubro de 2026

O que a integração faz

O nexo lê os negócios, as empresas, os contatos, os responsáveis e as atividades do seu HubSpot e cruza isso com as reuniões gravadas e as conversas do time. Com isso ele mostra a cada vendedor o que fazer no dia, mostra ao líder onde a meta está em risco e atualiza no CRM o que saiu das conversas: próximo passo, datas, valor, concorrente, dor, critério de decisão, motivo de perda, cargo do contato, além de notas e contatos novos.

O HubSpot continua sendo a fonte da verdade. Cada atualização é gravada campo a campo, com o trecho da conversa que a sustenta, e o nexo nunca apaga nada.

Antes de começar

  • Uma conta do HubSpot com o CRM em uso. Algumas leituras, como metas, dependem da edição da sua conta.
  • Ser administrador da empresa no nexo. Só administradores conectam ou desconectam o CRM.
  • No HubSpot, ser super admin ou ter a permissão de instalar aplicativos do marketplace. Sem ela, o HubSpot não mostra a tela de autorização.

Como conectar

  1. Entre no nexo e abra Minha empresa.
  2. No cartão do HubSpot, clique em Conectar HubSpot.
  3. O HubSpot abre a tela de autorização. Se você tiver mais de uma conta, escolha a conta da empresa, confira as permissões e clique em conectar.
  4. O HubSpot devolve você ao nexo, que termina a conexão sozinho. A primeira leitura traz os últimos 12 meses e roda em segundo plano; o painel começa a encher enquanto ela acontece.

O link de autorização vale por 10 minutos e só para o administrador que começou a conexão. Se ele expirar, é só clicar em Conectar HubSpot de novo.

Permissões pedidas e por quê

Pedimos só o que o nexo usa. Estas são obrigatórias:

  • oauth identificar a conta do HubSpot que foi conectada e renovar o acesso sem pedir login de novo.
  • crm.objects.deals.read ler os negócios, os funis e as etapas, que são a base de todas as análises.
  • crm.objects.deals.write gravar no negócio os campos atualizados a partir das conversas e as notas de reunião aprovadas.
  • crm.objects.companies.read ler as empresas ligadas aos negócios: segmento, porte, local e responsável.
  • crm.objects.companies.write gravar um campo de empresa atualizado a partir das conversas.
  • crm.objects.contacts.read ler os contatos dos negócios, para saber quem participa de cada venda.
  • crm.objects.contacts.write criar um contato que apareceu numa conversa e ligá-lo ao negócio, depois que alguém aprova, e atualizar cargo e papel de quem já existe.
  • crm.objects.owners.read ler os responsáveis e os times, para montar a visão de cada vendedor e de cada líder.
  • crm.schemas.deals.read ler quais propriedades os negócios têm, inclusive as personalizadas da sua conta.
  • crm.schemas.companies.read ler quais propriedades as empresas têm.
  • crm.schemas.contacts.read ler quais propriedades os contatos têm.

Estas são opcionais. Se a sua conta não tiver acesso a elas, a instalação segue e a função correspondente fica desligada:

  • crm.objects.goals.read ler as metas cadastradas no HubSpot. Sem esse acesso, o nexo sugere uma meta pelo histórico para você aceitar ou ajustar.
  • crm.schemas.deals.write criar uma propriedade nova de negócio quando a empresa pede para guardar no CRM um dado que ele ainda não tem.

Dados que vêm e que voltam

O que o nexo lê do HubSpot

Dados que o nexo lê do HubSpot
O quê Detalhe
Negócios nome, funil, etapa, valor, moeda, datas, motivo de ganho ou perda, previsão, próximo passo e responsável.
Funis e etapas quais funis existem e em que ordem estão as etapas.
Empresas nome, domínio, segmento, número de funcionários, receita anual, cidade, estado, país e responsável.
Contatos nome, e-mail, telefone, cargo, empresa e responsável.
Responsáveis e times quem é cada vendedor no HubSpot e de qual time ele faz parte.
Propriedades a definição dos campos de negócios, empresas e contatos, incluindo os personalizados.
Metas as metas de cada vendedor, quando a conta tem metas e o acesso opcional foi concedido.
Atividades notas, chamadas, reuniões e e-mails ligados aos negócios, quando a conta permite essa leitura.

O que o nexo escreve no HubSpot

Por padrão, tudo abaixo passa antes pela tela de Revisão do nexo, onde alguém da empresa aprova, edita ou descarta cada item. O admin pode ligar a aprovação automática: aí as sugestões de campo com confiança alta são gravadas direto e aparecem no histórico da Revisão como automáticas. Etapa, contato novo e nota de reunião sempre esperam alguém aprovar, e uma sugestão cujo campo foi mudado no HubSpot volta para revisão.

Dados que o nexo escreve no HubSpot
O quê Detalhe
Campos o valor de um campo de negócio, empresa ou contato, um campo de cada vez, aprovado na Revisão ou pela aprovação automática, quando o admin a ligou.
Notas uma nota no negócio com o resumo aprovado de uma conversa.
Contatos um contato novo, ligado ao negócio, sempre depois que alguém aprova.
Propriedades de negócio uma propriedade nova de negócio, só quando a empresa pede e concedeu o acesso opcional.

Os tokens de acesso ficam cifrados. O tratamento desses dados está descrito na Política de Privacidade.

Como a cópia se mantém em dia

Depois da primeira leitura, o HubSpot avisa o nexo a cada mudança relevante, e uma conferência a cada 30 minutos pega o que tiver escapado. Os avisos que o aplicativo recebe são estes:

  • Negócios: criação, exclusão, restauração e mudança destas propriedades: dealname , pipeline , dealstage , amount , deal_currency_code , closedate , closed_lost_reason , closed_won_reason , hubspot_owner_id , hs_forecast_category , hs_next_step .
  • Empresas: criação, exclusão, restauração e mudança destas propriedades: name , domain , industry , numberofemployees , annualrevenue , city , state , country , hubspot_owner_id .
  • Contatos: criação, exclusão, restauração, exclusão por pedido de privacidade e mudança destas propriedades: firstname , lastname , email , phone , mobilephone , jobtitle , associatedcompanyid , hubspot_owner_id .

Como desconectar

Em Minha empresa, um administrador clica em desconectar o HubSpot. O nexo para a leitura e os avisos na hora e revoga o acesso no HubSpot.

Se o aplicativo for desinstalado pelo próprio HubSpot, em Configurações → Integrações → Aplicativos conectados, o acesso deixa de valer e o nexo marca a conexão como inválida na próxima conferência, em até 30 minutos, e avisa os administradores.

Os dados já lidos seguem o prazo de guarda da Política de Privacidade, e você pode pedir a exclusão antes disso pela página de exclusão de dados. Desconectar não apaga nada no HubSpot.

Preço

A integração com o HubSpot faz parte do nexo e não tem custo à parte. Veja a página de preços.

Ajuda

Se a conexão falhar ou algum dado não aparecer, escreva para [email protected] com o nome da empresa e o horário aproximado. Mais canais e prazos estão na página de suporte.