> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.econodata.com.br/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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**: 1. Criar o aplicativo privado no HubSpot 2. Colar as credenciais na Econodata 3. 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-17_1a6u9za.png) ### 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_z8bi7y.png) ### 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1moqbbp.png) ### Passo 4. Abra a aba Escopos Clique em **Escopos** e depois em **Adicionar novo escopo**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_gbemj9.png) ### 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) | ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1h565fm.png) Ao terminar, clique em **Atualizar**. A lista de escopos selecionados deve ficar exatamente assim: ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_l6zohy.png) || ⚠️ 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1341mjj.png) ### 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**. ![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1xpb119.png) ## 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: 1. **CNPJ** — se a propriedade *Econodata CNPJ* já está preenchida, usamos ela. 2. **Domínio** — a partir de *Company domain name*. 3. **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.