⏰ Automations: Agentes Recorrentes

Prompt único = você dispara, agente faz, acabou. Automation = agente acorda sozinho em horário/evento, sem você lembrar. Confundir os dois é o erro de design mais comum — e o mais caro.

Quatro automations que pagam mensalidade por si só. Cada uma é vendável como add-on do seu micro-SaaS ou serviço avulso recorrente.

Automation versionada é auditável e reproduzível. Use YAML no repo, env vars para secrets, dry-run antes de ativar. Sem isso, vira "magia que só você sabe configurar" — e morre quando você sai de férias.

name: relatorio-semanal-vendas
description: Gera PDF com vendas da semana e envia por e-mail.

trigger:
  type: cron
  schedule: "0 9 * * MON"   # toda segunda 09:00
  timezone: America/Sao_Paulo

inputs:
  cliente_id: "{{ secrets.CLIENTE_ID }}"
  periodo_dias: 7

steps:
  - id: fetch
    run: |
      codex run "Busque vendas dos ultimos {{ periodo_dias }} dias
      do cliente {{ cliente_id }} no Convex e agrupe por produto."

  - id: render
    run: |
      codex run "Renderize relatorio em PDF usando template
      ./templates/vendas.html com os dados de {{ steps.fetch.output }}."

  - id: send
    run: |
      codex run "Envie {{ steps.render.output }} por e-mail
      para {{ secrets.EMAIL_DESTINO }} com assunto 'Vendas semanais'."

budget:
  max_cost_per_run_brl: 8
  max_runs_per_month: 5

on_failure:
  notify: slack://#alerts

Cron mal configurado dispara em horário errado, polui logs e gera complaint do cliente. Conhecer minimamente timezone, jitter e retries elimina 90% dos incidentes.

┌──── minuto (0-59)
│ ┌── hora   (0-23)
│ │ ┌─ dia mes (1-31)
│ │ │ ┌─ mes  (1-12)
│ │ │ │ ┌─ dia semana (0-6, 0=DOM)
│ │ │ │ │
0 9 * * MON   → toda segunda 09:00
*/15 * * * *  → a cada 15 minutos
0 22 * * SUN  → domingo 22:00
0 8 1-5 * *   → 08:00 dos dias 1 a 5 do mes

Sem monitoramento, automation que falha 3 dias seguidos te queima com cliente. Com logs estruturados, alerta no Slack e fallback graceful, você corrige antes do cliente perceber.

// scripts/notify-slack.js
const fetch = require('node-fetch');

async function notifySlack(automation, status, error) {
  const color = status === 'error' ? '#dc2626' : '#16a34a';
  const payload = {
    attachments: [{
      color,
      title: `[${status.toUpperCase()}] ${automation}`,
      fields: [
        { title: 'Cliente', value: process.env.CLIENTE_ID, short: true },
        { title: 'Horário', value: new Date().toISOString(), short: true },
        { title: 'Erro', value: error || '—', short: false }
      ],
      footer: 'Codex Automations'
    }]
  };
  await fetch(process.env.SLACK_WEBHOOK, {
    method: 'POST',
    body: JSON.stringify(payload)
  });
}

module.exports = notifySlack;

try {
  const report = await generateReport();
  await sendEmail(report);
  await cache.save('last_good', report);
} catch (err) {
  await notifySlack('relatorio-semanal', 'error', err.message);
  const lastGood = await cache.load('last_good');
  await sendEmail({ ...lastGood, notice: 'Dados da semana anterior — atualização em andamento' });
}

Cliente paga R$ 800/mês. Se a automation custar R$ 1.000 em tokens, é prejuízo. Calibrar budget é matemática direta de margem, não detalhe técnico.