Integração Stripe + Brevo
Stripe + Brevo
Ligue os dados de pagamento do Stripe à camada de envolvimento do Brevo. Cada evento de pagamento, subscrição criada, pagamento falhado, reembolso emitido, torna-se um acionador para mensagens direcionadas.
Servidores MCP Utilizados
| Servidor | Pacote | Autenticação | Propósito |
|---|---|---|---|
| Stripe MCP | @stripe/mcp | Chave de API | Pagamentos, subscrições, clientes, faturas, produtos, base de conhecimento |
| Brevo MCP | mcp.brevo.com/v1/brevo/mcp | Token | Contactos, e-mail, SMS, WhatsApp, campanhas, rastreamento de eventos |
Configuração
Passo 1: Ligar Ambos os Servidores MCP
{ "mcpServers": { "stripe": { "command": "npx", "args": ["-y", "@stripe/mcp"], "env": { "STRIPE_SECRET_KEY": "sk_live_your-stripe-key" } }, "brevo": { "command": "npx", "args": [ "mcp-remote", "https://mcp.brevo.com/v1/brevo/mcp", "--header", "Authorization: Bearer ${BREVO_MCP_TOKEN}" ], "env": { "BREVO_MCP_TOKEN": "your-brevo-mcp-token" } } }}Passo 2: Verificar
> Mostre-me as subscrições Stripe criadas esta semana> Liste os meus templates de e-mail BrevoCaso de Uso 1: Agente de Campanha por Evento de Pagamento
Mapeie eventos Stripe para envolvimento Brevo:
---name: stripe-payment-campaignsdescription: Trigger Brevo campaigns from Stripe payment eventsversion: 1.0.0temperature: 0.2tools: - stripe - brevo_contacts - brevo_email_campaign_management - brevo_templates - brevo_sms_campaignstriggers: - event: payment_intent.succeeded - event: invoice.payment_failed - event: customer.subscription.created - event: customer.subscription.deleted - event: charge.refunded---
# Agente de Campanha por Evento de Pagamento
Escute eventos de pagamento Stripe e acione a campanha deenvolvimento Brevo adequada.
## Mapeamento de Evento para Campanha
| Evento Stripe | Ação Brevo | Timing ||--------------|-----------|--------|| `payment_intent.succeeded` | Enviar recibo + e-mail de agradecimento | Imediato || `invoice.payment_failed` | Enviar e-mail de pagamento falhado + SMS | Imediato || `invoice.payment_failed` (2.ª tentativa) | Enviar SMS urgente com link de atualização | +24h || `customer.subscription.created` | Sequência de boas-vindas (3 e-mails em 7 dias) | Imediato || `customer.subscription.updated` | E-mail de confirmação de mudança de plano | Imediato || `customer.subscription.deleted` | Inquérito de cancelamento + sequência win-back | Imediato + 7 dias || `charge.refunded` | Confirmação de reembolso + pedido de feedback | Imediato || `invoice.upcoming` | Lembrete de renovação com resumo de utilização | 3 dias antes |
## Recuperação de Pagamentos Falhados
Fluxo crítico de recuperação de receita:
1. **Falha da Tentativa 1**: E-mail com CTA "Atualizar método de pagamento"2. **+24 horas**: SMS com link direto para portal de faturação3. **+72 horas**: E-mail do fundador: "Não queremos perder-vos"4. **+7 dias (final)**: Último e-mail com prazo limite do período de graça
## Regras- SEMPRE sincronizar e-mail do cliente Stripe para o Brevo antes de enviar- NUNCA expor detalhes completos de pagamento em e-mails (apenas últimos 4 dígitos)- Rastrear eventos: stripe_payment_email_sent, stripe_recovery_success- Para pagamentos falhados, parar sequência imediatamente se o pagamento tiver sucessoCaso de Uso 2: Agente de Ciclo de Vida de Subscrição
Gira o percurso completo de subscrição:
---name: stripe-subscription-lifecycledescription: Manage subscription engagement from signup through renewalversion: 1.0.0temperature: 0.3tools: - stripe - brevo_contacts - brevo_email_campaign_management - brevo_segments - brevo_templatestriggers: - schedule: "0 8 * * *"---
# Agente de Ciclo de Vida de Subscrição
Verificação diária de estados de subscrição para impulsionar o envolvimento:
## Tarefas Diárias
1. **Novas subscrições (últimas 24h)** - Criar/atualizar contacto Brevo com detalhes do plano - Adicionar ao segmento específico do plano - Acionar sequência de onboarding
2. **Renovações em breve (próximos 7 dias)** - Enviar lembrete de renovação com resumo de utilização - Para planos anuais: enviar e-mail "ano em revisão"
3. **Testes a expirar (próximos 3 dias)** - Enviar e-mail de conversão de teste para pago - Lembrete SMS no último dia
4. **Cancelamentos recentes (últimos 7 dias)** - Adicionar ao segmento win-back - Agendar sequência win-back (dia 7, 14, 30)
## Atributos Brevo do Stripe
| Dados Stripe | Atributo Brevo ||-------------|-----------------|| subscription.plan.name | PLAN_NAME || subscription.current_period_end | RENEWAL_DATE || subscription.status | SUBSCRIPTION_STATUS || customer.currency | CURRENCY || invoice.amount_paid (soma) | LIFETIME_REVENUE || subscription.created | SUBSCRIPTION_START |
## Regras- SEMPRE usar a moeda do cliente ao apresentar valores- Segmentar por nível de plano para mensagens diferenciadas- Rastrear impacto MRR de cada campanha para relatórios de ROIExemplo: Orquestração em Tempo Real
Utilizador: "Vejo que tivemos 5 pagamentos falhados hoje. Verifique quais são clientes de subscrição e inicie a sequência de recuperação."
Claude: A verificar o Stripe para pagamentos falhados hoje...[Usa stripe MCP para listar faturas falhadas recentes]
Encontrei 5 pagamentos falhados:- 3 são clientes de subscrição (planos mensais)- 2 são pagamentos únicos
Para os 3 clientes de subscrição:[Usa brevo_contacts para verificar se os contactos existem][Usa brevo_email_campaign_management para enviar e-mail de pagamento falhado][Usa brevo_sms_campaigns para agendar follow-ups SMS para +24h]
Sequência de recuperação iniciada para 3 clientes:- [email protected], Plano Pro ($49/mês), e-mail enviado- [email protected], Plano Business ($99/mês), e-mail enviado- [email protected], Plano Pro ($49/mês), e-mail enviado- Follow-ups SMS agendados para amanhã se não resolvido
Para os 2 pagamentos únicos:[Usa brevo_email_campaign_management para enviar e-mail de retentar pagamento]- E-mails de nova tentativa simples enviadosPróximos Passos
- Shopify + Brevo, Integração de e-commerce
- HubSpot + Brevo, Integração CRM
- API Personalizada + Brevo, Construa o seu próprio conector