Como conectar a Econodata ao HubSpot

Com a integração ativa, toda empresa criada ou editada no seu HubSpot recebe automaticamente os dados da Econodata: CNPJ, razão social, porte, faturamento estimado, número de funcionários, CNAE, situação cadastral, cidade, UF e telefone — além dos decisores da empresa, criados como contatos associados.

Suas empresas no HubSpot passam a nascer com CNPJ, razão social, porte, faturamento, CNAE e telefone preenchidos pela Econodata.

Como a integração funciona

Três pontos definem o comportamento do conector:

Característica	O que significa
Direção única	Econodata → HubSpot. Lemos do CRM apenas o necessário para identificar a empresa.
Gatilho por evento	Não há sincronização em massa nem varredura periódica. A integração reage a empresas criadas ou editadas.
Enriquecer é preencher lacuna	Campo vazio é preenchido; campo com conteúdo digitado pela sua equipe é sempre preservado.

⚠️ O aplicativo é da sua conta HubSpot. Não existe um app da Econodata na loja do HubSpot. Você cria um aplicativo privado dentro da sua própria conta, cola duas credenciais na Econodata e configura o webhook nesse aplicativo. Por isso o passo a passo abaixo é um pouco mais longo que o de outros CRMs.

Antes de começar

No HubSpot, apenas um superadministrador consegue criar aplicativos privados. Se quem vai configurar a Econodata não é essa pessoa, combine antes com quem tem o acesso.
Tenha as duas plataformas abertas em abas separadas: você vai copiar credenciais de uma para a outra.

O processo tem três blocos:

Criar o aplicativo privado no HubSpot
Colar as credenciais na Econodata
Configurar o webhook no aplicativo

O terceiro bloco é o mais esquecido. Sem ele, a integração aparece como "Conectado" e nada acontece.

Parte 1 — No HubSpot: criar o aplicativo privado

Passo 1. Abra as configurações da conta

No HubSpot, clique no ícone de engrenagem (⚙️) no topo direito.

Passo 2. Vá em Integrações → Aplicativos privados

No menu lateral esquerdo, dentro de Gerenciamento de conta, clique em Integrações e depois em Aplicativos privados. Em seguida, clique em Criar um aplicativo privado.

Passo 3. Dê um nome ao aplicativo

Na aba Informações básicas, substitua o nome sugerido por algo reconhecível — recomendamos Econodata. O logotipo e a descrição são opcionais.

Passo 4. Abra a aba Escopos

Clique em Escopos e depois em Adicionar novo escopo.

Passo 5. Marque os seis escopos necessários

Use o campo de busca do painel e marque exatamente estes seis escopos (busque pelo nome técnico):

Escopo	Para quê
crm.objects.companies.read	Ler a empresa que disparou o evento
crm.objects.companies.write	Escrever o enriquecimento na empresa
crm.objects.contacts.read	Encontrar contatos já criados (evitar duplicatas)
crm.objects.contacts.write	Criar e atualizar os decisores
crm.schemas.companies.write	Criar as propriedades "Econodata" na empresa (primeira vez)
crm.schemas.contacts.write	Criar as propriedades "Econodata" no contato (primeira vez)

Ao terminar, clique em Atualizar. A lista de escopos selecionados deve ficar exatamente assim:

⚠️ Não pule nenhum dos seis. Os escopos de leitura são validados no momento da conexão, mas os de escrita só se revelam na primeira tentativa de escrever. Se faltar um escopo de escrita, a conexão nasce saudável e falha silenciosamente depois.

Passo 6. Crie o aplicativo

Clique em Criar aplicativo no topo direito e confirme em Continuar criando.

Passo 7. Copie o token de acesso e o client secret

Depois de criar, o HubSpot exibe o token de acesso (começa com pat-na1-…). Copie e guarde.

Na aba Auth do aplicativo, copie também o Client secret. Se precisar do token novamente, ele fica nessa mesma aba, em Show token.

Parte 2 — Na Econodata: colar as duas credenciais

Na plataforma Econodata, acesse Integrações e chaves → Conectores → CRMs e clique em Conectar HubSpot. Preencha:

Campo	Onde obter
Access token do app privado	Passo 7 (ou aba Auth → Show token)
Client secret do app privado	Passo 7 (aba Auth)

A conexão é validada na hora: verificamos o token na sua conta e fazemos uma leitura de prova por escopo.

Token inválido, aplicativo apagado ou escopo de leitura faltando → conexão recusada, nada é gravado.
Credenciais válidas → o card passa a "Conectado" e mostra o endereço do webhook, necessário no próximo passo.

⚠️ As duas credenciais têm papéis diferentes. O token é o que permite à Econodata ler e escrever no seu CRM. O client secret é o que permite ao HubSpot assinar cada evento enviado para nós. Se você colar o secret de outro aplicativo, a conexão fica verde mas todos os eventos são recusados — e o card permanece em "ainda não recebemos nenhum evento" até a correção.

Parte 3 — No HubSpot: configurar o webhook (obrigatório)

Como o aplicativo é da sua conta, a Econodata não consegue cadastrar nada nele. Essa configuração é feita por você, uma única vez.

Passo 1. Copie o endereço do webhook

No card da Econodata (Integrações e chaves → Conectores → CRMs), copie o endereço do webhook exibido após a conexão.

Passo 2. Cole na Target URL

No aplicativo privado do HubSpot, abra a aba Webhooks, cole o endereço em Target URL e salve.

Passo 3. Crie as três subscriptions

Em Subscriptions → Create subscription, crie exatamente estas três:

Object type	Event	Property
Company	Created	—
Company	Property changed	Company name
Company	Property changed	Company domain name

⚠️ O evento Property changed exige escolher uma propriedade. Sem propriedade marcada, nenhum evento é gerado. Usamos name e domain porque são as duas propriedades que a Econodata nunca escreve — então um evento delas é sempre uma edição feita pela sua equipe.

Passo 4. Clique em Commit changes

Sem o commit, nada fica ativo.

Pronto. Não há mais nenhuma tela para configurar. O card na Econodata mostra "aguardando o primeiro evento" até a primeira entrega chegar, e depois passa a "Enriquecendo suas empresas automaticamente".

O que é preenchido no HubSpot

Na empresa

Propriedades nativas do HubSpot (apenas quando estão vazias):

Propriedade nativa	Fonte Econodata
Annual revenue	Faturamento estimado
Number of employees	Funcionários
Phone number	Telefone principal
City	Cidade
State/Region	UF

Mais seis propriedades personalizadas, no grupo Econodata da empresa:

Econodata CNPJ
Razão Social
CNAE Principal
CNAE Descrição
Situação Cadastral
Porte

Cada informação vira um campo separado — não um bloco de texto — para que sua equipe possa filtrar e segmentar dentro do próprio CRM.

💡 Onde encontrar as propriedades "Econodata". Elas não aparecem no painel lateral padrão ("Informações importantes"). Vá em Ações → Ver todas as propriedades → grupo Econodata, ou adicione as que quiser ao painel em Personalizar. Quem enriquece e "não vê nada" quase sempre está olhando apenas o painel padrão.

O que não preenchemos, de propósito:

Company name — o nome da empresa é da sua equipe.
Company domain name — é a chave de deduplicação de empresas do próprio HubSpot.
Industry — é uma lista fechada do HubSpot, cujo comportamento com o CNAE brasileiro ainda não foi validado.

Nos contatos

Até 5 decisores por empresa, criados como contatos associados à empresa, com nome, e-mail e cargo nas propriedades nativas (firstname, lastname, email, jobtitle).

⚠️ Decisor sem e-mail não é criado. O e-mail é a identidade da pessoa nesta integração: é ele que evita duplicatas a cada novo evento e permite respeitar contatos que você apagou. Por isso, algumas empresas não recebem nenhum contato — e o enriquecimento ainda assim é concluído com sucesso. Não é falha: é cobertura do dado.

O HubSpot também valida o formato do e-mail e recusa os que considera inválidos. Um decisor recusado não afeta os outros nem o enriquecimento da empresa.

Como identificamos a empresa

O evento do HubSpot traz o ID da empresa. Lemos a empresa e resolvemos o CNPJ em uma cascata de três degraus, nesta ordem:

CNPJ — se a propriedade Econodata CNPJ já está preenchida, usamos ela.
Domínio — a partir de Company domain name.
Nome — busca por razão social, com limiar de confiança.

Se não houver identificação confiável, não escrevemos nada. Uma empresa errada preenchida no seu CRM é pior que um campo vazio.

Limitações que vale conhecer

Do HubSpot:

Apenas superadministradores criam aplicativos privados.
Escopos de escrita não são verificáveis antes da primeira escrita.
A subscription é configurada por você — não há API que permita à Econodata registrá-la.
Cada entrega tem 10 segundos de timeout. Em caso de falha, o HubSpot repete a tentativa por horas. Falhas persistentes fazem o HubSpot pausar a subscription do aplicativo — quem religa é você, na sua tela.
O HubSpot não deduplica empresas por propriedade personalizada: duas empresas com o mesmo Econodata CNPJ podem coexistir.

Da integração:

Escrevemos apenas em empresa e contato — não escrevemos em negócios.
Nunca sobrescrevemos um valor digitado pela sua equipe.
Sem propriedades personalizadas no contato nesta versão (o cargo vai no campo nativo jobtitle; nível de decisão, área e LinkedIn não são preenchidos).
Se a subscription for pausada pelo HubSpot, nada religa sozinho.
Alterações repetidas na mesma empresa dentro de 24 horas podem ser tratadas como repetição e não reprocessadas.

Como desconectar

No mesmo card da Econodata, clique em Desconectar — a ação é imediata e sem confirmação. Ao desconectar:

Apagamos as duas credenciais;
Paramos de enriquecer;
Os dados já enviados permanecem no HubSpot.

⚠️ Desconectar não desliga o aplicativo nem a subscription — eles são da sua conta. O HubSpot continua chamando o endereço e a Econodata apenas responde que a conexão foi encerrada (sem erro, sem retentativa). Para interromper de vez, remova a subscription ou o aplicativo privado no HubSpot.

Se você reconectar, o endereço do webhook muda (a nova conexão tem outro identificador). Atualize a Target URL no aplicativo depois de reconectar. A memória da integração é preservada dentro da mesma conta HubSpot: contatos já criados não são duplicados, e pessoas que você apagou continuam suprimidas.

Dúvidas frequentes

O card diz "Conectado", mas nada é preenchido. Quase sempre falta a Parte 3: a Target URL não foi salva, as subscriptions não foram criadas, ou o Commit changes não foi clicado.

Conectei, mas o card continua em "ainda não recebemos nenhum evento". Verifique se o client secret colado na Econodata é do mesmo aplicativo privado do token. Secret de outro aplicativo faz o HubSpot assinar eventos que nós recusamos.

Enriqueci uma empresa e não vejo os dados da Econodata. Olhe em Ações → Ver todas as propriedades → grupo Econodata. As propriedades personalizadas não aparecem no painel lateral padrão.

Empresas antigas serão enriquecidas? Não automaticamente. A integração reage a eventos: empresas criadas ou com name/domain editados. Editar uma dessas propriedades em uma empresa antiga dispara o enriquecimento dela.

Nenhum contato foi criado para uma empresa. Só criamos decisores que têm e-mail. Se nenhum decisor da base tem e-mail válido, a empresa é enriquecida e nenhum contato é criado.

Actualizado em: 11/09/2026

Esse artigo foi útil?

Obrigado!