Como usar a API Econodata no Make

Aprenda a conectar a base de dados da Econodata aos seus cenários no Make utilizando a API v3. Este guia cobre desde a autenticação até os principais endpoints de consulta e gestão de webhooks.

1. Configurações Iniciais

Informações de Base

• Base URL: https://api.econodata.com.br/ecdt-api
• Autenticação: Realizada via Headers HTTP.
• Onde obter o token: Acesse a plataforma Econodata, vá em Integrações e gere seu x-api-token.

Como configurar no Make

1. No seu cenário, adicione o módulo HTTP > Make a request.
2. No campo Headers, adicione:

• • Item 1: * Key: x-api-token
  • Value: SEU_TOKEN_DE_INTEGRACAO

3. No campo Body type, selecione body Content type JSON.

2. Endpoints de Consulta de Empresas

Consultar Lista de CNPJs

Utilize para buscar dados de múltiplas empresas simultaneamente.

• Método: POST
• URL: /v3/companies
• Body (JSON):

["17.948.237/0001-00", "00.000.000/0001-91"]

Busca por Parâmetros (Query String)

Ideal para buscas simples via URL.

• Método: GET
• URL: /v3/companies/search
• Parâmetros suportados: site, email, cnpj.

Busca Estruturada (Payload)

Para buscas via corpo da requisição.

• Método: POST
• URL: /v3/companies/search
• Body (JSON): {"cnpj": "00.000.000/0000-00"} ou {"site": "exemplo.com.br"}

3. Gestão de Webhooks e Tags

💡 Exemplo de Update de Tags:No módulo HTTP do Make, envie para o endpoint /v3/update-lead:JSON```
{
"empresas": [{"cnpj": "00.000.000/0000-00"}],
"tags": ["Lead Qualificado", "SDR-01"]
}

```

4. Tratamento de Erros e Resiliência

A API retorna erros no formato JSON padrão. Certifique-se de tratar os seguintes códigos no Make:

• 400: Requisição inválida (verifique o JSON enviado).
• 401: Token inválido ou expirado.
• 404: Recurso ou empresa não encontrada.
• 429: Rate Limit (limite de requisições atingido).

💡 Insight para o Make:

Para o erro 429, configure uma diretiva de Retry no módulo HTTP com um delay. Isso evita que o seu cenário pare de rodar caso você atinja o limite temporário de requisições da API.

📋 Resumo de Endpoints

Documentação API Econodata v3 — Uso no Make. Base URL: https://app.swaggerhub.com/apis-docs/econodata-ab7/econodata-api/3.0.0#/Empresas/getCompanyByParametersQueryV3

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

Actualizado em: 25/03/2026