Make - Enriquecer planilha a partir de lista de sites de empresas

Integração Econodata + Make

Tutorial Make: Enriquecer planilha a partir de uma lista de sites


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 que enriquece uma planilha do Google Sheets com dados de empresas a partir de uma lista de sites — usando a API 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.
  • Token usado no exemplo: a1db01e5-82e4-fa27-be2f-59d9b25ee313
  • Substitua pelo seu próprio token quando for criar.
  1. 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).
  • 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


Lê uma planilha do Google Sheets que contém uma lista de sites de empresas. Para cada site, consulta a API Econodata e preenche, na mesma linha, dados como CNPJ, razão social, nome fantasia, UF e cidade.


Estrutura da planilha do Google Sheets


Crie uma planilha com o nome ecdt-crm (ou outro nome de sua preferência) com uma aba (sheet) chamada leads-sites.


A primeira linha (cabeçalho) deve conter exatamente estas colunas, nesta ordem:


A

B

C

D

E

F

G

site

cnpj

razaoSocial

nomeFantasia

tipoUnidade

uf

cidade


A coluna A (site) deve ser preenchida por você com os sites que deseja enriquecer (um por linha). As demais colunas serão preenchidas automaticamente pelo Make.


Visão geral do fluxo


[Google Sheets: Search Rows] → [Set Variable: x-api-token] → [Iterator] → [HTTP Request] → [Google Sheets: Update a Row]


São 5 módulos no total.




Passo 1 — Adicionar o módulo "Google Sheets: Search Rows"


Este módulo lê as linhas da sua planilha.


  1. Clique no grande círculo central da tela do cenário.
  2. Na barra de busca que aparecer, digite Google Sheets e selecione o app.
  3. Na lista de ações, escolha Search Rows.
  4. Clique em Create a connection (Criar conexão) e siga os passos para autorizar sua conta Google. Dê um nome para a conexão (ex.: "Minha conta Google").
  5. Preencha os campos do módulo conforme a tabela abaixo:


Campo

Valor

Search Method (Método de busca)

Select from the list

Drive

My Drive

Spreadsheet

Selecione ecdt-crm

Sheet Name

leads-sites

Table contains headers (Tabela com cabeçalhos)

Yes

Column range (Intervalo de colunas)

A-Z

Filter — Coluna

A (site)

Filter — Condição

Exists (existe)

Order by

(deixe vazio)

Sort order

Ascending

Value render option

Formatted value

Date and time render option

Formatted string

Maximum number of returned rows

(em branco para retornar todas)


  1. Clique em OK para salvar.


Dica: o filtro "site existe" garante que só linhas com algum site preenchido serão processadas.




Passo 2 — Adicionar o módulo "Set Variable" (guardar o 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 + (sinal de mais) ao lado do módulo do Google Sheets.
  2. Procure por Tools e selecione.
  3. Escolha a ação Set Variable.
  4. Preencha:


Campo

Valor

Variable name (Nome da variável)

x-api-token

Variable lifetime

One cycle

Variable value

a1db01e5-82e4-fa27-be2f-59d9b25ee313 (use o seu token)


  1. Clique em OK.




Passo 3 — Adicionar o módulo "Iterator" (percorrer os sites)


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


  1. Clique no + após o módulo Set Variable.
  2. Procure por Flow Control e selecione Iterator.
  3. No campo Array, clique para abrir o painel de mapeamento.
  4. Selecione, do módulo 1 (Google Sheets), o campo identificado como 0 ou site (A).


Observação: este Iterator está percorrendo apenas a coluna A (sites). Cada iteração corresponde a um site.


  1. Clique em OK.




Passo 4 — Adicionar o módulo "HTTP: Make a request" (chamar a API Econodata)


Este módulo faz a chamada para a API Econodata enviando o site e recebendo os dados da empresa.


  1. Clique no + após o Iterator.
  2. Procure por HTTP e selecione.
  3. Escolha Make a request.
  4. Preencha:


Campo

Valor

URL

https://api.econodata.com.br/ecdt-api/v3/companies/search

Method

POST

Headers — Add item

(veja abaixo)

Body type

Raw

Content type

JSON (application/json)

Request content

(veja abaixo)

Parse response

Yes


  1. Headers: clique em Add item e preencha:
  • Name: x-api-token
  • Value: mapeie a variável x-api-token do módulo Set Variable (módulo 2 do passo anterior).


  1. Request content (corpo da requisição em JSON):


{
  "site": "VALOR_DO_ITERATOR"
}


No campo do corpo, em vez de digitar VALOR_DO_ITERATOR, mapeie o campo value do módulo Iterator. O Make vai inserir uma referência azul automaticamente.


  1. Clique em OK.


Tratamento de erro (Ignorar erros do tipo DataError)


Algumas vezes a API pode retornar erro (ex.: site não encontrado). Para que o cenário não pare:


  1. Clique com o botão direito no módulo HTTP que você acabou de criar.
  2. Selecione Add error handler.
  3. Escolha Ignore.
  4. No módulo "Ignore" criado, clique no ícone de filtro (chave) na linha que conecta os módulos.
  5. Configure o filtro:
  • Label: Catch DataError
  • Condição: error.type (do módulo HTTP) Text operators: Equal to DataError
  1. Clique em OK.




Passo 5 — Adicionar o módulo "Google Sheets: Update a Row"


Este módulo escreve os dados retornados pela API de volta na mesma linha da planilha.


  1. Clique no + após o módulo HTTP (no fluxo principal, não no de erro).
  2. Procure por Google Sheets e selecione Update a Row.
  3. Use a mesma conexão Google criada no Passo 1.
  4. Preencha:


Campo

Valor

Search Method

Select from the list

Drive

My Drive

Spreadsheet

Selecione ecdt-crm

Sheet Name

leads-sites

Row number

Mapeie __ROW_NUMBER__ (Row number) do módulo 1 do Google Sheets

Table contains headers

Yes

Use column headers as IDs

Yes

Value input option

User entered


  1. Values in columns — preencha cada coluna mapeando os dados retornados pela API (módulo HTTP, normalmente identificado como 3.):


Coluna

Valor a mapear

site

(deixe vazio — esta coluna já tem o site)

cnpj

data.cnpj

razaoSocial

data.razaoSocial

nomeFantasia

data.nomeFantasia

tipoUnidade

data.tipoUnidade

uf

data.uf

cidade

data.cidade


  1. Clique em OK.




Passo 6 — Salvar e testar


  1. Dê um nome ao cenário no canto superior esquerdo: Econodata API - Enriquecer planilha a partir de lista de sites.
  2. Clique no botão Save (disquete) na barra inferior.
  3. Para testar, clique em Run once (executar uma vez) na barra inferior.
  4. Acompanhe a execução: cada módulo mostra a quantidade de itens processados.
  5. Confira sua planilha — as colunas B até G devem ter sido preenchidas para cada site.




Solução de problemas comuns


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 (sheet) está exato (com hífens, sem espaços extras).
  • Atualize a lista clicando no ícone de refresh ao lado do campo.


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 a coluna A (site) do Google Sheets.




Referências úteis





Dica final: sempre teste com um pequeno volume de dados primeiro (1 a 3 linhas). 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

Esse artigo foi útil?

Partilhe o seu feedback

Cancelar

Obrigado!