Como eu junto dado de várias fontes automaticamente num painel só?

Escrito por

em

Dá para automatizar quase tudo: um script na nuvem chama a API de cada fonte uma vez por dia — rede social, anúncio, sistema de vendas — e grava os números numa planilha. Mas sempre sobra um número que nenhuma API entrega, e o sistema certo assume essa fresta em vez de fingir automação total.

A dor por trás dessa pergunta

Se você abre três abas diferentes toda manhã — uma rede social, o painel de anúncio, talvez uma planilha de vendas — só para copiar três ou quatro números numa quarta aba, você já sentiu o problema na pele. Não é o trabalho de copiar em si que cansa, é o fato de ser todo dia, sempre o mesmo gesto, sempre a mesma chance de errar um dígito ou esquecer de atualizar. E, no fundo, incomoda mais ainda uma coisa que ninguém te disse: até esse trabalho manual pode estar produzindo número errado, e você não teria como saber.

Como funciona, por trás dos panos, uma automação que junta números de fontes diferentes?

O desenho é sempre parecido: um script — pode ser um pedacinho de código rodando numa nuvem gratuita, sem servidor próprio para manter — acorda uma vez por dia, chama a API de cada fonte, pega os números que interessam e escreve numa planilha ou num banco. A planilha vira só a “tela” que mostra o resultado; quem faz o trabalho pesado é o script.

A parte que costuma faltar na cabeça de quem nunca fez isso: API não é um espelho perfeito do que aparece na tela do aplicativo. Cada plataforma decide o que expõe, em que formato e com que atraso. Duas fontes que “deveriam” combinar direto quase sempre exigem um ajuste no meio.

O que uma API realmente entrega, e por que ela é a porta e não a fonte?

API é a porta pela qual um programa conversa com o sistema de outra empresa, sem passar pela tela que uma pessoa usaria. Ela devolve exatamente os campos que o fornecedor decidiu documentar — nem um a mais.

A suposição mais comum é errada: “se o número aparece no aplicativo, ele sai pela API”. Na prática, o aplicativo tem métricas de tela que a API nunca expõe — por decisão de produto, por limite técnico do formato de conteúdo, ou porque aquele dado nunca foi liberado para uso automatizado. Só se descobre testando; a documentação raramente avisa a lacuna antes de você bater nela.

Por que dois números “quase iguais” podem medir coisas diferentes?

Uma conta de anúncio quase sempre roda mais de um tipo de campanha ao mesmo tempo — uma para atrair gente nova, outra para reimpactar quem já demonstrou interesse. A API expõe um campo para o gasto total da conta e outro (ou um filtro) para o gasto de um tipo específico.

São dois números válidos, corretos dentro do que descrevem. Mas se o seu painel precisa de “gasto de aquisição” e o script somou o total da conta, o número final sai inflado — sem nenhum aviso de erro na tela. É o erro mais caro desse tipo de automação, porque ele não avisa que aconteceu.

Que dado nunca dá para automatizar 100%, e por quê?

Nem todo número tem um caminho de API. Alguns motivos reais, documentados pelos próprios fornecedores, para uma métrica não sair automaticamente:

  • Limite por formato de conteúdo: uma métrica pode existir para foto estática e não existir para vídeo curto, porque a plataforma mede o comportamento do público de um jeito diferente em cada formato — e simplesmente não processa aquele cruzamento pro segundo caso.
  • Métrica descontinuada ou nunca liberada: o fornecedor decide, por política própria, o que sai pela API pública — o painel visual do aplicativo pode mostrar mais do que ele libera para automação.
  • Cálculo que só existe visualmente: alguns números são compostos na tela, a partir de outros dados, sem que exista um campo único correspondente na API.

Quando isso acontece, a saída honesta é simples: aquele campo específico fica manual — a pessoa digita um número por dia — e todo o resto segue automático. Um sistema que promete 100% de automação e não entrega vira motivo de desconfiança; um sistema que assume a fresta e documenta o motivo se sustenta.

O que fazer quando a automação bate um limite de chamadas da plataforma?

Toda API de peso limita quantas vezes você pode chamá-la num intervalo de tempo — o chamado limite de taxa (*rate limit*). O padrão documentado é responder com o código 429 (Too Many Requests), às vezes avisando quanto tempo esperar; em exemplos oficiais, uma janela de uma hora aparece com frequência (MDN Web Docs, referência de status HTTP 429).

Na prática, o aviso nem sempre é claro: um limite estourado pode devolver mensagem de “esse dado não existe”, quando é só a plataforma pedindo para você parar por um tempo. A rotina se resolve sozinha — passado o intervalo, a próxima chamada volta a funcionar.

Uma automação que roda uma vez por dia dificilmente esbarra nisso. O risco aparece só em teste em rajada, chamando o mesmo endpoint dezenas de vezes seguidas em poucos minutos.

Planilha automatizada ainda é planilha, ou já virou painel?

A diferença não está na aparência, está em quem faz o trabalho de buscar o dado:

Planilha manualPlanilha automatizadaPainel/sistema próprio
Quem busca o númeroUma pessoa, todo diaUm script, todo diaUm script, todo dia
Onde o número apareceCélula digitadaCélula preenchida por fórmula/scriptTela própria, com histórico e gráfico
Erro de digitaçãoSempre possívelEliminado nos campos automáticosEliminado nos campos automáticos
Erro de cálculo errado (filtro certo x total)Só se a pessoa errar a contaAcontece sem aviso, se o filtro da API estiver erradoO mesmo risco — o filtro tem que estar certo desde a primeira versão
Campo que a API não entregaPreenchido manualmente, como o restoPreenchido manualmente, isolado dos automáticosPreenchido manualmente, isolado, com marcação visível de que é manual

Quando essa planilha automatizada já virou um painel de verdade?

Uma planilha com script por trás já resolve a maior dor do dia a dia: parar de digitar. Só vira sistema quando ganha histórico consultável, alerta de variação fora do padrão e separação clara entre automático e digitado.

Se sua planilha já passou desse ponto e virou difícil de manter, o artigo sobre transformar uma planilha que cresceu demais num sistema trata dessa transição.

“Não sei programar — dá pra ter isso mesmo assim?”

A automação em si — o script chamando a API todo dia — precisa de alguém que escreva ou adapte esse código uma vez. Depois de pronto e funcionando, o uso diário não exige nenhuma linha de código: você só olha a planilha ou o painel prontos.

O ponto real da objeção não é “programar”, é “quem mantém quando algo mudar” — porque plataformas mudam API sem aviso, e um script que funcionava pode parar de funcionar do dia para a noite. Essa rota é comparada com outras (sistema pronto, ferramenta de automação visual, ou contratar quem escreva o código) em Claude Code ou n8n/Make: qual resolve automação de negócio.

Vale lembrar também que dado de cliente passando por essas chamadas de API carrega responsabilidade sobre onde fica gravado — esse ponto está detalhado em é seguro usar IA com dados de clientes.

Um caso real: o dia em que o número saiu errado sem nenhum aviso

Esta automação foi construída para acompanhar o crescimento de um negócio: um script na nuvem, ligado a uma planilha, chamando a API de uma plataforma de anúncios uma vez por dia. Dois números buscados: o alcance/seguidores atual de uma rede social, e o gasto do dia — mas o das campanhas de aquisição, nunca o total da conta.

Na primeira versão, o script somava o gasto total da conta, que incluía também as campanhas de reimpacto (remarketing). Isso inflava o custo por resultado sem nenhum erro na tela: o script rodava, entregava um valor, e o valor estava simplesmente errado. Um dia registrou R$ 24,46 de gasto quando o valor correto — filtrando só o tipo certo de campanha — era R$ 18,31.

A correção foi filtrar a chamada da API por tipo de campanha antes de somar, nunca pelo total da conta. É o padrão que a computação chama de “entra lixo, sai lixo”: dado de entrada errado produz resultado errado, mesmo com o cálculo tecnicamente correto por cima dele (Wikipedia, “Garbage in, garbage out”).

Por que uma métrica ficou manual mesmo depois de tudo automatizado?

O segundo limite do mesmo caso não foi bug, foi teto da própria plataforma: uma das três métricas — quantos seguidores um conteúdo trouxe — não é acessível pela API para vídeo curto, só para foto estática. Pedir essa métrica para um vídeo devolve erro dizendo que ela não é suportada para aquele formato.

A solução não foi insistir: essa métrica ficou manual, e as outras duas seguiram 100% automáticas. É o mesmo princípio do item anterior — assumir a fresta em vez de fingir que ela não existe.

O que aconteceu quando a automação bateu o limite de chamadas de verdade?

Terceiro achado do mesmo caso, numa sessão de teste mais pesada: a conta bateu um limite de chamadas por hora, e o erro parecia dizer que um dado “não existia” — era throttling puro, disfarçado de erro de conteúdo.

O limite resetou sozinho em cerca de uma hora. Na rotina diária normal, que faz poucas chamadas, esse teto nunca chega nem perto de ser tocado — o risco existe só quando alguém testa em rajada, chamando o mesmo endpoint muitas vezes seguidas em pouco tempo.

O que muda depois de montar essa automação?

Antes, juntar os três números do dia era abrir aplicativo, abrir painel de anúncio e digitar numa planilha, todo dia, sem exceção. Depois, dois desses três números aparecem sozinhos antes de a pessoa abrir o computador; resta digitar só o que a plataforma realmente não entrega.

O tempo poupado não é a única mudança: o número deixa de carregar o risco silencioso de somar a fonte errada, porque o filtro certo está escrito no script, testado uma vez, sem depender de ninguém lembrar de aplicá-lo à mão todo dia.

Resumo

Automatizar a maioria dos números que vêm de fontes diferentes é viável com um script simples chamando cada API uma vez por dia. Mas quase sempre sobra um dado que a plataforma não expõe, e fingir 100% de automação é pior do que assumir esse campo como manual.

O erro mais caro não é o dado que falta e você percebe: é o dado somado errado — total da conta em vez do filtro certo — que passa sem aviso e derruba a confiança no painel no dia em que alguém confere a conta na mão.

Veja também: o que dá errado quando um agente de IA atende no WhatsApp e quanto custa o agente de IA do WhatsApp Business por mês.

Fontes primárias consultadas: o limite de chamadas em API, conforme a referência de status HTTP 429 da MDN Web Docs; o erro silencioso por dado de entrada incorreto, conforme o verbete “Garbage in, garbage out” da Wikipedia. O caso, os números do bug de gasto e o limite de métrica por formato de vídeo são vivência direta da Apare as Pontas, com rede social, plataforma de anúncio e negócio omitidos por confidencialidade.

Comentários

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *