Posts, insights diários e seguidores de cada rede
Régua por cliente, formato e retrato diário
Desempenho por post, perfil e mês
Relatório, dashboard e agente de IA
O que resolve
- O alcance e o engajamento do relatório batem com o que o cliente vê no app.
- O histórico de seguidores existe mesmo depois que a API só mostra o número de hoje.
- O melhor post do mês sai da mesma régua em todas as redes, sem post de vaga ou anúncio no meio.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- Instagram, LinkedIn, Facebook Pages e TikTok conectados por perfil de cliente
- Um retrato diário de seguidores e perfil gravado desde o primeiro dia
- A régua combinada com cada cliente: alcance ou visualizações, e o que entra no ranking
O que você recebe
- Uma tabela por post com formato, alcance, visualizações, interações e taxa de engajamento
- Uma série diária por perfil com seguidores, ganhos e alcance
- Big numbers do mês contra o mês anterior, na mesma régua
- Um agente de IA que responde sobre orgânico sem misturar com mídia paga
Onde ativar
Big numbers, melhor post e evolução de seguidores, com a régua declarada no rodapé.
Responde qual foi o melhor post e quanto o perfil cresceu, sem confundir orgânico com pago.
Ranking por formato e por pilar de conteúdo, com a imagem do post.
As fontes são simples. O trabalho está em gravar o histórico desde já e em fixar a régua de cada cliente antes do primeiro relatório. O detalhado traz as regras de negócio, as armadilhas e o teste de aceitação. Ou mande tudo direto para o seu agente com o MCP da Nekt.
Cada rede entrega o orgânico de um jeito: o Instagram trocou impressões por visualizações, o LinkedIn chama alcance de impressões únicas e o TikTok não tem alcance. Seguidores e dados de perfil são só o número de hoje, então quem não gravou o histórico não consegue dizer quantos seguidores o cliente ganhou em março. E quem soma o alcance diário entrega um número maior que o real, que o cliente não reconhece no app.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Alcance conta pessoas únicas. Somar o alcance de vários dias ou de vários posts conta a mesma pessoa mais de uma vez. Para o mês, use o alcance de 28 dias que a própria rede deduplica (instagram_insights_rolling_days28 no último dia) ou mostre alcance por post. Interações, curtidas, comentários e visualizações se somam.
Escolha com o cliente a métrica de cobertura e mantenha. No Instagram, a API descontinuou impressions em abril de 2025 e passou a entregar views. No LinkedIn não existe views de post: a aproximação é impressionCount, com uniqueImpressionsCount como alcance. Grave numa coluna qual campo de origem gerou cada número.
Seguidores é o valor no último dia do período. Ganho de seguidores é o fim menos o fim do período anterior, ou a soma dos ganhos diários quando a rede entrega (no LinkedIn, followerGains orgânico mais pago). Repetir o número mais recente em todas as linhas do passado cria um histórico plano que não existiu.
Perfil, seguidores e métricas acumuladas de vídeos e de página são só o estado atual. Grave uma linha por perfil e por dia depois de cada sincronização, com data de referência igual ao dia anterior no fuso do cliente e gravação idempotente (rodar duas vezes no mesmo dia atualiza a mesma linha). Nunca sobrescreva a tabela de histórico.
Métricas de post (media_insights, post_statistics) são acumuladas na vida do post e seguem crescendo depois do mês. No ranking e na contagem de posts, o post fica no mês em que foi publicado, e o relatório diz até que data as métricas foram lidas. Métrica diária da conta (insights_rolling_day) fica no dia do insight.
No Instagram, media_type sozinho não separa Reels: VIDEO com media_product_type REELS é Reels, CAROUSEL_ALBUM é Carrossel, IMAGE é Estático e STORY é Story. Stories duram 24 horas e têm métricas próprias: ficam fora do ranking e da meta de posts, com contagem à parte.
Tire do ranking posts de vaga e recrutamento, posts sem estatística orgânica (dark posts e variações de anúncio no LinkedIn) e conteúdo impulsionado quando a régua for orgânica. Interação por mil seguidores (interações / seguidores do fim do período x 1000) compara posts de perfis de tamanhos diferentes.
Taxa de engajamento = interações / alcance, ou / visualizações se essa for a régua do cliente, calculada das somas do período e nunca como média das taxas diárias ou dos posts. O TikTok não entrega alcance nem salvos: lá a taxa é (curtidas + comentários + compartilhamentos) / visualizações, e o relatório avisa que a régua é outra.
Alcance e engajamento de perfil não existem nas tabelas de Meta Ads, que são mídia paga. Se o perfil do cliente não está conectado, a resposta é que não há dado orgânico, e não um número tirado do Facebook Ads. Peça produzida também não é peça publicada.
Insights diários e contagem de seguidores sincronizam em horários diferentes e um atrasa o outro. Junte as duas séries por dia mantendo os dias de ambas (FULL OUTER JOIN), senão o dia mais recente some do gráfico.
Régua por rede
O campo que responde cada métrica, por rede. Declare no contexto do cliente qual é a régua oficial.
Definições
Armadilhas que já aconteceram
Somar o reach diário do mês dava um alcance bem acima do que o app mostrava, porque a mesma pessoa era contada em vários dias.
Use o alcance de 28 dias da rede ou o alcance por post.
Depois de abril de 2025 o campo impressions do Instagram parou de vir e o relatório passou a mostrar zero, como se o perfil tivesse parado.
Troque para views e registre a data da mudança no contexto.
A tabela guardava só o total de hoje, repetido em todas as linhas. O gráfico de evolução saiu plano e o ganho do mês, zero.
Retrato diário em append desde o primeiro dia.
Posts de recrutamento impulsionados pelo RH lideravam o ranking de impressões no LinkedIn e escondiam o conteúdo de marca.
Filtro de vaga e de post sem estatística orgânica.
Filtrar o agregado da página com share = '' devolvia zero linhas, porque o campo vem nulo e não vazio. Abrir por país com pageStatisticsByGeoCountry também zerava meses em que o array vinha vazio.
Teste nulo e vazio juntos e use os totais de totalPageStatistics.
Insights e seguidores sincronizavam em horários diferentes e a junção simples derrubava o dia mais recente.
Junção que preserva os dias das duas séries.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Para um perfil e um mês fechado, visualizações e interações batem com o painel nativo da rede ou com a ferramenta de relatório do cliente (diferença abaixo de 2%).
- Nenhum alcance mensal é soma de alcance diário: o alcance do mês é igual ao alcance de 28 dias da rede no último dia.
- Seguidores no fim de cada mês vêm do retrato daquele dia, e fim do mês menos fim do mês anterior é igual aos seguidores ganhos.
- Stories não aparecem no ranking, e a soma de posts por formato é igual ao total de posts publicados.
- A tabela de posts tem uma linha por post e por rede.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Redes sociais orgânicas - Fonte orgânica é a do perfil (Instagram, Facebook Pages, LinkedIn orgânico, TikTok). Tabelas de Meta Ads são mídia paga e nunca respondem alcance ou engajamento de perfil. Sem fonte orgânica do cliente, diga que não há dado. - Alcance não se soma entre dias nem entre posts. Alcance do mês = alcance de 28 dias da rede no último dia, ou alcance por post. - Régua de cobertura por rede: Instagram = views (impressions foi descontinuado em abril de 2025); LinkedIn = impressionCount, com uniqueImpressionsCount como alcance; TikTok = view_count. - Taxa de engajamento = soma das interações / soma da base declarada do cliente, no mesmo período. TikTok não tem alcance nem salvos. - Seguidores = valor do retrato do último dia do período. Seguidores ganhos = fim menos fim do período anterior. - Post pertence ao mês de publicação; as métricas de post são acumuladas até a data da leitura, que deve ser informada. - Formato no Instagram: media_type + media_product_type. Stories ficam fora do ranking de posts. - O ranking exclui posts de vaga e recrutamento e posts sem estatística orgânica. - No LinkedIn, o agregado da página em daily_share_statistics é a linha com share e ugcPost nulos ou vazios. Exceções por cliente: - <cliente>: régua oficial é <visualizações | alcance>; taxa de engajamento sobre <base>. - <cliente>: Instagram sem conector; números mensais vêm de <ferramenta de relatório>, validados até <mês>. - <cliente>: posts com <termo> na legenda ficam fora do ranking.
Construa no meu workspace Nekt o caso "Redes sociais orgânicas" seguindo as regras em https://academy.nekt.com/industrias/agencias/redes-sociais-organicas.md. 1) Encontre as tabelas de origem e confirme as colunas usadas pelas regras. 2) Crie uma transformação no grão indicado aplicando todas as regras. 3) Rode o teste de aceitação e me mostre o resultado de cada item. 4) Crie o context document do caso no workspace, com as exceções dos meus clientes em aberto para eu preencher.
Variações
Classifique cada post por pilar a partir de palavras ou hashtags da legenda e compare o engajamento por pilar.
Custo por seguidor = investimento das campanhas de seguidores / seguidores ganhos na mesma rede e no mesmo dia.
Sentimento dos comentários por post, para a seção de saúde da marca do relatório.