Integrações da API Econodata: como conectar seus dados ao CRM, automações e sistemas

Uma integração entre uma plataforma de inteligência comercial e o CRM não serve apenas para eliminar algumas tarefas manuais.

Quando bem estruturada, ela transforma dados empresariais em parte do processo comercial.

Um lead pode entrar no CRM apenas com e-mail corporativo e empresa. A partir daí, uma automação identifica o CNPJ, recupera informações sobre porte, CNAE, faturamento e outros atributos e utiliza esses dados para qualificar, segmentar ou rotear aquela oportunidade.

É exatamente aí que entram as integrações da API Econodata.

A API V4 permite consultar empresas, enriquecer registros individuais ou em lote, encontrar organizações quando o CNPJ não está disponível, segmentar mercados, consultar pessoas e decisores e levar esses dados para CRMs, automações, sistemas internos, data warehouses e agentes de IA.

É possível trabalhar com:

• Ploomes: integração plug and play;
• Moskit: integração plug and play;
• Zapier: automações no-code;
• Make: automações no-code;
• n8n: automações com maior controle técnico e possibilidade de self-hosting;
• RD Station CRM: integração nativa disponível;
• HubSpot: integração nativa em breve;
• API REST: integração direta com sistemas próprios.

Importante: Enquanto o conector nativo do HubSpot não estiver disponível, é possível construir fluxos usando Zapier, Make ou diretamente a API REST.

Para conhecer a solução, consulte a página da API Econodata. Para endpoints, contratos, parâmetros e detalhes de implementação, consulte a documentação oficial da API V4 Econodata.

Como funciona a API Econodata

Antes de falar sobre cada conector, é importante separar operações diferentes que costumam ser colocadas no mesmo balaio: consulta de empresas conhecidas, match, enriquecimento em lote, segmentação e consulta de pessoas.

Essa diferença também ajuda a desenhar uma integração mais eficiente. Uma empresa que já possui o CNPJ de seus clientes não precisa executar o mesmo processo de outra que recebe leads apenas com nome da companhia e e-mail corporativo.

Para aprofundar esse tema, vale consultar também o conteúdo sobre API e enriquecimento de dados em vendas B2B e o comparativo de APIs de consulta de CNPJ.

Consulta de uma empresa conhecida

Quando seu sistema já possui um identificador confiável, a API pode localizar diretamente uma empresa.

A consulta pode trabalhar com identificadores como:

• CNPJ;
• raiz do CNPJ;
• site;
• e-mail.

Quando o CNPJ está disponível, ele normalmente oferece o caminho mais direto para identificar juridicamente a organização correta.

Match quando o CNPJ não está disponível

Nem todo lead inbound chega com CNPJ.

Em muitos formulários, Marketing coleta apenas nome, empresa, e-mail corporativo, telefone ou site.

Nesses cenários, a API possui uma capacidade de match, que permite encontrar candidatos a partir das informações disponíveis e trabalhar com um score de confiança.

Uma operação pode utilizar uma lógica semelhante a esta:

• score alto: enriquecimento automático;
• score intermediário: revisão;
• score baixo: não atualizar automaticamente.

Essa camada é importante porque reduz o risco de enriquecer o registro correto com os dados da empresa errada.

Enriquecimento em lote

Quando a operação precisa trabalhar com uma base existente, não é necessário processar manualmente um CNPJ por vez.

A API V4 permite trabalhar com lotes de até 100 CNPJs por operação de lookup em lote.

Esse modelo é especialmente útil para:

• reenriquecimento periódico do CRM;
• atualização de bases legadas;
• conferência de registros;
• projetos de dados e analytics;
• preparação de listas para campanhas.

Para entender melhor por que esse processo impacta vendas, veja também o guia sobre enriquecimento de dados B2B.

Segmentação de empresas

A API Econodata não serve apenas para enriquecer empresas que sua organização já conhece.

Ela também pode fazer parte de fluxos de segmentação de mercado, permitindo construir recortes de empresas a partir de atributos disponíveis na solução.

Entre os critérios utilizados nesse tipo de operação podem estar:

• localização;
• CNAE;
• setor;
• porte;
• faturamento;
• número de funcionários.

Assim, uma mesma infraestrutura pode participar tanto de processos de inbound e enriquecimento quanto da prospecção outbound.

Pessoas, decisores e organograma

Existe uma diferença técnica importante neste ponto: decisores não devem ser tratados simplesmente como mais um campo de contatos avançados da empresa.

A API possui uma capacidade específica para trabalhar com pessoas e organograma.

Por isso, na arquitetura da integração, vale pensar em dois fluxos:

empresa → atributos empresariais

e

empresa → pessoas e organograma

Essa separação deixa o modelo de dados mais consistente e evita misturar informações de uma organização com atributos pertencentes a uma pessoa.

Quais dados podem ser enriquecidos?

A API Econodata organiza informações empresariais em diferentes grupos de dados.

Dados de identificação

• CNPJ;
• razão social;
• nome fantasia;
• situação cadastral;
• tipo de unidade;
• UF;
• cidade.

Perfil cadastral

• CNAE primário;
• CNAEs secundários;
• natureza jurídica;
• regime tributário;
• enquadramento de porte;
• data de abertura;
• capital social.

Dados estratégicos

Dependendo da informação contratada e disponibilizada pela API, podem ser utilizados atributos como:

• faturamento;
• número de funcionários;
• porte;
• comércio exterior;
• grupo econômico;
• filiais;
• tecnologias utilizadas.

Dados de contato

As informações disponíveis podem envolver:

• telefones;
• e-mails;
• websites;
• redes sociais;
• atributos de assertividade ou qualidade associados ao dado, quando disponíveis.

Pessoas e organograma

A consulta de pessoas deve ser tratada separadamente do enriquecimento cadastral da organização.

Dependendo da operação e do plano contratado, podem existir informações relacionadas a:

• decisores;
• colaboradores;
• cargos;
• sócios;
• contatos profissionais.

Na prática, isso permite enriquecer primeiro a conta e depois identificar as pessoas relevantes para uma estratégia de prospecção baseada em contas.

Quais campos devem ir para o CRM?

A disponibilidade de dezenas de atributos não significa que todos devam ser enviados ao CRM.

A integração deve priorizar dados que mudam alguma decisão.

Antes de criar um novo campo, pergunte:

• isso ajuda a qualificar?
• isso ajuda a segmentar?
• isso altera a priorização?
• isso muda o roteamento?
• isso ajuda o vendedor na abordagem?
• isso será usado em análise?

Para uma visão mais ampla sobre arquitetura comercial, leia também o guia Integração entre ferramentas: como otimizar processos e resultados em vendas.

Integração Econodata + Ploomes

Como funciona a integração com Ploomes?

A integração entre Econodata e Ploomes foi pensada para reduzir as etapas entre a construção de uma lista e sua utilização pelo time comercial.

Empresas selecionadas na Econodata podem ser enviadas ao CRM sem que o usuário precise criar um processo manual baseado em exportação e reimportação de planilhas.

Dependendo da configuração utilizada, o fluxo pode envolver registros de Empresa, Pessoa e Negócio.

O que pode ser enriquecido no Ploomes?

O mapeamento efetivo depende dos objetos e campos disponíveis na integração e da configuração realizada no ambiente do CRM.

Nem todo campo existente na API Econodata necessariamente faz parte do conector plug and play.

Quando o projeto exige campos ou regras que não são cobertos pelo conector, a integração direta pela API REST pode ser considerada.

Passo a passo para configurar Econodata e Ploomes

1. Acesse as integrações.

Na plataforma Econodata, abra a área administrativa de integrações e localize o Ploomes.

2. Gere ou copie a credencial solicitada.

Siga o fluxo de autorização apresentado pela integração.

3. Abra a área de integrações do Ploomes.

Localize a Econodata e informe a credencial solicitada pelo fluxo.

4. Defina o comportamento.

Configure como Empresas, Pessoas e, quando aplicável, Negócios deverão ser criados.

Se o fluxo gerar negócios, valide também o pipeline e a etapa de entrada.

5. Faça um teste antes de ampliar o uso.

Envie poucos registros e confira:

• duplicidade;
• CNPJ;
• campos personalizados;
• responsável;
• pipeline;
• etapa.

FAQ: Econodata e Ploomes

A integração com Ploomes precisa de programação?
Não para o fluxo plug and play suportado pelo conector.

Posso enviar empresas pesquisadas na Econodata diretamente?
Sim. Esse é um dos principais casos de uso da integração.

Posso criar negócios no CRM?
Isso depende das opções disponibilizadas e da configuração aplicada à integração.

O CNPJ deve ser usado como identificador?
Sempre que estiver disponível, o CNPJ é uma chave importante para identificação e deduplicação de empresas.

Posso trabalhar com campos que não existem no conector?
Se o projeto exigir um fluxo muito personalizado, consulte a documentação da API V4.

Integração Econodata + Moskit

Como funciona a integração com Moskit?

O Moskit também possui um fluxo voltado ao envio de empresas selecionadas na Econodata diretamente ao ambiente de CRM.

Depois da configuração, o time pode pesquisar empresas, selecionar as contas desejadas e enviá-las ao sistema comercial.

O objetivo é diminuir a distância entre segmentação e execução da prospecção.

O que pode ser enriquecido no Moskit?

Dependendo do mapeamento existente no conector, podem ser utilizados dados como:

• CNPJ;
• razão social;
• dados cadastrais;
• características empresariais;
• contatos;
• campos personalizados.

O CNPJ também pode desempenhar um papel importante na identificação de empresas já existentes no CRM.

Passo a passo para configurar Econodata e Moskit

1. Abra Integrações na Econodata.

Localize o Moskit.

2. Copie a credencial de integração.

Utilize o token ou mecanismo de autenticação apresentado pelo fluxo.

3. Abra o Marketplace ou área equivalente do Moskit.

Localize a Econodata e conclua a conexão.

4. Configure o proprietário dos registros.

Quando essa opção estiver disponível, determine quem será responsável pelos registros recebidos.

5. Envie uma lista de teste.

Antes de processar uma campanha inteira, confira:

• empresa existente;
• empresa nova;
• CNPJ;
• campos personalizados;
• origem;
• proprietário.

FAQ: Econodata e Moskit

A Econodata envia empresas diretamente para o Moskit?
Sim, por meio da integração disponível entre as plataformas.

Preciso exportar CSV primeiro?
O objetivo da integração é justamente diminuir a dependência desse tipo de processo manual.

O CNPJ pode ajudar a evitar registros duplicados?
Sim. Ele é um dos identificadores mais úteis para esse tipo de regra.

É possível identificar a origem dos registros?
Isso depende dos campos e propriedades configurados no fluxo utilizado.

Posso usar a API caso precise de uma lógica diferente?
Sim. Projetos que ultrapassam as capacidades do conector podem utilizar diretamente a API Econodata.

Integração Econodata + Zapier

Como funciona a integração com Zapier?

O Zapier pode atuar como uma camada de automação entre a Econodata e outro sistema.

Um fluxo típico é:

novo registro → consultar Econodata → enriquecer dados → atualizar CRM

Por exemplo:

Lead entra no CRM → Zapier captura CNPJ ou domínio → Econodata identifica a empresa → dados empresariais são retornados → CRM é atualizado.

Esse modelo permite criar automações sem desenvolver toda a integração do zero.

O que pode ser enriquecido pelo Zapier?

Dependendo das ações disponibilizadas pela versão do conector, a automação pode aproveitar diferentes recursos da API, como:

• localizar empresa;
• enriquecer dados por CNPJ;
• trabalhar com lotes;
• segmentar;
• consultar pesquisas;
• consultar grupo econômico;
• trabalhar com pessoas e decisores;
• verificar saldo.

Passo a passo para configurar Econodata e Zapier

1. Gere uma API Key.

Na área de integrações da Econodata, gere uma chave para a API V4.

2. Crie o Zap.

Defina qual evento iniciará a automação.

Exemplo: criação de uma nova empresa no CRM.

3. Adicione a Econodata ao fluxo.

Selecione a ação correspondente à consulta necessária.

4. Informe o identificador.

Mapeie o CNPJ, domínio ou outro atributo compatível com a operação selecionada.

Se você não possuir um CNPJ e precisar identificar a empresa, utilize uma operação de match em vez de tratar uma aproximação como correspondência exata.

5. Escolha somente os dados necessários.

Solicite as informações que serão realmente utilizadas nas etapas seguintes.

6. Atualize o sistema de destino.

Mapeie cada retorno para sua propriedade equivalente.

Exemplo:

• faturamento → faturamento estimado;
• porte → porte da empresa;
• CNAE → CNAE principal;
• funcionários → número de funcionários.

FAQ: Econodata e Zapier

Preciso programar?
Não para um fluxo padrão suportado pelas ações disponíveis no conector.

Consigo enriquecer uma empresa pelo CNPJ?
Sim.

A API possui enriquecimento em lote?
Sim. A API V4 suporta lookup de até 100 CNPJs por lote. A disponibilidade dessa operação diretamente no conector deve ser conferida na versão utilizada.

Posso consultar decisores?
A API possui capacidade específica para pessoas e organograma. A utilização pelo Zapier depende das ações expostas pelo conector.

Zapier pode ser usado com HubSpot?
Sim, como camada intermediária, desde que as ações necessárias também sejam suportadas pelo HubSpot no Zapier. Isso é diferente de uma integração nativa direta Econodata + HubSpot.

Integração Econodata + Make

Como funciona a integração com Make?

O Make utiliza cenários visuais compostos por diferentes módulos e regras.

Ele é especialmente útil quando o enriquecimento não termina em uma simples atualização de propriedade.

Um cenário pode seguir esta lógica:

lead criado → consultar empresa na Econodata → analisar faturamento → verificar ICP → direcionar para vendas ou nutrição

Nesse modelo, o enriquecimento deixa de ser apenas cadastro e passa a interferir diretamente no processo comercial.

O que pode ser enriquecido pelo Make?

Os cenários podem trabalhar com os campos disponibilizados pelas operações da API.

Os grupos empresariais incluem:

• cadastro;
• estrategico;
• perfilNegocio;
• contatosBasicos;
• contatosAvancados.

Para pessoas e decisores, utilize a operação correspondente a pessoas e organograma, em vez de pressupor que todo o organograma faz parte dos contatos da empresa.

Passo a passo para configurar Econodata e Make

1. Gere a chave da API.

Crie a credencial na área de Integrações da Econodata.

2. Crie um Scenario.

No Make, abra um novo cenário.

3. Adicione a Econodata.

Selecione o módulo correspondente à operação desejada.

4. Faça a autenticação.

Informe a chave gerada para a conexão.

5. Determine o identificador.

Quando possível, utilize CNPJ. Se ele não estiver disponível, utilize a capacidade de match apropriada.

6. Mapeie os resultados.

Envie cada atributo para a propriedade correspondente no sistema de destino.

7. Adicione regras de negócio.

Exemplo:

faturamento + funcionários + CNAE → classificação ICP

Esse tipo de lógica conecta inteligência de dados diretamente ao funil comercial. Para aprofundar essa arquitetura, leia também o conteúdo sobre funil de vendas com IA.

FAQ: Econodata e Make

Preciso saber programar?
Não para cenários comuns, embora conhecer lógica de automação facilite a criação de fluxos mais complexos.

É possível consultar empresas sem CNPJ?
Sim. A API possui mecanismos de match para situações em que o identificador não está disponível.

É possível obter um score de confiança?
O processo de match permite trabalhar com candidatos e score de confiança, ajudando a decidir se a associação deve ser aceita automaticamente.

Posso conectar Make e HubSpot?
Sim. O Make pode funcionar como intermediário entre os sistemas enquanto a integração nativa com HubSpot não está disponível.

Preciso usar Make para integrar com RD Station CRM?
Não. A Econodata já possui integração nativa com o RD Station CRM.

Integração Econodata + n8n

Como funciona a integração com n8n?

O n8n atende principalmente equipes que desejam maior flexibilidade sobre sua arquitetura de automação.

Ele também é relevante para organizações que preferem executar workflows em infraestrutura própria.

Dados da Econodata podem ser utilizados em automações que conectam CRM, banco de dados, ferramentas internas, aplicações próprias e agentes de IA.

O que pode ser consultado pelo n8n?

Dependendo da operação utilizada, a API possui capacidades relacionadas a:

• lookup de empresa;
• match;
• lote de CNPJs;
• segmentação;
• pesquisas;
• contagem;
• pessoas e organograma;
• grupo econômico;
• consulta de saldo.

Passo a passo para configurar Econodata e n8n

1. Instale o node correspondente.

Quando utilizar um Community Node, siga a documentação atual da integração.

2. Gere uma API Key.

Crie uma chave para a API V4.

3. Crie a credencial.

Cadastre a credencial da Econodata no n8n sem expor a chave dentro do workflow.

4. Adicione o node ao workflow.

Escolha a operação necessária.

5. Informe o identificador.

Exemplo: CNPJ para consulta de empresa.

6. Selecione os dados.

Solicite somente os grupos necessários para o processo.

7. Conecte os próximos nodes.

O resultado pode alimentar:

• CRM;
• banco de dados;
• planilha;
• data warehouse;
• ferramenta de comunicação;
• aplicação própria;
• agente de IA.

FAQ: Econodata e n8n

O n8n pode ser self-hosted?
Sim. Essa é uma das características que tornam o n8n especialmente interessante para equipes com requisitos próprios de infraestrutura.

Posso consultar uma empresa por CNPJ?
Sim.

Posso enriquecer vários CNPJs?
A API possui operação em lote para até 100 CNPJs.

Posso consultar decisores?
Sim, utilizando a capacidade correspondente a pessoas e organograma.

O n8n é indicado para usuários sem conhecimento técnico?
Embora tenha uma interface visual, tende a ser melhor aproveitado por equipes que possuem alguma familiaridade com APIs, JSON, autenticação e lógica de automação.

Integração Econodata + RD Station CRM

A Econodata possui uma integração nativa com o RD Station CRM para enriquecer automaticamente as empresas vinculadas às negociações comerciais.

Depois que a conexão é realizada, a integração reage sempre que uma negociação é criada ou editada no RD Station CRM. A Econodata identifica a empresa relacionada à negociação e preenche automaticamente informações empresariais que ainda estejam vazias.

Na prática, isso significa que o vendedor pode criar ou editar uma negociação no RD Station e ter informações empresariais complementadas automaticamente no CRM.

A integração também pode adicionar até 5 decisores da empresa como contatos, vinculados à organização correspondente.

Importante: o fluxo é unidirecional. Os dados seguem da Econodata para o RD Station CRM. A Econodata lê apenas as informações necessárias do CRM para identificar a empresa e executar o enriquecimento.

Como funciona a integração entre Econodata e RD Station CRM?

A integração funciona a partir de eventos relacionados às negociações.

Quando uma negociação é criada ou editada no RD Station CRM, a Econodata consulta a negociação e a empresa vinculada e tenta identificar corretamente aquela organização.

A identificação segue esta ordem:

1. CNPJ: quando o campo já está preenchido, a identificação é exata;
2. domínio do site: utilizado quando o CNPJ ainda não está disponível;
3. nome da empresa: utilizado por semelhança, respeitando um limiar de confiança.

Se a Econodata não conseguir identificar a organização com confiança suficiente, nenhum dado é escrito no CRM.

Essa lógica evita um dos problemas mais sérios em processos de enriquecimento: associar informações de uma empresa ao registro de outra.

Depois que o CNPJ é encontrado e gravado pela primeira vez, os próximos eventos daquela organização passam a utilizar esse identificador mais preciso.

O que dispara o enriquecimento?

O gatilho da integração é a criação ou edição de uma negociação no RD Station CRM.

Isso significa que criar ou editar apenas o cadastro de uma empresa, sem uma negociação vinculada, não dispara o enriquecimento.

A integração também não realiza uma varredura periódica automática de toda a base.

Ela reage aos eventos das negociações conforme eles acontecem.

A Econodata sobrescreve informações do vendedor?

Não.

A lógica da integração é preencher lacunas.

Quando determinado campo já possui uma informação preenchida pelo vendedor, a Econodata não substitui esse conteúdo automaticamente.

Isso preserva informações inseridas pelo próprio time comercial e reduz o risco de uma automação apagar conhecimento acumulado durante a negociação.

Quais dados são enriquecidos no RD Station CRM?

A integração pode escrever dados tanto na empresa quanto nos contatos vinculados.

Dados preenchidos na empresa

Um detalhe importante é que o endereço do RD Station CRM é armazenado em um único campo de texto. Por isso, a integração não distribui rua, número e CEP em propriedades separadas.

Como funciona o enriquecimento de decisores?

A integração pode adicionar até 5 decisores por empresa como contatos dentro do RD Station CRM.

Esses contatos ficam vinculados à empresa relacionada à negociação.

A Econodata não envia CPF, foto ou informações pessoais que não façam parte desse contexto profissional.

Como o plano do RD Station interfere na integração?

O RD Station CRM limita a quantidade de campos personalizados que uma conta pode utilizar, e essa quantidade varia conforme o plano contratado.

Como esse limite não é informado para a Econodata pela API do RD Station, a integração cria os campos em uma ordem de prioridade.

1. CNPJ da empresa;
2. campo consolidado Econodata da empresa;
3. campo consolidado Econodata do contato.

Se não houver espaço suficiente para todos os campos personalizados, a integração prioriza os dados da empresa.

Em contas com poucos campos personalizados disponíveis, o contato ainda pode receber nome, e-mail, vínculo com a empresa e base legal, mas informações adicionais podem não aparecer.

Passo a passo para integrar Econodata e RD Station CRM

1. Acesse o conector na Econodata.

Na plataforma Econodata, acesse Integrações e chaves → Conectores → CRMs.

Localize o card do RD Station CRM e clique em Conectar RD Station CRM.

2. Escolha a conta do RD Station.

Você será direcionado para o ambiente do RD Station.

Selecione a conta que deseja conectar e clique em Continuar.

3. Revise e autorize as permissões.

O RD Station mostrará as permissões solicitadas pela integração.

Elas incluem as autorizações necessárias para trabalhar com elementos como contatos, empresas, negociações e campos personalizados.

Revise a lista e clique em Autorizar e Instalar.

4. Confirme a conexão.

Depois da autorização, você retorna à plataforma Econodata.

O card do RD Station CRM deve aparecer com o status Conectado.

Atenção: quem conclui a conexão precisa estar logado na mesma conta que iniciou o processo. O fluxo não deve ser iniciado por uma pessoa e concluído por outra a partir de um link compartilhado.

Essa é uma medida de segurança para impedir que uma conta de CRM seja conectada indevidamente a outra conta da Econodata.

Quais são os pré-requisitos?

Para utilizar a integração nativa, é necessário:

• ter uma chave de API ativa na área Integrações e chaves da Econodata;
• ter uma conta no RD Station CRM com permissão para instalar e autorizar aplicativos;
• ter saldo de tokens disponível na conta Econodata.

O enriquecimento utiliza os tokens da conta Econodata conforme as regras de consumo da API.

Como funciona o consumo de tokens?

O enriquecimento realizado pela integração nativa consome tokens da conta Econodata.

O consumo segue a lógica da API e está associado à chamada e aos dados efetivamente entregues.

Se a conta ficar sem saldo, a integração interrompe o processamento.

Depois que o saldo é restabelecido, o processamento pode voltar a funcionar normalmente.

Para entender os detalhes técnicos do consumo, consulte a documentação oficial da API V4.

Limites e pontos de atenção

• A integração reage apenas à criação ou edição de negociações.
• Criar ou alterar apenas uma empresa não dispara o enriquecimento.
• São adicionados até 5 decisores por empresa.
• A conexão pode expirar após 14 dias consecutivos sem receber eventos do RD Station.
• Quando isso acontece, é necessário reconectar o RD Station CRM na Econodata.
• O endereço é gravado em um único campo de texto.
• Informações adicionais dos contatos dependem da disponibilidade de campos personalizados no plano do RD Station.
• A Econodata não sobrescreve nome ou endereço já preenchidos pelo vendedor.
• A integração não preenche o campo Site.
• A integração não utiliza o campo Observações.
• CPF, foto e sócios não são enviados pela integração.

Como funciona a segurança da integração?

A credencial de acesso concedida pelo RD Station é armazenada de forma cifrada enquanto a conexão estiver ativa.

Se a integração for revogada, essa credencial é apagada.

A Econodata não recebe a senha do usuário do RD Station.

Os dados pessoais enviados ao CRM são informações relacionadas ao contexto profissional, como nome, cargo e e-mail profissional.

Outro comportamento importante diz respeito à exclusão de contatos: se o cliente remover manualmente um contato criado pela integração, esse contato não é recriado automaticamente.

FAQ: integração Econodata e RD Station CRM

A Econodata possui integração nativa com o RD Station CRM?
Sim. A integração pode ser conectada diretamente pela área de Integrações e chaves da Econodata.

O que dispara o enriquecimento?
A criação ou edição de uma negociação no RD Station CRM. Alterações feitas apenas no cadastro da empresa não disparam o processo.

Quais dados da empresa são enriquecidos?
A integração pode preencher informações como CNPJ, razão social, faturamento estimado, número de funcionários, CNAE principal, porte, situação cadastral, endereço e telefones.

A Econodata sobrescreve informações preenchidas pelo vendedor?
Não. A integração foi desenhada para preencher campos vazios e preservar informações já registradas pelo usuário.

A integração adiciona decisores?
Sim. Podem ser adicionados até 5 decisores por empresa como contatos vinculados à organização.

Por que cargo, nível de decisão, área ou LinkedIn podem não aparecer?
Essas informações dependem da disponibilidade de campos personalizados no plano do RD Station CRM. Quando não existe espaço suficiente, a integração prioriza os campos da empresa.

Por que uma empresa pode não ser enriquecida?
A negociação pode não ter uma empresa vinculada de forma reconhecível ou a Econodata pode não ter atingido confiança suficiente para identificar a organização. Preencher o CNPJ ajuda a tornar as próximas identificações mais precisas.

Integração Econodata + HubSpot: integração nativa em breve

Para quem pesquisa por HubSpot CNPJ, como preencher CNPJ no HubSpot, enriquecimento HubSpot ou integração Econodata HubSpot, existe um ponto importante de transparência.

A integração nativa Econodata + HubSpot será anunciada em breve.

Como enriquecer empresas do HubSpot usando CNPJ?

É possível estruturar um fluxo como:

Company criada no HubSpot → Make, Zapier ou middleware → Econodata → Company atualizada

Esse caminho permite enriquecer empresas sem depender do futuro conector nativo.

Como trabalhar com CNPJ no HubSpot?

O primeiro passo é utilizar uma propriedade padronizada no objeto Company.

Exemplo:

cnpj

Quando o CNPJ estiver disponível, ele poderá ser utilizado diretamente na consulta.

Quando não estiver, o fluxo pode executar um match.

Depois de identificar corretamente a empresa, grave o CNPJ correspondente no CRM para tornar consultas futuras mais determinísticas.

Quais dados podem ser enriquecidos no HubSpot?

Passo a passo para enriquecer o HubSpot

1. Crie ou padronize a propriedade de CNPJ.

Utilize o objeto Company.

2. Escolha Make, Zapier ou middleware próprio.

3. Defina o gatilho.

Exemplo: Company criada.

4. Verifique se existe CNPJ.

Se existir, utilize a consulta direta.

Se não existir, aplique match.

5. Crie uma regra para score de confiança.

Não atualize automaticamente o registro a partir de um candidato ambíguo.

6. Atualize a Company.

Mapeie os atributos necessários.

7. Use os novos dados nos workflows comerciais.

Depois do enriquecimento, informações como porte, faturamento e CNAE podem ser usadas em processos de:

• lead scoring;
• roteamento;
• atribuição de proprietário;
• workflows;
• segmentação;
• priorização comercial.

Para entender o papel do CRM dentro da operação comercial, consulte também o artigo CRM: o que é, para que serve e como funciona.

FAQ: HubSpot e CNPJ

A integração nativa Econodata + HubSpot já está disponível?
Será anunciada em breve.

É possível enriquecer empresas do HubSpot antes disso?
Sim. Make, Zapier ou uma integração direta pela API REST podem funcionar como camada intermediária.

Onde armazenar o CNPJ no HubSpot?
Em uma propriedade padronizada do objeto Company.

E se eu não tiver CNPJ?
Utilize um processo de match, avalie o score de confiança e grave o identificador correto após a associação.

Dá para pesquisar usando site ou e-mail?
Sim. A API possui recursos para identificação por diferentes informações empresariais, conforme a operação utilizada.

Posso fazer lead scoring com esses dados?
Sim. Porte, faturamento, CNAE, funcionários e outros atributos podem alimentar regras de qualificação e workflows.

Por que não enviar todos os campos disponíveis?
Porque mais propriedades não significam necessariamente um CRM melhor. O ideal é enriquecer os dados utilizados em decisões reais.

Integração direta pela API REST Econodata

Para equipes de desenvolvimento, RevOps, Data ou TI, a integração direta oferece o maior nível de controle.

Ela é especialmente indicada quando os dados precisam fazer parte da própria infraestrutura tecnológica da organização.

Isso pode envolver:

• CRM proprietário;
• ERP;
• data warehouse;
• plataforma SaaS;
• motor de lead scoring;
• aplicação interna;
• agentes de IA.

Como funciona a autenticação?

A chave da API deve ser criada na área correspondente dentro da plataforma Econodata e enviada pelo mecanismo de autenticação previsto na documentação técnica.

Nunca exponha uma credencial:

• no frontend;
• em JavaScript público;
• em repositório aberto;
• em documentação pública;
• em materiais compartilhados externamente.

Armazene a chave em um sistema apropriado de variáveis de ambiente ou gestão de secrets.

Consulta individual

Quando você já conhece a empresa, utilize a operação adequada para localizar e enriquecer o registro.

Um dos pontos centrais dessa arquitetura é selecionar somente os grupos e campos necessários.

Isso evita transportar dezenas de atributos que não serão utilizados pela aplicação.

Consulta em lote

Quando já existe uma base de empresas, utilize a operação de lote quando ela atender ao caso de uso.

O limite documentado é de até 100 CNPJs por lote.

Para uma base com milhares de registros, isso permite criar lotes sucessivos em vez de executar uma chamada isolada para cada empresa.

Match

Se o sistema não possui CNPJ, utilize a capacidade de match em vez de implementar uma busca aproximada improvisada.

O resultado pode ser utilizado em uma política como:

score alto
→ aceitar automaticamente

score intermediário
→ revisar

score baixo
→ não preencher

O limiar adequado deve ser definido de acordo com o risco tolerado pela operação.

Segmentação pela API

Quando o objetivo é prospectar empresas novas, a integração pode trabalhar com critérios de segmentação em vez de consultar apenas empresas já existentes no sistema.

Filtros disponíveis podem envolver atributos como:

• UF;
• CNAE;
• porte;
• faturamento;
• funcionários;
• outros critérios disponibilizados pela solução.

Pessoas e organograma pela API

Quando o objetivo é descobrir quem trabalha ou decide em determinada organização, utilize a capacidade específica de pessoas.

Não misture essa consulta com o enriquecimento cadastral da empresa.

Esse cuidado melhora o modelo de dados e facilita trabalhar separadamente com contas e contatos.

Rate limit

O limite padrão documentado é de 60 requisições por minuto por chave, com tolerância para rajadas de até 120 requisições por minuto.

Ao ultrapassar o limite previsto, uma integração deve estar preparada para tratar respostas de limitação de requisição.

Por isso, uma implementação de produção deve considerar:

• retry;
• backoff;
• controle de concorrência;
• fila de processamento;
• uso de lote quando adequado.

Como funciona o consumo?

A API utiliza um modelo de consumo relacionado às informações solicitadas e entregues.

Isso reforça uma boa prática: pedir somente aquilo que a aplicação utilizará.

Quando uma informação não está disponível, um campo vazio não deve ser tratado da mesma forma que um dado efetivamente entregue.

Para regras atualizadas de consumo, deduplicação, endpoints e contratos, consulte sempre a documentação oficial da API V4 Econodata.

Passo a passo para integrar diretamente com a API

1. Gere a chave.

Crie a credencial na área de integrações.

2. Escolha o caso de uso.

Pergunte primeiro se o objetivo é:

• enriquecer empresa conhecida;
• identificar empresa sem CNPJ;
• processar uma base em lote;
• segmentar novas empresas;
• consultar pessoas e decisores.

3. Determine o identificador.

Quando disponível, priorize identificadores mais determinísticos, como CNPJ.

4. Selecione os dados.

Não solicite informação que não será utilizada.

5. Teste com poucos registros.

Valide estrutura, retorno e mapeamento antes de aumentar o volume.

6. Implemente tratamento de erros.

Considere pelo menos:

• autenticação;
• validação de entrada;
• rate limit;
• timeout;
• indisponibilidade;
• resposta vazia;
• retry.

7. Implemente observabilidade.

Registre informações como:

• operação executada;
• duração;
• resultado;
• erros;
• quantidade processada;
• tentativas.

FAQ: API REST Econodata

A API só funciona se eu tiver CNPJ?
Não. Existem capacidades de identificação e match para outros cenários.

Quais informações podem ajudar a encontrar uma empresa?
Dependendo da operação, a identificação pode considerar CNPJ, raiz, site, e-mail e informações utilizadas no processo de match.

Quantos CNPJs posso enriquecer em lote?
Até 100 CNPJs por operação de lote, conforme a documentação atual.

Qual é o limite de requisições?
O limite padrão documentado é de 60 requisições por minuto por chave, com tolerância de rajada de até 120.

Posso consultar pessoas e decisores?
Sim. Pessoas e organograma devem ser tratados por meio da capacidade específica correspondente.

Onde encontro os detalhes técnicos?
Na documentação oficial da API V4 Econodata.

Existe um conteúdo comparando diferentes APIs de CNPJ?
Sim. Consulte o artigo API de consulta de CNPJ: opções e comparativo.

Boas práticas para enriquecer o CRM

1. Use CNPJ como chave quando ele existir

Razão social pode mudar. Nome fantasia pode mudar. Domínio também pode mudar.

O CNPJ oferece uma referência mais determinística para identificar juridicamente a empresa.

2. Não confunda match com lookup

Lookup significa:

“sei qual empresa quero consultar”.

Match significa:

“tenho algumas evidências e quero identificar qual empresa provavelmente corresponde a este registro”.

Essa diferença é fundamental para evitar que o CRM seja enriquecido com dados de outra organização.

3. Defina uma política para score de confiança

Não aceite qualquer candidato automaticamente.

Os valores utilizados como corte devem ser calibrados com dados reais da própria operação.

4. Enriqueça somente campos acionáveis

Para cada campo, faça a seguinte pergunta:

“O que nosso processo fará diferente se essa informação mudar?”

Se ninguém consegue responder, talvez aquele dado não precise estar no CRM.

5. Separe empresa de pessoa

Uma empresa possui características como faturamento, CNAE, porte e número de funcionários.

Uma pessoa possui nome, cargo, função, departamento e posição dentro da estrutura organizacional.

Misturar essas entidades prejudica integrações e modelos de dados.

6. Planeje o rate limit desde o início

Não espere receber erros em produção para descobrir que sua integração precisava de fila, backoff e controle de concorrência.

7. Use lote para bases maiores

Se milhares de CNPJs precisam ser enriquecidos, avalie primeiro a operação de lote em vez de criar milhares de chamadas isoladas.

8. Faça reenriquecimento

CRM não deve ser tratado como uma fotografia eterna.

Empresas mudam de porte, endereço, situação cadastral, número de funcionários, contatos e estrutura organizacional.

Crie uma política de atualização baseada na importância e na volatilidade de cada dado.

Qual integração da Econodata escolher?

A melhor solução não é necessariamente a mais sofisticada.

É aquela que resolve o processo comercial com o menor número possível de dependências desnecessárias.

Se um conector plug and play resolve, use o conector.

Se existe uma integração nativa, como no caso do RD Station CRM, ela tende a ser o caminho mais simples para o caso de uso suportado.

Se o fluxo exige várias regras, uma ferramenta de automação pode ser mais adequada.

Se os dados passam a fazer parte do próprio produto ou da infraestrutura da organização, a API REST da Econodata oferece maior controle.

Perguntas frequentes sobre integrações da Econodata

Posso integrar a Econodata ao meu CRM?

Sim. Dependendo do CRM e do nível de personalização necessário, isso pode ser feito por integração nativa, conectores plug and play, ferramentas de automação ou API REST.

Preciso ter CNPJ?

Não necessariamente. A API também possui mecanismos de match para situações em que o CNPJ não está disponível.

Posso pesquisar uma empresa usando site ou e-mail?

Sim. A API possui operações que permitem trabalhar com diferentes identificadores e informações empresariais.

Posso enriquecer vários CNPJs de uma vez?

Sim. A API V4 possui operação de lookup em lote de até 100 CNPJs.

A API Econodata permite consultar decisores?

Sim. Pessoas e organograma são tratados por uma capacidade própria, separada do enriquecimento cadastral da empresa.

Qual é o rate limit da API Econodata?

O limite padrão documentado é de 60 requisições por minuto por chave, com tolerância para rajadas de até 120 requisições por minuto.

Existe score para o match?

O processo de match pode trabalhar com candidatos e grau de confiança, permitindo que a operação determine quando aceitar automaticamente ou revisar uma correspondência.

A integração com RD Station CRM já está disponível?

Sim. A Econodata possui integração nativa com o RD Station CRM. Negociações criadas ou editadas podem disparar automaticamente o enriquecimento da empresa e a inclusão de até 5 decisores como contatos.

A integração com HubSpot já está disponível?

A integração nativa deve ser comunicada neste conteúdo como em breve. Enquanto isso, é possível trabalhar com Make, Zapier ou API REST como camada intermediária.

Onde encontro a documentação da API Econodata?

A página /api apresenta a solução e seus casos de uso. Para endpoints, parâmetros, contratos e detalhes técnicos, consulte a documentação oficial da API V4 Econodata.