Automatize seu resumo de MRR do Stripe com um agente de IA no Telegram

Você já abre o Stripe toda manhã. Pare de abrir o dashboard.

Se você toca um SaaS pequeno, a primeira coisa que faz quase toda manhã é abrir o Stripe. Olha os mesmos três ou quatro números. MRR. Novas assinaturas da noite. Cancelamentos. Às vezes pagamentos falhos. Depois fecha a aba e começa o dia.

Os dashboards que prometem resolver isso custam dinheiro de verdade. O Baremetrics Metrics custa $208 por mês pelo produto de analytics avulso. O ChartMogul é grátis abaixo de $10K de MRR, depois pula para $100 por mês no plano Scale e adiciona $25 por mês a cada $10K de MRR que você cruza. Ambos enviam um resumo por email ou Slack. Ambos também entregam uma matriz de coortes de churn, um modelo de forecast, um fluxo de dunning e outras dez funcionalidades que você não usa.

Se a única coisa que você quer é "o que mudou no Stripe durante a noite, em uma mensagem, às 9h" você está pagando de $108 a $474 por mês pelo produto errado. O que você quer é um relatório diário, não uma suíte de analytics. São dois problemas diferentes e o segundo se resolve em uma tarde com um agente de IA no Telegram, uma chave Stripe somente leitura e uma única tarefa agendada.

O que um resumo do Stripe realmente útil contém

Antes de automatizar qualquer coisa, escreva o resumo que você gostaria de receber ao acordar. Para um SaaS bootstrapped o conjunto útil é pequeno:

• MRR agora, e o delta em relação a 24 horas atrás. Um único número de manchete com seu sinal.
• Novas assinaturas pagas durante a noite. Plano, email do cliente, contribuição ao MRR.
• Cancelamentos durante a noite. Plano, email do cliente, MRR que você acabou de perder.
• Mudanças de plano. Upgrades e downgrades que se compensam em MRR de expansão e contração.
• Pagamentos falhos que merecem atenção. Qualquer um acima de $50, ou em cliente com mais de 3 meses.
• Uma linha de contexto. "Líquido +$47 de MRR, expansão superou churn 3 a 1, maior movimento foi a Acme indo para Pro" soa muito diferente de uma lista de números.

Isso é uma mensagem de 10 linhas. Você não precisa de um dashboard de $208. Precisa de uma chave Stripe somente leitura, um chat do Telegram e uma única tarefa agendada para rodar às 9h no horário local.

A receita: uma skill, uma tarefa diária, uma chave somente leitura

O truque é manter o escopo bem pequeno. Você não precisa recalcular o MRR a partir de eventos invoice.payment_succeeded. Não precisa de um banco de dados consultável. Precisa de um único resumo diário, escrito pelo agente, entregue no seu celular.

Passo 1: crie uma chave Stripe somente leitura

Esse é o passo de segurança mais importante. As chaves restritas do Stripe permitem conceder permissão Read em recursos específicos e None em todo o resto. Para um resumo de MRR você só precisa de leitura em:

• Assinaturas
• Clientes
• Faturas
• Preços e produtos

Deixe None em todo o resto. A chave não pode criar cobranças, não pode reembolsar, não pode modificar uma assinatura, não pode ler dados da sua plataforma Connect. Se a chave vazar, o pior que um atacante consegue é ver os mesmos números que você vê. O Stripe recomenda explicitamente chaves restritas no lugar de chaves secretas, principalmente quando se entrega a chave para um agente de IA.

Guarde a chave nos secrets do seu agente, nunca em código, nunca em um prompt. O Hermes Agent criptografa os secrets em repouso e nunca os expõe ao modelo.

Passo 2: escreva uma pequena skill stripe-reader

A skill é um wrapper fino sobre a API do Stripe que devolve um único bloco JSON por manhã:

# skills/stripe-reader/main.py
import stripe, os, datetime as dt

stripe.api_key = os.environ["STRIPE_RESTRICTED_KEY"]
since = int((dt.datetime.now(dt.timezone.utc) - dt.timedelta(hours=24)).timestamp())

# MRR ativo agora
active = stripe.Subscription.list(status="active", limit=100, expand=["data.items"])
mrr_now = sum(_monthly_normalize(item) for sub in active.auto_paging_iter() for item in sub["items"]["data"])

# Eventos das últimas 24 horas que afetam o MRR
new_subs = list(stripe.Subscription.search(query=f"status:'active' AND created>{since}").auto_paging_iter())
canceled = list(stripe.Subscription.search(query=f"canceled_at>{since}").auto_paging_iter())
plan_changes = list(stripe.Event.list(type="customer.subscription.updated", created={"gte": since}).auto_paging_iter())

return {
  "mrr_now_cents": mrr_now,
  "new_subs": [_pluck(s) for s in new_subs],
  "canceled": [_pluck(s) for s in canceled],
  "plan_changes": [_pluck_event(e) for e in plan_changes],
  "failed_payments": _list_recent_failed_invoices(since),
}

Duas observações sobre as contas. Primeira, a definição de MRR do próprio Stripe é a soma dos valores normalizados para mensal de todas as assinaturas ativas, então um plano anual de $290 contribui com $24,17 ao MRR, não $290 (documentação de MRR do Stripe). Segunda, um cancelamento só deixa de contar para o MRR quando expira, não no momento em que o cliente clica em Cancelar - então "cancelamentos da noite" no seu resumo precisa incluir tanto eventos canceled_at quanto eventos current_period_end que caíram nas últimas 24 horas.

Esse é exatamente o tipo de detalhe que torna calcular MRR a partir de dados crus do Stripe complicado quando você tenta construir um pipeline de analytics completo. Para um resumo único por dia, dá para ser um pouco impreciso - os dashboards aos quais seus olhos estão calibrados fazem o mesmo.

Passo 3: uma tarefa agendada às 9h

Dê ao seu Hermes Agent uma única linha de cron em linguagem natural:

todo dia útil às 9h no horário de Madrid, execute a skill
stripe-reader e me envie um resumo no Telegram. Manchete:
MRR agora e delta em relação a ontem. Depois liste novas
assinaturas, cancelamentos, mudanças de plano e pagamentos
falhos acima de $50. Termine com uma linha de contexto sobre
o que dominou o dia.

Esse é o prompt inteiro. O agente chama a skill, recebe o JSON, escreve a mensagem e envia para o seu chat do Telegram. Com enabled_toolsets=["stripe-reader","telegram"] restrito a essa tarefa, o LLM só enxerga os números que precisa e a ferramenta para enviar ao Telegram - não consegue chamar nada mais por acidente. É o mesmo padrão que usamos no guia do resumo de cripto e no manual de tarefas agendadas para o Hermes Agent.

Por que a camada de agente vale o que custa

Um relatório plano poderia ser resolvido por um script Python de 50 linhas. A razão de colocar um agente na frente é a linha de contexto no fim da mensagem.

Um relatório seco diz:

MRR $4.217. +$47 vs ontem. 2 novas assinaturas. 1 cancelamento. 3 mudanças de plano. 1 pagamento falho.

Um relatório contextual diz:

MRR $4.217 (+$47, +1,1%). Expansão venceu o churn 3 a 1 - Acme subiu de Starter para Pro ($30 de MRR), Beta Co adicionou um assento ($10). Um cancelamento no Starter ($19) citou "vou para o Notion AI" na pesquisa de saída. Líquido +$47, segundo melhor dia do mês.

Mesmos números, mensagem muito diferente. O primeiro você lê por cima. O segundo é algo sobre o qual você consegue agir - pode escrever para o cliente que cancelou, agradecer a Acme pela subida, ou checar se essa razão de saída está aparecendo em outros cancelamentos. Essa camada de diagnóstico é o que custa $108 por mês no Baremetrics e é o que um pequeno agente de IA te dá pelo preço de um VPS barato mais seu próprio consumo de modelo.

Quanto isso custa

Contas honestas para um SaaS bootstrapped na faixa de $0 a $10K de MRR:

| Ferramenta | Custo mensal | O que você ganha | |---|---|---| | Baremetrics Metrics | $208 | Suite de analytics completa, resumo semanal por email | | ChartMogul Scale | $100 + $25 por +$10K MRR | Suite de analytics completa, alertas configuráveis | | ProfitWell | $0 base | Métricas grátis limitadas, upsell para Recover e Retain | | Hermes Agent + Hermify Starter | $19/mês + ~$2 de consumo de modelo | Um resumo no Telegram às 9h, controle total da chave somente leitura e do prompt |

Você não recebe curvas de retenção por coorte, não recebe um dashboard público, não recebe um fluxo de dunning. Você recebe o único relatório que de fato abre e o recebe no celular antes mesmo de sentar. Para a maioria dos fundadores bootstrapped abaixo de $10K de MRR, esse é o trabalho inteiro.

Se você cruzar $10K de MRR e começar a precisar da peça de dunning, dá para manter o agente para o resumo diário e adicionar o ChartMogul Launch (grátis abaixo de $10K) ou uma ferramenta focada no gap específico. O agente não te prende.

Como começar

O setup completo é:

1. Crie uma chave restrita do Stripe com leitura em assinaturas, clientes, faturas, preços e produtos. None em tudo mais.
2. Coloque a chave nos secrets do seu Hermes Agent.
3. Adicione a skill stripe-reader - você pode escrever a sua ou reaproveitar o repositório público de skills do Hermes.
4. Adicione uma linha de cron em linguagem natural.
5. Confirme que o primeiro resumo chega no Telegram às 9h.

Se você quer o stack inteiro hospedado, monitorado e em um bot do Telegram gerenciado, comece com o Hermify no plano Starter de $19/mês. Você traz sua chave de modelo e sua chave Stripe somente leitura, nós rodamos o runtime, o cron e o bot. O mesmo padrão funciona para resumos de cripto, monitoramento de concorrentes e o resto do cluster de automação que publicamos no último mês.

O dashboard que você abre toda manhã custa $108. O dashboard que vem até você custa $19.

Sources

• Calculating MRR in Stripe Billing - Stripe Help & Support
• Impact of subscription cancellations on MRR - Stripe Help & Support
• Common events that affect MRR totals - Stripe Help & Support
• Restricted API keys - Stripe Documentation
• Best practices for managing secret API keys - Stripe Documentation
• ChartMogul vs Baremetrics vs MRR.io pricing - Baremetrics blog
• ChartMogul pricing on G2
• Calculating MRR from raw Stripe data is tricky - Steven Wang on Medium