تكامل Stripe + Brevo
Stripe + Brevo
اربط بيانات الدفع في Stripe بطبقة التفاعل في Brevo. كل حدث دفع, إنشاء اشتراك، فشل دفع، إصدار استرداد, يصبح محفزاً للرسائل الموجهة.
خوادم MCP المستخدمة
| الخادم | الحزمة | المصادقة | الغرض |
|---|---|---|---|
| Stripe MCP | @stripe/mcp | مفتاح API | المدفوعات، الاشتراكات، العملاء، الفواتير، المنتجات، قاعدة المعرفة |
| Brevo MCP | mcp.brevo.com/v1/brevo/mcp | Token | جهات الاتصال، البريد الإلكتروني، SMS، WhatsApp، الحملات، تتبع الأحداث |
الإعداد
الخطوة 1: توصيل كلا خادمي 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" } } }}الخطوة 2: التحقق
> أظهر لي اشتراكات Stripe التي أُنشئت هذا الأسبوع> اعرض قوالب البريد الإلكتروني في Brevoحالة الاستخدام 1: وكيل حملة أحداث الدفع
ربط أحداث Stripe بتفاعل 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---
# Payment Event Campaign Agent
Listen for Stripe payment events and trigger the appropriateBrevo engagement campaign.
## Event-to-Campaign Mapping
| Stripe Event | Brevo Action | Timing ||-------------|-------------|--------|| `payment_intent.succeeded` | Send receipt + thank you email | Immediate || `invoice.payment_failed` | Send payment failed email + SMS | Immediate || `invoice.payment_failed` (2nd attempt) | Send urgent SMS with update link | +24h || `customer.subscription.created` | Welcome sequence (3 emails over 7 days) | Immediate || `customer.subscription.updated` | Plan change confirmation email | Immediate || `customer.subscription.deleted` | Cancellation survey + win-back sequence | Immediate + 7 days || `charge.refunded` | Refund confirmation + feedback request | Immediate || `invoice.upcoming` | Renewal reminder with usage summary | 3 days before |
## Failed Payment Recovery
Critical revenue recovery flow:
1. **Attempt 1 fails**: Email with "Update payment method" CTA2. **+24 hours**: SMS with direct link to billing portal3. **+72 hours**: Email from founder: "We don't want to lose you"4. **+7 days (final)**: Last chance email with grace period deadline
## Rules- ALWAYS sync Stripe customer email to Brevo before sending- NEVER expose full payment details in emails (last 4 digits only)- Track events: stripe_payment_email_sent, stripe_recovery_success- For failed payments, stop sequence immediately if payment succeedsحالة الاستخدام 2: وكيل دورة حياة الاشتراك
إدارة رحلة الاشتراك الكاملة:
---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 * * *"---
# Subscription Lifecycle Agent
Daily check of subscription states to drive engagement:
## Daily Tasks
1. **New subscriptions (last 24h)** - Create/update Brevo contact with plan details - Add to plan-specific segment - Trigger onboarding sequence
2. **Renewals coming (next 7 days)** - Send renewal reminder with usage summary - For annual plans: send "year in review" email
3. **Trials expiring (next 3 days)** - Send trial-to-paid conversion email - SMS reminder on last day
4. **Recently churned (last 7 days)** - Add to win-back segment - Schedule win-back sequence (day 7, 14, 30)
## Brevo Attributes from Stripe
| Stripe Data | Brevo Attribute ||------------|-----------------|| subscription.plan.name | PLAN_NAME || subscription.current_period_end | RENEWAL_DATE || subscription.status | SUBSCRIPTION_STATUS || customer.currency | CURRENCY || invoice.amount_paid (sum) | LIFETIME_REVENUE || subscription.created | SUBSCRIPTION_START |
## Rules- ALWAYS use customer's currency when displaying amounts- Segment by plan tier for differentiated messaging- Track MRR impact of each campaign for ROI reportingمثال: التنسيق في الوقت الفعلي
أنت: "أرى أنه كان لدينا 5 مدفوعات فاشلة اليوم. تحقق أيها من عملاء الاشتراك وابدأ تسلسل الاسترداد."
Claude: جارٍ التحقق من Stripe للمدفوعات الفاشلة اليوم...[يستخدم Stripe MCP لسرد الفواتير الفاشلة الأخيرة]
وجدت 5 مدفوعات فاشلة:- 3 من عملاء الاشتراك (خطط شهرية)- 2 من المدفوعات الفردية
لعملاء الاشتراك الثلاثة:[يستخدم brevo_contacts للتحقق من وجود جهات الاتصال][يستخدم brevo_email_campaign_management لإرسال بريد الدفع الفاشل][يستخدم brevo_sms_campaigns لجدولة متابعات SMS بعد +24 ساعة]
بدأ تسلسل الاسترداد لـ3 عملاء:- [email protected], خطة Pro ($49/شهر), تم إرسال البريد- [email protected], خطة Business ($99/شهر), تم إرسال البريد- [email protected], خطة Pro ($49/شهر), تم إرسال البريد- متابعات SMS مجدولة لغد إذا لم تُحَلالخطوات التالية
- Shopify + Brevo, تكامل التجارة الإلكترونية
- HubSpot + Brevo, تكامل CRM
- API مخصص + Brevo, ابنِ موصّلك الخاص