Tabelas gold do período fechado
Período fechado, recorte por público e comparação de mesmo tamanho
Placar por público, com log de envio
Email, Slack, Teams, Google Chat ou chat do CRM
O que resolve
- O resumo chega pronto, no horário, para cada público, sem ninguém montar.
- Cada pessoa recebe só o que é dela: a diretoria o consolidado, o gerente a sua unidade.
- Quando o dado atrasa, a mensagem avisa em vez de mandar número velho.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- As métricas do resumo em tabelas gold, com regra fechada
- A lista de públicos, o que cada um recebe, por qual canal e em que horário
- A credencial do canal de envio guardada como segredo na Nekt
O que você recebe
- Um placar por público e período, calculado no warehouse
- A mensagem montada a partir do placar, com comparação e destaques
- Um log de envio que impede reenvio e mostra falhas
- Aviso automático quando a fonte não carregou
Onde ativar
Gmail ou Outlook com o resumo em HTML, montado a partir do placar.
Slack, Teams, Google Chat ou o chat do CRM, com mensagens partidas no limite do canal.
Lista curta e acionável para quem está em campo, como os itens mais orçados e não fechados da semana.
Com as golds prontas, cada resumo é um placar e uma rotina de envio. O cuidado está na regra de período, no log de envio e em desligar o que ninguém lê. 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.
O resumo diário é uma consulta agendada no relógio que manda o que estiver na tabela. Na segunda-feira compara com domingo; no dia em que a carga atrasou, manda o número de anteontem como se fosse de ontem; no reprocessamento, manda duas vezes; quando um destinatário falha, os outros não recebem. Meses depois, a rotina continua rodando e gastando crédito para um canal que ninguém lê.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Calcule numa tabela, por público e período, cada métrica com o valor atual, o período anterior e a variação. A rotina de envio só formata. Se houver texto escrito por IA, ela recebe o placar pronto e não traz número que não esteja nele; a prioridade dos destaques também é calculada na tabela, não pelo modelo.
O resumo diário cobre o dia anterior no fuso do negócio. Em rotina de dias úteis, a segunda-feira analisa a sexta e feriados nacionais são pulados. A semana é definida uma vez (segunda a domingo ou domingo a sábado) e escrita. O mês corrente vem como acumulado parcial, nunca comparado com mês cheio.
Dia contra o mesmo dia da semana anterior, semana contra semana, acumulado do mês contra os mesmos dias do mês anterior. Variação de taxa sai em pontos percentuais; base muito pequena vira variação em reais.
A lista de destinatários vive numa tabela (público, canal, destino, recorte, horário), não no código. Diretoria recebe o consolidado; gerente, a sua unidade; vendedor ou assessor, a sua carteira. Linha de outra unidade nunca vai para quem não deveria ver. Cliente que saiu da carteira deixa de receber.
Antes do envio, confira se a tabela de origem tem o dia de referência. Se não tiver, espere uma janela curta e, se não chegar, envie avisando de quando é o dado, ou não envie. Um bloco de sinal de vida (quantos registros entraram nas últimas 24 horas) denuncia ingestão parada.
Grave cada envio num log (público, período, canal, status, horário). Reexecutar não reenvia o que já foi. A falha de um destinatário não interrompe os outros, e falha de envio faz a execução falhar de forma visível. Mensagens longas são partidas no limite do canal.
Toda rotina nova roda primeiro sem enviar (modo seco), depois para um destinatário interno e só então para a lista real. Mensagem para cliente pode nascer como rascunho, revisado por alguém antes do envio.
Abra com uma leitura de até cinco linhas antes de qualquer tabela. Mostre o que pede ação: o que saiu da faixa, o que estourou, o que está em risco. A ordem dos blocos é fixa (mês atual antes do anterior, consolidado antes do detalhe), para o leitor achar o mesmo lugar todo dia. Valores em padrão brasileiro, com rodapé de fonte e data da carga.
Destino desligado, canal sem leitura ou relatório substituído continuam consumindo crédito. Revise as rotinas periodicamente e pause as que não têm leitor, registrando o motivo e a data.
Ritmo e recorte por público
Um ponto de partida comum nos workspaces. Ajuste o horário à rotina de cada time.
Definições
Armadilhas que já aconteceram
A cadeia de cargas atrasou e o resumo saiu no horário com o número de anteontem, sem aviso.
Cheque a data da origem antes de enviar e avise.
Uma fonte ficou mais de um mês sem carregar e ninguém percebeu, porque nada avisava. O mês aparecia com uma fração dos lançamentos reais.
Bloco de sinal de vida com o volume das últimas 24 horas.
Um erro num destinatário interrompia todos, e a nova tentativa reenviava para quem já tinha recebido.
Log por público e período e falha isolada por destinatário.
O destino do chat foi desligado e a consulta seguiu rodando todos os dias por mais de um mês.
Pause rotinas sem destino ativo e registre o motivo.
Um resumo diário em Spark passou a falhar em sequência, sem mensagem de erro útil. Reescrito em Python simples, voltou a rodar.
Rotina de envio é leve: notebook Python lendo o placar pronto.
Comparar ontem com anteontem fazia toda segunda parecer queda, porque o domingo não tem a mesma operação.
Dia útil anterior e comparação com o mesmo dia da semana anterior.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Para um dia de referência, cada número da mensagem bate com a consulta à tabela gold no mesmo dia.
- Rodar a rotina duas vezes no mesmo dia gera uma única linha de envio por público no log e uma única mensagem.
- Com a tabela de origem sem o dia de referência, a rotina envia o aviso de atraso ou não envia, e nunca envia o número do dia anterior como se fosse o de referência.
- Na segunda-feira, o resumo de dias úteis cobre a sexta; depois de um feriado nacional, cobre o último dia útil.
- Um gerente recebe zero linhas de outra unidade.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Resumo agendado por público - Cada resumo cobre um período fechado no fuso America/Sao_Paulo: diário = dia útil anterior (segunda cobre sexta, feriados nacionais pulados); semanal = <regra da semana>; mensal = mês calendário fechado. - Todo número vem do placar <tabela de placar>. A mensagem não traz número que não esteja no placar. - Comparações em janelas de mesmo tamanho: dia contra o mesmo dia da semana anterior, semana contra semana, acumulado do mês contra os mesmos dias do mês anterior. Taxas variam em pontos percentuais. - Antes de enviar, confira se a origem tem o dia de referência. Se não tiver, envie com o aviso 'dados até <data>' ou não envie. - Destinatários, canal, horário e recorte vêm da tabela <tabela de destinatários>. Ninguém recebe linhas fora do seu recorte. - Um envio por público e período: consulte o log <tabela de log> antes de enviar. - Estrutura: leitura de até cinco linhas e depois os blocos na ordem <lista de blocos>. - Valores em padrão pt-BR, sem emoji, com rodapé de fonte e data da última carga. Exceções por cliente: - <cliente>: resumo diário às <hora> para <público>, recorte <unidade>. - <cliente>: mensagem criada como rascunho e revisada por <pessoa> antes do envio. - <cliente>: semana de domingo a sábado.
Construa no meu workspace Nekt o caso "Relatórios diários por email" seguindo as regras em https://academy.nekt.com/casos/relatorios-por-email.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
O modelo recebe o placar pronto e redige destaques e alertas, sem calcular nada.
A mesma rotina só envia quando algo sai da faixa, como saldo de conta de anúncio para poucos dias úteis.
Um placar por cliente e período, com estrutura aprovada por ele e seções sem fonte retiradas.