Integração Econodata + Make

Tutorial Make: Enriquecimento de planilha + Tags (via Webhook)

Este guia foi feito para pessoas sem conhecimento técnico. Ele ensina, passo a passo, como construir manualmente, na plataforma de automação Make (antiga Integromat), um cenário acionado por Webhook que enriquece uma planilha do Google Sheets com dados de empresas e aplica uma tag na plataforma Econodata.

Download dos arquivos (Workflow + Planilha)

O workflow descrito pode ser baixado através deste link e importado no n8n.
A planilha Google Sheets pode ser baixada através deste link e importada no seu Google Drive.

Antes de começar

O que você vai precisar

1. Conta no Make — acesse https://www.make.com e crie uma conta gratuita.
2. Conta Google — para conectar o Google Sheets (planilhas).
3. Token da API Econodata — este é o seu "crachá" de acesso à API.
4. Planilha no Google Sheets — criada e organizada conforme descrito abaixo.

Conceitos básicos

• Cenário (Scenario): o nome que o Make dá para um workflow (fluxo automatizado).
• Módulo: cada "caixinha" do cenário. Representa uma ação (ex.: ler planilha, chamar API).
• Webhook: um endereço de internet (URL) que aceita receber dados de fora e dispara o cenário.
• Conexão: vínculo entre o Make e um serviço externo (ex.: sua conta Google).
• Mapeamento: quando você puxa um dado de um módulo anterior para usar em outro. Ao clicar em um campo, o Make abre um painel mostrando todos os dados disponíveis dos módulos anteriores.

Como criar um novo cenário

1. Faça login no Make.
2. No menu lateral esquerdo, clique em Scenarios.
3. Clique no botão + Create a new scenario (canto superior direito).
4. Você verá uma tela em branco com um grande círculo no centro. Clique nele para adicionar o primeiro módulo.

O que este cenário faz

Recebe, por meio de um Webhook (endereço de internet), uma lista de CNPJs. Consulta cada empresa na API Econodata, e em seguida faz duas coisas em paralelo:

1. Adiciona uma nova linha na planilha leads-exportados com os dados da empresa.
2. Aplica a tag econodata-make-api na empresa, dentro da plataforma Econodata.

Estrutura da planilha do Google Sheets

Crie (ou use a planilha existente) ecdt-crm-make e adicione uma aba chamada leads-exportados com este cabeçalho na primeira linha:

Visão geral do fluxo

[Webhook] → [Set Variable: x-api-token] → [HTTP Request: /companies] → [Iterator]
                                                                            ↓
                                                                       [Router]
                                                                        ↙     ↘
                                            [Google Sheets: Add a Row]   [HTTP Request: /update-lead]

São 6 módulos principais (mais o Router, que cria duas ramificações).

Passo 1 — Adicionar o módulo "Webhooks: Custom Webhook"

Este módulo cria um endereço (URL) que aceita receber dados de fora.

1. Crie um novo cenário no Make.
2. Clique no círculo central.
3. Procure por Webhooks e selecione Custom Webhook.
4. Clique em Add para criar um novo webhook:

• Webhook name: ecdt-api/webhook
• IP restrictions: deixe em branco.

5. Clique em Save.
6. O Make vai gerar uma URL única (algo como https://hook.us1.make.com/abc123...). Copie e guarde essa URL — você vai usá-la para enviar dados ao cenário.
7. Clique em OK.

Para testar mais tarde, você poderá enviar dados a esta URL usando um botão ou um sistema externo (como a plataforma Econodata). O corpo (body) enviado deve ser um JSON contendo a lista de empresas no formato esperado pela API /v3/companies.

Passo 2 — Adicionar o módulo "Set Variable" (token da API)

Este módulo guarda seu token de API em uma variável, deixando-o disponível para os próximos passos.

1. Clique no + após o Webhook.
2. Procure por Tools e escolha Set Variable.
3. Preencha:

4. Clique em OK.

Passo 3 — Adicionar o módulo "HTTP: Make a request" (consulta empresas)

Este módulo faz a chamada à API Econodata para buscar os dados completos das empresas.

1. Clique no + após o Set Variable.
2. Procure por HTTP e escolha Make a request.
3. Preencha:

4. Headers: clique em Add item:

• Name: x-api-token
• Value: mapeie x-api-token do módulo Set Variable.

5. Request content: clique no campo e mapeie o valor recebido do Webhook (campo value do módulo 1).

Em outras palavras: o que o webhook receber será encaminhado diretamente como corpo desta requisição.

6. Clique em OK.

Passo 4 — Adicionar o módulo "Iterator" (percorrer empresas)

O Iterator transforma uma lista em itens individuais, processando um por vez.

1. Clique no + após o módulo HTTP.
2. Procure por Flow Control e selecione Iterator.
3. No campo Array, mapeie data.empresas do módulo HTTP anterior (módulo 3).
4. Clique em OK.

Cada iteração agora representa uma empresa retornada pela API.

Passo 5 — Adicionar o módulo "Router" (dividir o fluxo em duas rotas)

O Router permite executar duas (ou mais) ações em paralelo para cada empresa.

1. Clique no + após o Iterator.
2. Procure por Flow Control e selecione Router.
3. O Router cria automaticamente duas saídas em forma de "garfo".

Passo 6 — Rota 1: "Google Sheets: Add a Row" (gravar planilha)

1. Clique no + da primeira saída do Router.
2. Procure por Google Sheets e selecione Add a Row.
3. Use a mesma conexão Google.
4. Preencha:

5. Values in columns — mapeie do módulo Iterator (módulo 4):

6. Clique em OK.

Passo 7 — Rota 2: "HTTP: Make a request" (aplicar tag)

1. Clique no + da segunda saída do Router.
2. Procure por HTTP e selecione Make a request.
3. Preencha:

4. Headers: clique em Add item:

• Name: x-api-token
• Value: mapeie x-api-token do módulo Set Variable (módulo 2).

5. Request content:

{
  "tags": "teste-make-api",
  "empresas": [
    {
      "cnpj": "MAPEAR_CNPJ_DO_ITERATOR",
      "sinalizarGrupoEconomico": false
    }
  ]
}

No lugar de MAPEAR_CNPJ_DO_ITERATOR, mapeie o campo cnpj do módulo Iterator (módulo 4).

6. Clique em OK.

Passo 8 — Configurações finais e teste

1. Dê um nome ao cenário no topo: Econodata API - Enriquecimento de planilha + tags.
2. Clique em Save.
3. Ative o cenário no botão ON/OFF da barra inferior. Como ele é acionado por webhook, fica em modo "escuta".
4. Para testar, envie um POST para a URL do webhook (que você copiou no Passo 1) com um JSON no formato esperado pela API /v3/companies. Você pode usar a plataforma Econodata, ou ferramentas como Postman ou Insomnia, para fazer este envio.
5. Após o disparo, verifique:

• Se uma nova linha foi adicionada à aba leads-exportados.
• Se a tag econodata-make-api foi aplicada na empresa, dentro da plataforma Econodata.

Solução de problemas comuns

O cenário com Webhook não dispara

• Confirme que o cenário está ativado (botão ON na barra inferior).
• Confirme que o método HTTP do envio é POST.
• Confirme que o Content-Type enviado é application/json.

O HTTP retorna erro 401 (Unauthorized)

• O token está incorreto ou expirado. Verifique o valor inserido no módulo Set Variable.
• Confira se o nome do header está exatamente como x-api-token (em minúsculas, com hífen).

O Iterator não retorna nada

• Verifique se o campo Array está mapeado corretamente para data.empresas do módulo HTTP.

O módulo Google Sheets não encontra minha planilha

• Verifique se a conexão Google foi feita com a conta correta.
• Confira se o nome da planilha e da aba está exato (com hífens, sem espaços extras).
• Atualize a lista clicando no ícone de refresh ao lado do campo.

Referências úteis

• Documentação do Make: https://www.make.com/en/help
• API Econodata — consulta em lote: https://api.econodata.com.br/ecdt-api/v3/companies
• API Econodata — atualização de lead (tags): https://api.econodata.com.br/ecdt-api/v3/update-lead

Dica final: sempre teste com um pequeno volume de dados primeiro (1 a 3 empresas). Depois que tudo funcionar, você pode rodar com volumes maiores. O Make cobra por operações (cada execução de módulo é uma operação), então um teste em escala pequena é mais econômico.

Actualizado em: 07/05/2026