نظرة عامة
مكّن وكلاءك من إدارة المدفوعات والاشتراكات وفواتير العملاء عبر Stripe. تعامل مع بيانات العملاء، ومعالجة الاشتراكات، وإدارة المنتجات، وتتبع المعاملات المالية لتبسيط سير عمل المدفوعات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Stripe، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Stripe بصلاحيات API المناسبة
- ربط حساب Stripe الخاص بك عبر صفحة التكاملات
إعداد تكامل Stripe
1. ربط حساب Stripe الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Stripe في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لمعالجة المدفوعات
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الأدوات المتاحة
إدارة العملاء
stripe/create_customer
stripe/create_customer
الوصف: إنشاء عميل جديد في حساب Stripe.المعاملات:
emailCreateCustomer(string, مطلوب): عنوان البريد الإلكتروني للعميلname(string, اختياري): الاسم الكامل للعميلdescription(string, اختياري): وصف العميل للمرجع الداخلي
stripe/get_customer_by_id
stripe/get_customer_by_id
الوصف: استرجاع عميل محدد بواسطة معرّف عميل Stripe.المعاملات:
idGetCustomer(string, مطلوب): معرّف عميل Stripe المراد استرجاعه
stripe/get_customers
stripe/get_customers
الوصف: استرجاع قائمة العملاء مع تصفية اختيارية.المعاملات:
emailGetCustomers(string, اختياري): تصفية العملاء حسب البريد الإلكترونيlimitGetCustomers(string, اختياري): الحد الأقصى لعدد العملاء (الافتراضي: 10)
stripe/update_customer
stripe/update_customer
الوصف: تحديث معلومات عميل موجود.المعاملات:
customerId(string, مطلوب): معرّف العميل المراد تحديثهemailUpdateCustomer(string, اختياري): عنوان البريد الإلكتروني المحدّثname(string, اختياري): اسم العميل المحدّث
إدارة الاشتراكات
stripe/create_subscription
stripe/create_subscription
الوصف: إنشاء اشتراك جديد لعميل.المعاملات:
customerIdCreateSubscription(string, مطلوب): معرّف العميل الذي سيُنشأ له الاشتراكplan(string, مطلوب): معرّف خطة الاشتراك
stripe/get_subscriptions
stripe/get_subscriptions
الوصف: استرجاع الاشتراكات مع تصفية اختيارية.المعاملات:
customerIdGetSubscriptions(string, اختياري): تصفية الاشتراكات حسب معرّف العميلsubscriptionStatus(string, اختياري): تصفية حسب حالة الاشتراك - الخيارات: incomplete, trialing, active, past_due, canceled, unpaid
إدارة المنتجات
stripe/create_product
stripe/create_product
الوصف: إنشاء منتج جديد في كتالوج Stripe.المعاملات:
productName(string, مطلوب): اسم المنتجdescription(string, اختياري): وصف المنتج
stripe/get_products
stripe/get_products
الوصف: استرجاع قائمة المنتجات مع تصفية اختيارية.المعاملات:
limitGetProducts(string, اختياري): الحد الأقصى لعدد المنتجات (الافتراضي: 10)
العمليات المالية
stripe/get_balance_transactions
stripe/get_balance_transactions
الوصف: استرجاع معاملات الرصيد من حساب Stripe.المعاملات:
balanceTransactionType(string, اختياري): تصفية حسب نوع المعاملة - الخيارات: charge, refund, payment, payment_refund
stripe/get_plans
stripe/get_plans
الوصف: استرجاع خطط الاشتراك من حساب Stripe.المعاملات:
isPlanActive(boolean, اختياري): تصفية حسب حالة الخطة
أمثلة الاستخدام
إعداد Agent أساسي لـ Stripe
مرجع حالات الاشتراك
فهم حالات الاشتراك:- incomplete - الاشتراك يتطلب طريقة دفع أو تأكيد الدفع
- trialing - الاشتراك في فترة تجريبية
- active - الاشتراك نشط وحالي
- past_due - فشل الدفع لكن الاشتراك لا يزال نشطاً
- canceled - تم إلغاء الاشتراك
- unpaid - فشل الدفع والاشتراك لم يعد نشطاً
