تكامل Stripe

نظرة عامة

مكّن وكلاءك من إدارة المدفوعات والاشتراكات وفواتير العملاء عبر Stripe. تعامل مع بيانات العملاء، ومعالجة الاشتراكات، وإدارة المنتجات، وتتبع المعاملات المالية لتبسيط سير عمل المدفوعات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

المتطلبات الأساسية

قبل استخدام تكامل Stripe، تأكد من توفر ما يلي:

• حساب CrewAI AMP مع اشتراك فعّال
• حساب Stripe بصلاحيات API المناسبة
• ربط حساب Stripe الخاص بك عبر صفحة التكاملات

إعداد تكامل Stripe

1. ربط حساب Stripe الخاص بك

1. انتقل إلى تكاملات CrewAI AMP
2. ابحث عن Stripe في قسم تكاملات المصادقة
3. انقر على Connect وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة لمعالجة المدفوعات
5. انسخ رمز المؤسسة من إعدادات التكامل

2. تثبيت الحزمة المطلوبة

uv add crewai-tools

3. إعداد متغير البيئة

Note

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

الأدوات المتاحة

إدارة العملاء

stripe/create_customer

الوصف: إنشاء عميل جديد في حساب Stripe.

المعاملات:

• emailCreateCustomer (string, مطلوب): عنوان البريد الإلكتروني للعميل
• name (string, اختياري): الاسم الكامل للعميل
• description (string, اختياري): وصف العميل للمرجع الداخلي

stripe/get_customer_by_id

الوصف: استرجاع عميل محدد بواسطة معرّف عميل Stripe.

المعاملات:

• idGetCustomer (string, مطلوب): معرّف عميل Stripe المراد استرجاعه

stripe/get_customers

الوصف: استرجاع قائمة العملاء مع تصفية اختيارية.

المعاملات:

• emailGetCustomers (string, اختياري): تصفية العملاء حسب البريد الإلكتروني
• limitGetCustomers (string, اختياري): الحد الأقصى لعدد العملاء (الافتراضي: 10)

stripe/update_customer

الوصف: تحديث معلومات عميل موجود.

المعاملات:

• customerId (string, مطلوب): معرّف العميل المراد تحديثه
• emailUpdateCustomer (string, اختياري): عنوان البريد الإلكتروني المحدّث
• name (string, اختياري): اسم العميل المحدّث

إدارة الاشتراكات

stripe/create_subscription

الوصف: إنشاء اشتراك جديد لعميل.

المعاملات:

• customerIdCreateSubscription (string, مطلوب): معرّف العميل الذي سيُنشأ له الاشتراك
• plan (string, مطلوب): معرّف خطة الاشتراك

stripe/get_subscriptions

الوصف: استرجاع الاشتراكات مع تصفية اختيارية.

المعاملات:

• customerIdGetSubscriptions (string, اختياري): تصفية الاشتراكات حسب معرّف العميل
• subscriptionStatus (string, اختياري): تصفية حسب حالة الاشتراك - الخيارات: incomplete, trialing, active, past_due, canceled, unpaid

إدارة المنتجات

stripe/create_product

الوصف: إنشاء منتج جديد في كتالوج Stripe.

المعاملات:

• productName (string, مطلوب): اسم المنتج
• description (string, اختياري): وصف المنتج

stripe/get_products

الوصف: استرجاع قائمة المنتجات مع تصفية اختيارية.

المعاملات:

• limitGetProducts (string, اختياري): الحد الأقصى لعدد المنتجات (الافتراضي: 10)

العمليات المالية

stripe/get_balance_transactions

الوصف: استرجاع معاملات الرصيد من حساب Stripe.

المعاملات:

• balanceTransactionType (string, اختياري): تصفية حسب نوع المعاملة - الخيارات: charge, refund, payment, payment_refund

stripe/get_plans

الوصف: استرجاع خطط الاشتراك من حساب Stripe.

المعاملات:

• isPlanActive (boolean, اختياري): تصفية حسب حالة الخطة

أمثلة الاستخدام

إعداد Agent أساسي لـ Stripe

from crewai import Agent, Task, Crew
from crewai import Agent, Task, Crew

# Create an agent with Stripe capabilities
stripe_agent = Agent(
    role="Payment Manager",
    goal="Manage customer payments, subscriptions, and billing operations efficiently",
    backstory="An AI assistant specialized in payment processing and subscription management.",
    apps=['stripe']  # All Stripe actions will be available
)

# Task to create a new customer
create_customer_task = Task(
    description="Create a new premium customer John Doe with email [email protected]",
    agent=stripe_agent,
    expected_output="Customer created successfully with customer ID"
)

# Run the task
crew = Crew(
    agents=[stripe_agent],
    tasks=[create_customer_task]
)

crew.kickoff()

مرجع حالات الاشتراك

فهم حالات الاشتراك:

• incomplete - الاشتراك يتطلب طريقة دفع أو تأكيد الدفع
• trialing - الاشتراك في فترة تجريبية
• active - الاشتراك نشط وحالي
• past_due - فشل الدفع لكن الاشتراك لا يزال نشطاً
• canceled - تم إلغاء الاشتراك
• unpaid - فشل الدفع والاشتراك لم يعد نشطاً

يمكّن هذا التكامل أتمتة شاملة لإدارة المدفوعات والاشتراكات، مما يسمح لوكلاء الذكاء الاصطناعي بالتعامل مع عمليات الفوترة بسلاسة ضمن نظام Stripe البيئي.