🫡 ASPIRA · WORKFLOW + PRD

Analytics IntusCripto

Pipeline diário de coleta, processamento e entrega de métricas de Instagram, Meta Ads e YouTube — 5 crons sequenciais, dados consolidados no Telegram às 09:00 BRT.

📊 3 Plataformas ⏰ 08:30–09:00 BRT 🤖 1 Agente 🧠 Claude Sonnet 💰 ~$0.01/dia
Status
Parcial — Consolidado em error
Versão
v1.0
Plataformas
Instagram · Meta Ads · YouTube
Alertas
16:00 BRT Meta Ads
⚠️ Token expira
Instagram 08/mai · Meta 09/mai
⚠️
Tokens expirando em breve: Instagram Graph API expira 08/mai/2026 · Meta Ads token expira 09/mai/2026. Renovar antes dessas datas via developers.facebook.com → Intus Analytics (app ID 1406679341248800).
→

Pipeline Diário

Coleta sequencial das 3 plataformas + relatório consolidado

⏰
08:30 BRT
Instagram
summary-*.txt
📘
08:40 BRT
Meta Ads
meta-data
▶️
08:50 BRT
YouTube
yt-data
📊
09:00 BRT
Consolidado
relatório
📤
Telegram
#10325
📸
Instagram
08:30 BRT
Graph API → SQLite → dashboard HTML. Seguidores, alcance, reels, posts.
📘
Meta Ads
08:40 BRT
Meta Ads API → dashboard HTML + alertas 16h BRT. ROAS, CPA, CPM, CTR.
▶️
YouTube
08:50 BRT
YouTube Data API → dashboard HTML. Views, inscritos, watch time, CTR.
📊
Consolidado
❌ Error
Cron 09:00 BRT em error. Resumo unificado não está chegando no Telegram #10325.
⇄

Entrada → Saída

📥 Fontes de dados
📸Instagram Graph API — @diego.spanevellotoken
📘Meta Ads API — conta de anúncios Intustoken
▶️YouTube Data API — canal IntusCriptoAPI key
→
📤 Saída
🌐Dashboards HTML atualizados (portal público)diário
📬Resumo consolidado → Telegram #1032509:00 BRT
🚨Alertas Meta Ads → Telegram #1032516:00 BRT
⚠️

Regras Críticas

🔑
Tokens via 1Password — nunca hardcoded
Instagram token, Meta Ads token e YouTube API key armazenados no vault Aspira. Scripts usam op read antes de cada execução.
📅
Renovar tokens antes do prazo
Instagram expira 08/mai. Meta expira 09/mai. Renovar com pelo menos 7 dias de antecedência via developers.facebook.com app "Intus Analytics" (ID: 1406679341248800).
🔇
Crons individuais NÃO enviam Telegram
Cada cron (08:30, 08:40, 08:50) só atualiza os dados e dashboards. Apenas o cron consolidado (09:00) envia para o Telegram #10325.
🚨
Meta Ads Alertas — confirmação antes de pausar
O script meta-ads-alerts.sh analisa performance e sugere ações. Toda ação de escrita (pausar campanha, alterar budget) requer confirmação de Diego.
Instagram
✅ ok (3h ago)
Meta Ads
✅ ok (2h ago)
YouTube
✅ ok (2h ago)
Consolidado
❌ error (2h ago)
Meta Alertas 16h
✅ ok (19h ago)
1

Instagram Analytics — 08:30 BRT

Coleta via Graph API, SQLite, gera dashboard + summary

1
Instagram Analytics — deploy.sh
@diego.spanevello · Graph API → SQLite → dashboard HTML
Execução
📸Sistema / script
LLM
n/a — Node.js scripts
APIs
Instagram Graph API
Scripts
collector.jsgenerate-dashboard.jsgenerate-summary.js
Custo~$0.00sem LLM~30s
📥 Recebe
🔑Instagram token (1Password)
→
📤 Produz
📊instagram-dashboard.html atualizado
📄data/summary-YYYY-MM-DD.txt
1
collector.js — coleta dados da API
Busca via Graph API: seguidores, alcance, impressões, posts recentes, métricas de reels e imagens. Armazena em SQLite (analytics.db).
2
generate-dashboard.js — gera HTML
Lê o SQLite, processa comparações (semana vs semana, mês vs mês), gera o instagram-dashboard.html completo com gráficos e tabelas.
3
generate-summary.js — gera resumo
Cria data/summary-YYYY-MM-DD.txt com os principais números do dia, formatado para ser lido pelo cron consolidado às 09:00.
⚠️Token expira 08/mai/2026. Renovar via developers.facebook.com → app Intus Analytics → Explorador da Graph API → gerar novo token → converter para long-lived.
2

Meta Ads Dashboard — 08:40 BRT

Atualiza dashboard de campanhas + alertas de performance às 16h

2
Meta Ads Dashboard — update-meta-ads-dashboard.sh
Campanhas ativas · ROAS · CPA · CPM · CTR
Execução
📘Sistema / ASPIRA
LLM (alertas)
Claude Sonnet 4.6
APIs
Meta Ads APIFacebook Graph API
Skills
facebook-ads-manager
Custo~$0.003alertas 16h usam Sonnet~45s
📥 Recebe
🔑Meta token + ad_account_id (1Password)
→
📤 Produz
📊dashboard HTML atualizado
🚨alertas 16h BRT → Telegram #10325
1
update-meta-ads-dashboard.sh (08:40)
Coleta campanhas ativas, conjuntos, anúncios via Meta Ads API. Atualiza o dashboard HTML com ROAS, CPA, CPM, CTR, frequência, alcance e orçamento.
2
meta-ads-alerts.sh (16:00 BRT)
Script separado, cron próprio. Analisa performance do dia, identifica campanhas com CPA acima do limite ou ROAS abaixo do mínimo. Envia alerta para Telegram #10325. Toda ação de escrita requer confirmação de Diego.
⚠️Token Meta Ads expira 09/mai/2026. Renovar via developers.facebook.com → Explorador da Graph API → app Intus Analytics (ID: 1406679341248800) → gerar token curto → Diego envia aqui → ASPIRA converte para long-lived.
3

YouTube Analytics — 08:50 BRT

YouTube Data API → dashboard de canal e vídeos

3
YouTube Analytics — update-youtube-dashboard.sh
Canal IntusCripto · views · inscritos · watch time · CTR
Execução
▶️Sistema / script
LLM
n/a — script
APIs
YouTube Data APIYouTube Analytics API
Custo~$0.00sem LLM~20s
📥 Recebe
🔑YouTube API key (1Password)
→
📤 Produz
📊dashboard YouTube atualizado
📄resumo do dia para consolidado
1
Coletar métricas do canal
Views, inscritos ganhos/perdidos, watch time, CTR de thumbnails, impressões, top vídeos por período.
2
Gerar dashboard e resumo
Atualiza dashboard HTML. Gera resumo diário com os principais números para ser consumido pelo cron consolidado.
4

Analytics Consolidado — 09:00 BRT ❌

Cron em error — resumo unificado das 3 plataformas para Telegram #10325

4
Relatório Consolidado — Telegram #10325
⚠️ Cron 87de381d em ERROR — investigar e corrigir
Agente responsável
🫡ASPIRA
LLM
Claude Sonnet 4.6
Tools
readmessage
Custo~$0.005~5k tokens Sonnet~20s
1
Ler resumos dos 3 scripts
Lê: skills/instagram-analytics/data/summary-YYYY-MM-DD.txt + dados Meta Ads + dados YouTube do dia atual.
2
Gerar relatório consolidado
ASPIRA consolida os 3 resumos em uma mensagem estruturada com as principais métricas de cada plataforma e enviar para Telegram tópico #10325 (Analytics).
⚠️CRON EM ERROR (87de381d). O relatório consolidado não está sendo entregue no Telegram. Investigar: provavelmente summary file não encontrado ou path incorreto. Corrigir com urgência.
⚙️

Matriz Técnica Completa

#Cron / JobHorárioScript / AgenteLLMAPIsInputOutputStatusTempo
1 Instagram Analytics
311f6904		 08:30 BRT
collector.jsgenerate-dashboard.jsgenerate-summary.jsdeploy.sh
 n/a
Instagram Graph API
 Token 1Password instagram-dashboard.html + summary-*.txt ✅ ok ~30s
2 Meta Ads Dashboard
70dde711		 08:40 BRT
update-meta-ads-dashboard.sh
 n/a
Meta Ads API
 Token + ad_account_id Meta dashboard HTML ✅ ok ~45s
3 YouTube Analytics
266a81c0		 08:50 BRT
update-youtube-dashboard.sh
 n/a
YouTube Data API
 YouTube API key YouTube dashboard HTML ✅ ok ~20s
4 📊 Consolidado
87de381d		 09:00 BRT
ASPIRA agentTurn
 Claude Sonnet 4.6 — summary-*.txt dos 3 scripts Mensagem Telegram #10325 ❌ error ~20s
5 Meta Ads Alertas
d5599c82		 16:00 BRT
meta-ads-alerts.sh
 Claude Sonnet 4.6
Meta Ads API
 Campanhas do dia Alerta Telegram #10325 ✅ ok ~30s
🔒

Credenciais & Tokens

1Password — vault "Aspira"
  • Instagram Graph API: token long-lived (expira 08/mai/2026) → app Intus Analytics
  • Meta Ads: access_token + ad_account_id + app_id + app_secret (expira 09/mai/2026)
  • YouTube Data API: API key (sem expiração automática)
Processo de renovação de token (Instagram + Meta)
  • Acessar developers.facebook.com → Meus apps → Intus Analytics (ID: 1406679341248800)
  • Ferramentas → Explorador da Graph API → gerar token curto
  • Diego envia o token curto para ASPIRA no Telegram
  • ASPIRA converte para long-lived via API + atualiza 1Password
Canal de output
  • Telegram: grupo -1003880005285, tópico #10325 (Analytics)
📊
Fase 4 — Relatório Consolidado (09:00 BRT)
Agente: ASPIRA · LLM: Claude Sonnet 4.6 · Cron: 87de381d ❌ em error
ASPIRA
🧩 SYSTEM PROMPT — Analytics Consolidado
agentTurncron 09:00 BRT
Você é ASPIRA. Gere o resumo consolidado de analytics e envie para o tópico Analytics (10325). PASSO 1 — INSTAGRAM: DATA=$(TZ='America/Sao_Paulo' date +%Y-%m-%d) Leia: /home/molt/.openclaw/workspace/skills/instagram-analytics/data/summary-$DATA.txt Extraia: Seguidores (com variação), Alcance, Impressões, Posts do dia, Reels performance PASSO 2 — META ADS: Leia os dados do dashboard Meta Ads atualizado. Extraia: Gasto do dia, ROAS, CPA, CTR, campanhas ativas, alertas se houver PASSO 3 — YOUTUBE: Leia o resumo YouTube do dia. Extraia: Views do dia, inscritos (variação), watch time, vídeo com melhor CTR PASSO 4 — FORMATAR E ENVIAR: Montar mensagem consolidada para Telegram tópico #10325: 📊 *Analytics IntusCripto — {{ DATA_BRT }}* 📸 *Instagram* • Seguidores: X (±Y) • Alcance: X | Impressões: X 📘 *Meta Ads* • Gasto: R$X | ROAS: X | CPA: R$X ▶️ *YouTube* • Views: X | Inscritos: ±X message(action=send, target=-1003880005285, threadId=330, message=...)
🚨
Fase 5 — Meta Ads Alertas (16:00 BRT)
Script: meta-ads-alerts.sh · Envia alertas de performance e sugestões de otimização
Meta Ads
🧩 LÓGICA — Meta Ads Alerts
Script meta-ads-alerts.sh analisa as campanhas ativas e gera alertas quando: ALERTA VERMELHO (ação urgente): - CPA hoje > CPA meta × 1.5 - ROAS hoje < ROAS mínimo × 0.7 - Campanha gastou > 90% do budget diário antes das 16h ALERTA AMARELO (atenção): - CPA hoje entre 1.2× e 1.5× do meta - CTR < benchmark histórico × 0.8 - Frequência > 3.5 no período FORMATO DO ALERTA → Telegram #10325: 🚨 *Meta Ads Alert — {{ DATA_BRT }}* [lista de alertas por severidade] ⚠️ SEGURANÇA: O script SUGERE ações mas NUNCA executa automaticamente. Toda mudança de campanha requer confirmação explícita de Diego.
🧭
Visão Geral
O que é
Pipeline diário automático que coleta métricas de Instagram, Meta Ads e YouTube, atualiza os dashboards visuais e entrega um relatório consolidado no Telegram todo dia às 09:00 BRT. Funciona com 5 cron jobs sequenciais sem intervenção humana.
Problema resolvido
✅ Corrigido em 26/03/2026 — threadId errado (10325 → 330) + timeout insuficiente (180s → 300s) + payload reestruturado para ler arquivos já processados (não coletar do zero). Cron operacional a partir de 27/03 às 09:00 BRT.
🎯
Objetivos & Métricas
09:00
Entrega diária
BRT — pontualidade crítica
3
Plataformas
Instagram · Meta Ads · YouTube
~$0.01
Custo/dia
Só consolidado usa LLM
5 crons
Jobs ativos
4 coleta + 1 consolidado + 1 alerta 16h
⚠️
Riscos & Mitigações
  • Risco crítico: Token Instagram/Meta expirando
    ✅ Lembretes automáticos: Crons de lembrete 7 dias antes (08/mai e 09/mai). Processo de renovação documentado acima.
  • Risco resolvido (26/03): Consolidado 09h estava em error
    ✅ Corrigido: threadId 10325 → 330, timeout 180s → 300s, payload refatorado para ler arquivos locais já processados (não coletar do zero). Tempo estimado de execução: ~30s.
  • Risco: Graph API rate limit
    ✅ Mitigação: Coletas espaçadas (08:30, 08:40, 08:50). Cache de 24h para dados históricos.
📜
Changelog
  • v1.0 — Mar/2026 — Pipeline completo com 5 crons.
  • v1.1 — 26/03/2026 — ✅ Correção crítica: threadId 10325 → 330 | timeout 180s → 300s | payload refatorado (lê arquivos locais, não coleta do zero) | agente ANALYTICS delegado para diagnóstico e correção.
  • Roadmap v1.2: Adicionar comparação semana anterior no relatório consolidado + campo "Vendas no dia" com breakdown diário real via Meta Ads API.
Instagram
✅ Operacional
Meta Ads
✅ Operacional
YouTube
✅ Operacional
Consolidado
✅ Corrigido — 26/03
Token expira
08/mai (IG) · 09/mai (Meta)