Como conectar a Econodata ao Make via API V4

Guia de uso do app Econodata no Make. Permite montar integrações no formato:
[Gatilho no seu CRM] → [Econodata enriquece] → [Atualiza no CRM/planilha/e-mail], sem necessidade de programação.
O código do conector está disponível no repositório ecdt-ipaas-connectors (packages/make) e o contrato da integração pode ser consultado em openapi.yaml.
Atualmente, o aplicativo está publicado, porém com visibilidade por link de convite, ainda não listado no catálogo público do Make. Usuários da organização da Econodata conseguem localizar os módulos pesquisando por Econodata em um cenário. Para usuários externos, é necessário solicitar o link de instalação ao time responsável.

Pré-requisitos

Antes de iniciar a configuração, é necessário possuir:

• Uma conta no Make (qualquer plano, pois o aplicativo utiliza uma operação por chamada);
• Uma API Key da Econodata no formato ek_live_..., com escopo de leitura (preset "Integração (somente leitura)", disponível no painel Integrações & API v4);

Como gerar sua chave de API

Antes de conectar a Econodata a qualquer integração, você precisa gerar uma chave de API dentro da plataforma.

1. Acesse Chaves e Integrações

Clique no seu perfil, no canto superior direito da plataforma, e selecione "Chaves e integração". Você será direcionado à tela Integrações & API (API V4).

2. Crie a chave

Na aba Chaves API, clique em "+ Criar nova chave". Nessa tela você pode:

• Dar um nome à chave (recomendamos algo identificável, como "Make - Prospecção", para facilitar o controle de quem usa o quê);
• Selecionar "Gerar chave";
• Copiar a chave gerada no formato ek_live_… (ela só é exibida uma vez, então salve-a em local seguro).

Nessa mesma tela você acompanha, em tempo real:

• Saldo de créditos disponível na conta;
• Chaves ativas (e quantas foram revogadas);
• Integrações vinculadas às suas chaves.

3. Vincule a chave a um conector

Na aba Conectores, você encontra cards para Zapier, Make, n8n, além de API personalizada e MCP · Agentes de IA (em breve). Clique em "Vincular" no conector desejado para associar uma chave já existente a essa integração — assim você mantém visibilidade de quantas chaves ativas cada ferramenta está usando.

1. Conectando a conta da Econodata

Adicione qualquer módulo da Econodata a um cenário e clique em Create a connection.
Preencha os campos conforme abaixo:

A autenticação é realizada enviando a chave no cabeçalho:
Authorization: Bearer {API_KEY}
Durante o teste da conexão será realizada uma consulta de saldo. Caso a chave seja válida, a conexão será salva automaticamente. Caso contrário, a conexão será recusada imediatamente.

Segue o passo a passo de como criar um cenário e conectar à Econodata:

1. Clique em "Create scenario"

2. Busque a integração com a Econodata

3. Insira a chave de integração criada em "Chaves e integrações"
4. Selecione o endpoint que deseja consumir e está pronto para usar

2. Módulos disponíveis

Após conectar sua conta, estarão disponíveis os seguintes módulos:

Observação

Os módulos baseados em pesquisas salvas apresentam automaticamente um dropdown dinâmico, contendo todas as pesquisas compartilhadas disponíveis na conta. Basta selecionar a pesquisa desejada.

3. Configurando o enriquecimento de dados

Durante a utilização dos módulos de enriquecimento, é possível definir quais informações serão retornadas.

Buckets disponíveis

Cada bucket entregue consome tokens.
Os buckets disponíveis são:

• cadastro (RFB);
• estrategico (porte, faturamento e tecnologias);
• perfilNegocio (setor, matriz e filiais, dívidas);
• contatosBasicos (telefones e e-mails);
• contatosAvancados (contatos verificados, decisores e redes sociais).

Também é possível solicitar apenas campos específicos utilizando dot-path, por exemplo:

• cadastro.razaoSocial;
• contatosBasicos.telefones.

Os campos podem ser informados um por linha ou separados por vírgula.
Além disso, existe a configuração Máximo de itens por lista, utilizada para definir o número máximo de itens retornados dentro de cada empresa, como telefones e sócios.
Quando informado 0, todos os itens disponíveis serão retornados.

Importante:

• Caso nenhum bucket seja selecionado, o lookup retornará apenas o CNPJ, sendo esta a opção de menor custo em tokens.
• O bucket contatosAvancados não está disponível nos módulos de Segmentação. Para consultar decisores, utilize o módulo Buscar decisores.

4. Exemplo de integração

Pipedrive → Econodata → Pipedrive

Um fluxo bastante comum consiste em enriquecer dados de empresas no Pipedrive utilizando a Econodata.
O processo funciona da seguinte forma:

1. Configure o gatilho Watch Deals ou Watch Organizations no Pipedrive;
2. Adicione o módulo Encontrar empresa da Econodata;
3. Informe o CNPJ ou o domínio do e-mail do contato;
4. Selecione os buckets desejados, como por exemplo:
5. • cadastro;
   • contatosBasicos;
5. Adicione o módulo Update Deal ou Update Organization do Pipedrive;
6. Faça o mapeamento dos campos retornados pela Econodata (como Razão Social, Faturamento, Telefones, entre outros) para os campos correspondentes no Pipedrive.

Esse mesmo padrão pode ser utilizado com outras ferramentas como:

• HubSpot;
• RD Station;
• Ploomes;
• Google Sheets;
• E-mail;
• entre outras integrações suportadas pelo Make.

Onde normalmente está o CNPJ em cada CRM

5. Paginação e limites

Os módulos de listagem do Make realizam a paginação automaticamente, sem necessidade de controlar cursor ou número de página.
Dois parâmetros controlam o volume de resultados retornados:

• Até 50 requisições de paginação;
• Até 3.200 registros retornados.

6. Consumo de tokens

O consumo ocorre com base no endpoint utilizado e na quantidade de informações retornadas por empresa.
Na prática:

• Lookups sem buckets possuem baixo consumo;
• Cada bucket adicional entregue aumenta o consumo de tokens;
• Os módulos de segmentação consomem tokens a cada página retornada;
• Para apenas estimar o tamanho de um segmento, recomenda-se utilizar Contar segmento, que consome apenas o custo base do endpoint, sem cobrança por campos, e não recobra a mesma contagem dentro de um período de 24 horas;
• As ações Ver saldo e Listar pesquisas salvas não consomem tokens;
• Consultas repetidas para a mesma empresa dentro de um período de 24 horas não geram nova cobrança dos dados já cobrados;
• O consumo disponível pode ser acompanhado utilizando o módulo Ver saldo.

7. Possíveis erros

Durante a utilização da integração, o aplicativo traduz automaticamente os erros retornados pela API, facilitando sua identificação.
Os retornos mais comuns são:

Erros comuns

Algumas situações podem gerar dúvidas durante a configuração:

• Cannot GET / Cannot POST (404): normalmente indica que a Base URL foi configurada utilizando o endereço da plataforma em vez do endereço da API.
• Empresa não encontrada no lote: o CNPJ continua sendo retornado, porém com o campo Motivo preenchido (por exemplo: not_found). Basta filtrar os resultados onde o campo Motivo estiver vazio para visualizar apenas as empresas encontradas.
• Resultado vazio em Segmentar: geralmente indica que os filtros utilizados estão muito restritivos. Recomenda-se validar primeiro utilizando o módulo Contar segmento por filtros.

Referências

Caso deseje consultar a documentação técnica da integração, utilize os seguintes materiais:

• contratos-novos-endpoints-v4.md — Catálogo de campos por bucket;
• autenticacao-api-key.md — Documentação de autenticação por API Key;
• Repositório ecdt-ipaas-connectors (packages/make) — Código-fonte do conector;
• docs/como-conectar-crm.md — Guia completo da integração com detalhamento do mapeamento de campos (também utilizado como README da página do aplicativo no Make).

Se você quer aperfeiçoar o uso da Econodata, entre em contato com o suporte no email "suporte@econodata.com.br".

Actualizado em: 06/08/2026