VIGIA: como montar o seu

Antes de começar, 4 palavras

• API: a porta oficial que um sistema abre pra outro programa ler os dados dele. O Meta, o Google e o Telegram têm a sua.
• Token: uma chave de acesso, como uma senha que dá permissão pra ler a conta. Trate como senha.
• Bot: uma conta automática do Telegram. É por ela que o vigia te manda a mensagem.
• Modo ensaio: o vigia monta a mensagem e só mostra na tela, sem enviar. É assim que você testa sem medo.

O que o VIGIA faz

Todo dia às 7h40 (é o horário que eu escolhi), ele roda sozinho na nuvem, sem o meu computador ligado, e confere:

• o gasto de ontem de cada conta do Meta e do Google, comparado com a média diária dos 30 dias anteriores;
• as conversões de ontem, comparadas com a média. Conversão é o resultado que você quer do anúncio: alguém que chamou no WhatsApp, preencheu um formulário ou comprou;
• o saldo de cada conta e pra quantos dias ele ainda dá, no ritmo de gasto de agora;
• se alguma conta parou de gastar, que é como aparece o pagamento recusado ou o anúncio reprovado;
• se os sites abrem e mostram o que tem que estar lá.

Depois ele manda um resumo no Telegram. A mensagem chega todo dia, mesmo quando está tudo certo: se um dia ela não chegar, eu já sei que foi o vigia que quebrou.

Exemplo da mensagem do bot (dados inventados):

⚠️ Vigia · sex 16/10 · 3 alertas
Loja Exemplo
  Meta    R$ 142 (média R$ 120) · 9 conv. (média 8,4)
  Google  R$ 61 (média R$ 58) · 3 conv. (média 2,7)
Clínica Modelo  R$ 0 (média R$ 85) · 0 conv. (média 4,1) ⚠️ gastou zero
Oficina Demo  R$ 219 (média R$ 120) · 2 conv. (média 2,2) ⚠️ gasto 82% acima da média
Sites: lojaexemplo ✅ · clinicamodelo ⚠️ HTTP 503 · oficinademo ✅

Mesmo formato da mensagem que eu recebo. Loja Exemplo, Clínica Modelo, Oficina Demo e os números são inventados.

Ele só lê. O vigia não pausa campanha, não mexe em verba e não sobe anúncio. E não fica só na promessa: um teste no código confere isso e falha se alguém colocar ali uma função que escreve na conta.

O que você precisa

Claude com o Claude Code

Um plano do Claude que inclua o Claude Code, o Claude que trabalha dentro do seu computador: ele escreve o código, roda os testes e te explica cada passo. É o único custo.

Telegram

No celular, grátis. É onde o resumo chega.

Leitura das contas do Meta

Um token só com a permissão de ler anúncios (ads_read), gerado por um usuário do sistema no seu portfólio empresarial, o antigo Business Manager. Com essa permissão ele lê os números e não consegue mudar nada.

Leitura das contas do Google Ads (se você anuncia lá)

O acesso à API do Google Ads é liberado pelo Google, num projeto seu do Google Cloud. Você pede pelo painel e às vezes sai na hora, às vezes passa por análise. É a parte mais burocrática: se travar, comece só com o Meta e acrescente o Google depois.

Se o app do Google ficar em modo de teste, a autorização vence em 7 dias. Publique o app antes de ligar o vigia.

GitHub e Cloudflare (contas grátis)

O GitHub é onde o vigia roda todo dia sem o seu computador, pelo GitHub Actions (o recurso do GitHub que executa tarefas no horário). O Cloudflare é o relógio que aperta o botão na hora certa.

Quanto custa: quase zero. Você só paga o plano da IA. O resto, a hospedagem e o agendamento, é grátis: o plano grátis do GitHub dá 2.000 minutos por mês em repositório privado e o vigia usa uns 2 por dia; o relógio roda no plano grátis do Cloudflare.

Passo a passo

São 7 passos. Cada um termina num "pronto quando": só passe pro próximo quando ele estiver certo.

1. Crie o bot no Telegram

• No Telegram, abra o @BotFather e mande /newbot.
• Escolha um nome (ex.: Vigia) e um usuário que termine em bot. Ele responde com o token do bot.
• Guarde o token num lugar seguro e não cole no chat do Claude.
• Abra a conversa com o seu bot novo e mande um "oi". Isso libera o bot pra te responder.

Pronto quando: você tem o token guardado e já mandou o "oi" pro bot.

2. Guarde os acessos num arquivo de segredos

• Gere o token de leitura do Meta (e os acessos do Google Ads, se for usar), como está em O que você precisa.
• Crie uma pasta vazia no computador (ex.: vigia), abra o Claude Code nela e cole este pedido:

Crie nesta pasta um arquivo .env com estes campos vazios, um por linha:
META_ACCESS_TOKEN=
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=
Se eu for usar o Google Ads, acrescente os campos que a biblioteca do Google pede.
Coloque o .env no .gitignore pra ele nunca ir pro GitHub. Não me peça os valores e nunca mostre o conteúdo desse arquivo.

• Abra o .env no Bloco de Notas e cole você mesmo cada valor. O número do chat do Telegram fica pro passo 4.

Regra que eu sigo: token nunca passa pelo chat. Ele fica só nesse arquivo, no seu computador, e depois nos Secrets do GitHub, o cofre de segredos de lá.

Pronto quando: o .env está preenchido por você e aparece no .gitignore (a lista de arquivos que o GitHub ignora).

3. Peça pro Claude montar

Na mesma pasta, cole o prompt abaixo no Claude Code. Antes, troque o que está entre colchetes pelo seu caso.

Quero montar um "vigia" das minhas contas de anúncio. Não sou programador: me explique cada passo em português simples e me peça confirmação antes de qualquer coisa que dependa de mim.

O QUE ELE FAZ
Todo dia às [7h40] (horário de Brasília), sem depender do meu computador ligado:
1. Lê as minhas contas de anúncio do Meta [e do Google Ads].
2. Para cada conta, pega o gasto e as conversões de ontem, no fuso da própria conta, e compara com a média diária dos 30 dias anteriores a ontem. Pra mim, conversão é [mensagem no WhatsApp / formulário / compra].
3. Confere se os meus sites abrem e mostram um texto que tem que estar na página: [site e texto de cada um].
4. Manda um resumo curto no meu Telegram, por um bot. A mensagem sai todo dia, mesmo sem alerta, pra eu saber que ele rodou.

ALERTAS (com os limites num arquivo de configuração, pra eu ajustar sem mexer no código)
- "gastou zero": ontem não gastou nada e a média dos 30 dias é maior que zero.
- "gasto X% acima da média": ontem gastou mais de 50% acima da média.
- "gasto sem conversão": gastou ontem, teve zero conversão e a média é de pelo menos 1 por dia.
- Site fora do ar: diga se não abriu, se respondeu com erro ou se está sem o texto esperado.
- "não consegui ler": se uma conta der erro, diga qual e o motivo, sem mostrar token, e continue com as outras.
- "saldo acabando": mostre o saldo de cada conta e pra quantos dias ele dá no ritmo de gasto atual, e me avise quando estiver perto de acabar (me pergunte a partir de quantos dias).

REGRAS
- Só leitura: o vigia nunca pausa, cria, edita nem muda verba. Use só chamadas de leitura e crie um teste que falha se o código usar qualquer função de escrita.
- Segredos só no arquivo .env (fora do Git) e nos Secrets do GitHub. Nunca me peça pra colar token aqui no chat e nunca mostre o conteúdo do .env.
- Modo ensaio: um comando que monta a mensagem e só mostra na tela, sem enviar.
- Um comando que descobre o número do meu chat no Telegram (eu já mandei "oi" pro bot).

ONDE RODA (tudo no plano grátis)
- GitHub Actions, num repositório privado, com um botão de rodar na mão que já vem com o ensaio marcado.
- Um Worker do Cloudflare com cron que aperta esse botão às [7h40] com o ensaio desmarcado, porque o agendamento do GitHub atrasa. Se não conseguir disparar, ele me avisa no Telegram.
- O agendamento do GitHub fica de reserva às [8h30] e só roda se o Worker não tiver disparado no dia.

COMO TRABALHAR
Primeiro me mostre o plano em tarefas curtas e espere o meu ok. Depois faça uma tarefa por vez, com testes. No fim, me passe o passo a passo do que eu preciso fazer em cada site (Telegram, Meta, Google, GitHub e Cloudflare).

Ele vai te mostrar um plano, esperar o seu ok e fazer uma parte por vez. Quando ele pedir alguma coisa de um site (um ID de conta, uma permissão), ele te diz onde clicar.

Pronto quando: os testes passam e o Claude te entregou o comando do modo ensaio.

4. Teste em modo ensaio

• Peça pro Claude rodar o comando que descobre o número do seu chat no Telegram e cole esse número no .env.
• Rode o vigia em modo ensaio: a mensagem aparece na tela e nada é enviado.
• Abra o Gerenciador de Anúncios (e o Google Ads) no dia de ontem e compare o gasto e as conversões com o que saiu no ensaio. Antes de confiar, confira 3 dias diferentes.

Pronto quando: os números do ensaio batem com os do Gerenciador.

5. Coloque no GitHub pra rodar sem o seu computador

• Crie um repositório privado no GitHub e peça pro Claude subir o código. O .env fica de fora.
• No GitHub, vá em Settings › Secrets and variables › Actions e crie um segredo pra cada linha do .env. Você digita os valores no site, nunca no chat.
• Em Actions, rode o vigia na mão com o ensaio marcado e leia a mensagem no log (o registro da execução).

Pronto quando: a execução em ensaio no GitHub mostra a mesma mensagem que saiu no seu computador.

6. Coloque o relógio do Cloudflare

Por que um relógio separado: o agendamento do GitHub atrasa. Já vi um horário marcado pras 7h50 sair às 14h09. O agendador do Cloudflare é pontual, então eu uso um Worker (um programinha que roda na nuvem do Cloudflare) que só aperta o botão de rodar do GitHub às 7h40. O agendamento do próprio GitHub fica de reserva às 8h30 e só roda se o relógio falhar.

• O Worker precisa de um token do GitHub com uma permissão só: Actions, leitura e escrita, nesse repositório.
• Grave os segredos do Worker pelo comando que o Claude te passar. No Windows, colar com Ctrl+V no terminal já gravou um caractere invisível no lugar do segredo: peça um comando que leia direto da área de transferência.
• O Cloudflare conta o horário em UTC, 3 horas na frente de Brasília: 7h40 aqui é 10h40 lá. O Claude faz essa conta, mas vale conferir.

Pronto quando: o Worker está publicado e um disparo de teste dele apareceu no Actions do GitHub.

7. Ligue

• No Actions, rode o vigia na mão com o ensaio desmarcado. A mensagem chega no seu Telegram.
• A partir daí ele roda sozinho todo dia. Nos primeiros dias, veja se os alertas fazem sentido: se vier alerta demais de gasto alto, suba o limite de 50% no arquivo de configuração.

Pronto quando: a primeira mensagem de verdade chegou no seu Telegram.

Os alertas que ele dá

Quando alguma coisa foge do normal, a linha da conta ganha um sinal de alerta com o motivo. São estes, com o que eu confiro primeiro em cada um:

gastou zero

• Quando aparece: ontem a conta não gastou nada, e ela costuma gastar (a média dos 30 dias é maior que zero).
• O que eu confiro primeiro: pagamento e saldo, anúncio reprovado e orçamento.

saldo acabando

• Quando aparece: o saldo da conta dá pra poucos dias no ritmo de gasto de agora. A linha mostra o saldo e quantos dias ele ainda cobre.
• O que eu confiro primeiro: se a recarga já foi feita e, se não, aviso antes de a conta parar.

gasto X% acima da média

• Quando aparece: ontem gastou mais de 50% acima da média dos 30 dias. Esse limite dá pra ajustar por conta.
• O que eu confiro primeiro: foi de propósito? Mudou o público ou o lance?

gasto sem conversão

• Quando aparece: gastou ontem e não teve nenhuma conversão, numa conta que costuma ter pelo menos 1 por dia.
• O que eu confiro primeiro: o rastreamento (o código que conta as conversões), a página e o WhatsApp.

site fora do ar

• Quando aparece: o site não abriu, respondeu com erro ou não mostra o texto que tem que estar lá. O alerta diz qual dos três.
• O que eu confiro primeiro: hospedagem e domínio.

não consegui ler

• Quando aparece: a plataforma recusou a leitura daquela conta, por token vencido ou falta de permissão. O erro de uma conta não derruba as outras.
• O que eu confiro primeiro: o acesso daquela conta: gero o token de novo ou refaço a autorização.

Ele avisa e quem decide sou eu. Nenhum alerta mexe na conta sozinho: eu leio, confiro e escolho o que fazer.

Dá pra adaptar pro seu negócio

O vigia das contas de anúncio é só um exemplo. O mesmo jeito serve pra qualquer número que você confere todo dia:

• Restaurante: como foram as vendas do dia anterior.
• Clínica: quantos contatos chegaram ontem.
• Site: quantos acessos ele teve.
• Instagram: quantas visualizações o seu Reel teve.

A regra é uma só: se o sistema que você usa tem uma API, dá pra conectar uma IA nele. Antes de começar, procure "API" ou "integrações" na ajuda do sistema. Se ele não tiver, o Claude fica sem ter por onde ler.

Pra adaptar, comece por este pedido e depois use o prompt do passo 3 como modelo pras regras e pro agendamento:

Quero um vigia que leia [o sistema de vendas / a agenda da clínica / o Instagram] todo dia às [horário], pegue [o número que eu quero acompanhar] de ontem, compare com a média dos 30 dias anteriores e me mande um resumo no Telegram. Ele só lê e nunca altera nada no sistema. Primeiro descubra se esse sistema tem API e o que eu preciso pra ter acesso de leitura, e me explique em português simples.

Perguntas e limites

Preciso saber programar?

Não. Você precisa saber o que quer que ele confira e seguir os passos. Quem escreve e testa o código é o Claude. O que dá mais trabalho é pegar os acessos das plataformas.

Ele pode gastar meu dinheiro ou mexer na campanha?

Do jeito que está aqui, ele só lê. O token do Meta só tem permissão de leitura, o código usa só consultas de leitura e o prompt pede um teste que falha se alguém colocar uma função que escreve na conta.

E se um dia a mensagem não chegar?

É o sinal de que algo quebrou, por isso ela chega até nos dias sem alerta. O GitHub manda e-mail quando a execução falha, e o relógio do Cloudflare avisa no Telegram quando não consegue disparar.

Dá pra fazer com outra IA?

Eu monto com o Claude, no Claude Code, porque ele cria os arquivos e roda os testes no meu computador. Se a IA que você usa faz isso também, o mesmo prompt serve de ponto de partida.