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

ServidorPacoteAutenticaçãoPropósito
Stripe MCP@stripe/mcpChave de APIPagamentos, subscrições, clientes, faturas, produtos, base de conhecimento
Brevo MCPmcp.brevo.com/v1/brevo/mcpTokenContactos, 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 Brevo

Caso de Uso 1: Agente de Campanha por Evento de Pagamento

Mapeie eventos Stripe para envolvimento Brevo:

---
name: stripe-payment-campaigns
description: Trigger Brevo campaigns from Stripe payment events
version: 1.0.0
temperature: 0.2
tools:
- stripe
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
triggers:
- 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 de
envolvimento 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ção
3. **+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 sucesso

Caso de Uso 2: Agente de Ciclo de Vida de Subscrição

Gira o percurso completo de subscrição:

---
name: stripe-subscription-lifecycle
description: Manage subscription engagement from signup through renewal
version: 1.0.0
temperature: 0.3
tools:
- stripe
- brevo_contacts
- brevo_email_campaign_management
- brevo_segments
- brevo_templates
triggers:
- 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 ROI

Exemplo: 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 enviados

Próximos Passos

Assistente AI

Olá! Pergunte-me qualquer coisa sobre a documentação.

Comece grátis com Brevo