تكامل Shopify

نظرة عامة

مكّن وكلاءك من إدارة عمليات التجارة الإلكترونية عبر Shopify. تعامل مع العملاء والطلبات والمنتجات والمخزون وتحليلات المتجر لتبسيط أعمالك التجارية عبر الإنترنت باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

حساب CrewAI AMP مع اشتراك فعّال
متجر Shopify بصلاحيات المسؤول المناسبة
ربط متجر Shopify الخاص بك عبر صفحة التكاملات

إعداد تكامل Shopify

1. ربط متجر Shopify الخاص بك

انتقل إلى تكاملات CrewAI AMP
ابحث عن Shopify في قسم تكاملات المصادقة
انقر على Connect وأكمل عملية OAuth
امنح الصلاحيات اللازمة لإدارة المتجر والمنتجات
انسخ رمز المؤسسة من إعدادات التكامل

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

uv add crewai-tools

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

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

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

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

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

shopify/get_customers

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

المعاملات:

customerIds (string, اختياري): قائمة معرّفات العملاء مفصولة بفواصل
limit (string, اختياري): الحد الأقصى لعدد العملاء (الافتراضي: 250)

shopify/create_customer

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

المعاملات:

firstName (string, مطلوب): الاسم الأول للعميل
lastName (string, مطلوب): اسم العائلة للعميل
email (string, مطلوب): عنوان البريد الإلكتروني للعميل
phone (string, اختياري): رقم الهاتف
tags (string, اختياري): الوسوم كمصفوفة أو قائمة مفصولة بفواصل

shopify/update_customer

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

المعاملات:

customerId (string, مطلوب): معرّف العميل المراد تحديثه
firstName (string, اختياري): الاسم الأول
lastName (string, اختياري): اسم العائلة
email (string, اختياري): عنوان البريد الإلكتروني

إدارة الطلبات

shopify/get_orders

الوصف: استرجاع قائمة الطلبات من متجر Shopify.

المعاملات:

orderIds (string, اختياري): قائمة معرّفات الطلبات مفصولة بفواصل
limit (string, اختياري): الحد الأقصى لعدد الطلبات (الافتراضي: 250)

shopify/create_order

الوصف: إنشاء طلب جديد في متجر Shopify.

المعاملات:

email (string, مطلوب): عنوان البريد الإلكتروني للعميل
lineItems (object, مطلوب): عناصر سطر الطلب بصيغة JSON
fulfillmentStatus (string, اختياري): حالة التنفيذ - الخيارات: fulfilled, null, partial, restocked

shopify/get_abandoned_carts

الوصف: استرجاع سلال التسوق المهجورة من متجر Shopify.

المعاملات:

status (string, اختياري): عرض عمليات الدفع بالحالة المحددة - الخيارات: open, closed (الافتراضي: open)
limit (string, اختياري): الحد الأقصى لعدد السلال (الافتراضي: 250)

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

shopify/get_products

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

المعاملات:

title (string, اختياري): تصفية حسب عنوان المنتج
status (string, اختياري): تصفية حسب الحالة - الخيارات: active, archived, draft
limit (string, اختياري): الحد الأقصى لعدد المنتجات (الافتراضي: 250)

shopify/create_product

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

المعاملات:

title (string, مطلوب): عنوان المنتج
productType (string, مطلوب): نوع/فئة المنتج
vendor (string, مطلوب): مورد المنتج
productDescription (string, اختياري): وصف المنتج
price (string, اختياري): سعر المنتج

shopify/update_product

الوصف: تحديث منتج موجود في متجر Shopify.

المعاملات:

productId (string, مطلوب): معرّف المنتج المراد تحديثه
title (string, اختياري): عنوان المنتج
price (string, اختياري): سعر المنتج

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

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

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

# Create an agent with Shopify capabilities
shopify_agent = Agent(
    role="E-commerce Manager",
    goal="Manage online store operations and customer relationships efficiently",
    backstory="An AI assistant specialized in e-commerce operations and online store management.",
    apps=['shopify']  # All Shopify actions will be available
)

# Task to create a new customer
create_customer_task = Task(
    description="Create a new VIP customer Jane Smith with email [email protected] and phone +1-555-0123",
    agent=shopify_agent,
    expected_output="Customer created successfully with customer ID"
)

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

crew.kickoff()

الحصول على المساعدة

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Shopify أو استكشاف الأخطاء وإصلاحها.