Tabelas finais de mídia, funil e orgânico
Placar do período fechado calculado em SQL
Leitura escrita por IA sobre o placar
Envio agendado por cliente
O que resolve
- O relatório sai no dia e na hora, sem montagem manual.
- Todos os clientes recebem o mesmo padrão, comparável entre si.
- A leitura do período vem escrita, sem número inventado.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- Tabelas finais de mídia e funil por cliente
- A estrutura de relatório aprovada com cada cliente
- Uma chave de API de LLM guardada como secret na Nekt
O que você recebe
- Um placar por cliente e período, com anterior, média e variação
- Uma leitura executiva escrita por IA
- Envio automático no canal de cada cliente
- Log de envio por cliente e período
Onde ativar
Slack, Google Chat, Discord ou e-mail em horário fixo, uma mensagem por cliente.
HTML ou deck editável na estrutura aprovada pelo cliente.
O gerente de conta pede o relatório e o agente segue o modelo do contexto.
O placar é SQL simples sobre tabelas que já existem. O trabalho está no modelo por cliente e no notebook de envio. 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.
Montar o relatório de cada cliente à mão consome dias da equipe todo começo de mês, e cada analista faz de um jeito. Quando a IA entra para escrever, ela inventa número, compara mês parcial com mês cheio ou preenche com zero um canal que o cliente nem contratou.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Placar, variações, ranking e prioridade são calculados numa tabela antes do modelo. O LLM recebe o placar pronto do cliente e do período e escreve síntese, destaques, alertas e recomendações. A prioridade é calculada na transformação, não pelo modelo.
Semana de segunda a domingo (ISO) ou mês calendário fechado, no fuso do cliente. O relatório roda depois que os dados estabilizam: na segunda de manhã para a semana, alguns dias após a virada para o mês (ex.: dia 4). Mês corrente só aparece rotulado como parcial.
Uma linha por cliente, período e plataforma. Para cada métrica: valor atual, período anterior (_ant), média das 4 últimas semanas incluindo a atual (_med4) e variação contra o anterior (_var). O mesmo placar alimenta o dashboard e a mensagem: o consumidor só filtra o período.
Semana contra a semana anterior, mês contra o mês anterior. Em janelas móveis, últimos 30, 90, 180 e 365 dias contra a janela imediatamente anterior de mesmo tamanho. Custo por resultado do período é soma do investimento sobre soma do resultado, nunca média de custos diários.
Se o cliente não tem a fonte conectada (SEO, CRM, orgânico), a seção sai do relatório; não entra com zero. Se o pipeline não rodou no período, o relatório diz isso, não preenche. Dado manual (ex.: LinkedIn de perfil pessoal) vem marcado como manual.
Ordem das seções, quadros, cores e tipografia ficam num documento de contexto do cliente, a partir de um relatório de referência aprovado. Todo relatório segue essa estrutura. Para apresentações, use elementos nativos e editáveis, nunca texto queimado em imagem.
Faltou meta do próximo mês, entregas do período ou premissas do cliente: o agente pergunta antes de montar. Print ou valor informado pelo time só entra quando a tabela não existe; nunca para completar um número que o warehouse tem.
Antes de enviar, confira se a tabela de origem é do dia. Se não for, espere uma janela curta (ex.: 25 minutos) e, se não chegar, envie avisando que os dados são do dia anterior.
Log persistente por cliente e período: reexecutar não reenvia. A falha de um cliente não interrompe os demais. Mensagens longas são partidas no limite do canal (ex.: 1.900 caracteres no Discord). Cliente que saiu da carteira não recebe relatório; churn é sinalizado.
Definições
Armadilhas que já aconteceram
Com dado cru, o modelo calculou errado e completou lacunas com valores plausíveis.
Entregar o placar fechado e conferir cada número do texto contra ele.
Mês corrente comparado com mês cheio mostrou queda forte que não existia.
Comparar períodos fechados ou rotular o parcial.
Seções sem conector entraram zeradas e o cliente achou que o canal tinha morrido.
Escopo por cliente: sem conector, sem seção.
Campos de anotação cortados em 600 caracteres decepavam a frase literal do cliente, e o texto saía genérico.
Não truncar o contexto que dá o tom; limites altos e só os campos necessários.
A cadeia atrasou e a mensagem saiu no horário com o dado de dois dias antes, sem ninguém notar.
Checar a data da tabela antes de enviar e avisar quando estiver velha.
Um erro num cliente interrompia todos os outros, e a nova tentativa reenviava quem já tinha recebido.
Log por cliente e período e isolamento de falha.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Para um cliente e uma semana fechada, cada número do placar bate com a consulta direta na tabela de origem (diferença zero).
- Todo número citado na leitura escrita pela IA existe no placar daquele cliente e período.
- Um cliente sem conector de SEO não tem seção de SEO no relatório, nem com zero.
- Reexecutar o envio do mesmo período não gera mensagem duplicada, e um cliente com erro não impede o envio dos outros.
- O mês corrente, quando aparece, vem rotulado como parcial.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Relatório recorrente ao cliente - O relatório cobre um cliente e um período fechado: semana de segunda a domingo ou mês calendário, no fuso do cliente. Mês corrente só como parcial, com rótulo. - Todo número sai do placar calculado no warehouse. A leitura escrita não traz número que não esteja no placar. - Comparações: período anterior de mesmo tamanho (_ant), média das 4 últimas semanas (_med4) e variação (_var). Nunca parcial contra cheio. - Custo por resultado = soma do investimento / soma do resultado do período. - Seção sem conector ligado no cliente sai do relatório; não entra com zero. Se o pipeline não rodou, diga isso. - Siga a estrutura aprovada do cliente: ordem das seções, quadros e cores do documento de modelo dele. - Se faltar meta, premissa ou entrega do período, pergunte antes de montar. Nunca estime. - Print ou valor informado só quando a tabela não existe; nunca para completar número que o warehouse tem. - Cliente com status de churn não recebe relatório; apenas sinalize. Exceções por cliente: - <cliente>: relatório semanal, seções na ordem <lista>, modelo aprovado em <data>. - <cliente>: <escopo> é dado manual, informado pelo time até o dia <n>. - <cliente>: resultado do relatório = <evento>, custo com imposto de <x>%.
Construa no meu workspace Nekt o caso "Relatório recorrente automatizado" seguindo as regras em https://academy.nekt.com/industrias/agencias/relatorio-recorrente-automatizado.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
Ontem por cliente, curto, para o time de mídia, com Meta e Google lado a lado.
Jornada do ciclo inteiro e proposta de continuidade, em vez de mês contra mês.
Últimos 30, 90, 180 e 365 dias contra a janela anterior de mesmo tamanho.