الانتقال إلى المحتوى الرئيسي

نظرة عامة

مكّن وكلاءك من إدارة علاقات العملاء وعمليات المبيعات والبيانات عبر Salesforce. أنشئ السجلات وحدّثها، وأدر العملاء المحتملين والفرص، ونفّذ استعلامات SOQL، وبسّط سير عمل CRM باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

قبل استخدام تكامل Salesforce، تأكد من توفر ما يلي:
  • حساب CrewAI AMP مع اشتراك فعّال
  • حساب Salesforce بالصلاحيات المناسبة
  • ربط حساب Salesforce الخاص بك عبر صفحة التكاملات

إعداد تكامل Salesforce

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

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

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

uv add crewai-tools

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

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
أو أضفه إلى ملف .env:
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

إدارة السجلات

الوصف: إنشاء سجل جهة اتصال جديد في Salesforce.المعاملات:
  • LastName (string, مطلوب): اسم العائلة - هذا الحقل مطلوب
  • FirstName (string, اختياري): الاسم الأول
  • Email (string, اختياري): عنوان البريد الإلكتروني
  • accountId (string, اختياري): معرّف الحساب المرتبط
  • Title (string, اختياري): المسمى الوظيفي
الوصف: إنشاء سجل عميل محتمل جديد في Salesforce.المعاملات:
  • LastName (string, مطلوب): اسم العائلة - هذا الحقل مطلوب
  • Company (string, مطلوب): الشركة - هذا الحقل مطلوب
  • FirstName (string, اختياري): الاسم الأول
  • Email (string, اختياري): عنوان البريد الإلكتروني
  • Status (string, اختياري): حالة العميل المحتمل
الوصف: إنشاء سجل فرصة جديد في Salesforce.المعاملات:
  • Name (string, مطلوب): اسم الفرصة - هذا الحقل مطلوب
  • StageName (string, اختياري): مرحلة الفرصة
  • CloseDate (string, اختياري): تاريخ الإغلاق بصيغة YYYY-MM-DD
  • Amount (string, اختياري): المبلغ المقدر للبيع
الوصف: إنشاء سجل حساب جديد في Salesforce.المعاملات:
  • Name (string, مطلوب): اسم الحساب - هذا الحقل مطلوب
  • Website (string, اختياري): عنوان URL للموقع الإلكتروني
  • Phone (string, اختياري): رقم الهاتف
  • Description (string, اختياري): وصف الحساب
الوصف: إنشاء سجل مهمة جديد في Salesforce.المعاملات:
  • subject (string, مطلوب): موضوع المهمة
  • taskSubtype (string, مطلوب): النوع الفرعي للمهمة - الخيارات: task, email, listEmail, call
  • whatId (string, اختياري): معرّف الحساب أو الفرصة المرتبطة
  • Status (string, اختياري): الحالة - الخيارات: Not Started, In Progress, Completed

تحديث السجلات

الوصف: تحديث سجل جهة اتصال موجود في Salesforce.المعاملات:
  • recordId (string, مطلوب): معرّف السجل المراد تحديثه
  • FirstName (string, اختياري): الاسم الأول
  • LastName (string, اختياري): اسم العائلة
  • Email (string, اختياري): عنوان البريد الإلكتروني
الوصف: تحديث سجل عميل محتمل موجود في Salesforce.المعاملات:
  • recordId (string, مطلوب): معرّف السجل المراد تحديثه
  • LastName (string, اختياري): اسم العائلة
  • Company (string, اختياري): اسم الشركة
  • Status (string, اختياري): حالة العميل المحتمل
الوصف: تحديث سجل فرصة موجود في Salesforce.المعاملات:
  • recordId (string, مطلوب): معرّف السجل المراد تحديثه
  • Name (string, اختياري): اسم الفرصة
  • StageName (string, اختياري): مرحلة الفرصة
  • Amount (string, اختياري): المبلغ المقدر
الوصف: تحديث سجل حساب موجود في Salesforce.المعاملات:
  • recordId (string, مطلوب): معرّف السجل المراد تحديثه
  • Name (string, اختياري): اسم الحساب
  • Website (string, اختياري): عنوان URL للموقع الإلكتروني

استرجاع السجلات

الوصف: الحصول على سجل جهة اتصال بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف سجل جهة الاتصال
الوصف: الحصول على سجل عميل محتمل بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف سجل العميل المحتمل
الوصف: الحصول على سجل فرصة بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف سجل الفرصة
الوصف: الحصول على سجل حساب بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف سجل الحساب

البحث في السجلات

الوصف: البحث عن سجلات جهات الاتصال بتصفية متقدمة.المعاملات:
  • filterFormula (object, اختياري): فلتر متقدم بصيغة التعبير العادي المنفصل
  • sortBy (string, اختياري): حقل الفرز
  • sortDirection (string, اختياري): اتجاه الفرز - الخيارات: ASC, DESC
الوصف: البحث عن سجلات العملاء المحتملين بتصفية متقدمة.المعاملات:
  • filterFormula (object, اختياري): فلتر متقدم
  • sortBy (string, اختياري): حقل الفرز
الوصف: البحث عن سجلات الفرص بتصفية متقدمة.المعاملات:
  • filterFormula (object, اختياري): فلتر متقدم
  • sortBy (string, اختياري): حقل الفرز

العمليات المتقدمة

الوصف: تنفيذ استعلامات SOQL مخصصة على بيانات Salesforce.المعاملات:
  • query (string, مطلوب): استعلام SOQL (مثال: “SELECT Id, Name FROM Account WHERE Name = ‘Example’”)
الوصف: نشر كائن مخصص جديد في Salesforce.المعاملات:
  • label (string, مطلوب): تسمية الكائن
  • pluralLabel (string, مطلوب): التسمية الجمعية
  • recordName (string, مطلوب): اسم السجل
الوصف: الحصول على المخطط المتوقع لعمليات على أنواع كائنات محددة.المعاملات:
  • recordType (string, مطلوب): نوع السجل المراد وصفه
  • operation (string, مطلوب): نوع العملية (مثال: “CREATE_RECORD” أو “UPDATE_RECORD”)

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

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

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

# Create an agent with Salesforce capabilities
salesforce_agent = Agent(
    role="CRM Manager",
    goal="Manage customer relationships and sales processes efficiently",
    backstory="An AI assistant specialized in CRM operations and sales automation.",
    apps=['salesforce']  # All Salesforce actions will be available
)

# Task to create a new lead
create_lead_task = Task(
    description="Create a new lead for John Doe from Example Corp with email john.doe@example.com",
    agent=salesforce_agent,
    expected_output="Lead created successfully with lead ID"
)

# Run the task
crew = Crew(
    agents=[salesforce_agent],
    tasks=[create_lead_task]
)

crew.kickoff()

استعلامات SOQL المتقدمة وإعداد التقارير

from crewai import Agent, Task, Crew

data_analyst = Agent(
    role="Sales Data Analyst",
    goal="Generate insights from Salesforce data using SOQL queries",
    backstory="An analytical AI that excels at extracting meaningful insights from CRM data.",
    apps=['salesforce']
)

# Complex task involving SOQL queries and data analysis
analysis_task = Task(
    description="""
    1. Execute a SOQL query to find all opportunities closing this quarter
    2. Search for contacts at companies with opportunities over $100K
    3. Create a summary report of the sales pipeline status
    4. Update high-value opportunities with next steps
    """,
    agent=data_analyst,
    expected_output="Comprehensive sales pipeline analysis with actionable insights"
)

crew = Crew(
    agents=[data_analyst],
    tasks=[analysis_task]
)

crew.kickoff()

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

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

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