crewAI/docs/ar/enterprise/integrations/salesforce.mdx

---
title: تكامل Salesforce
description: "أتمتة CRM والمبيعات مع تكامل Salesforce لـ CrewAI."
icon: "salesforce"
mode: "wide"
---

## نظرة عامة

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

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

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

- حساب [CrewAI AMP](https://app.crewai.com) مع اشتراك فعّال
- حساب Salesforce بالصلاحيات المناسبة
- ربط حساب Salesforce الخاص بك عبر [صفحة التكاملات](https://app.crewai.com/integrations)

## إعداد تكامل Salesforce

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

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **Salesforce** في قسم تكاملات المصادقة
3. انقر على **Connect** وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة لإدارة CRM والمبيعات
5. انسخ رمز المؤسسة من [إعدادات التكامل](https://app.crewai.com/crewai_plus/settings/integrations)

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

```bash
uv add crewai-tools
```

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

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

```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```

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

```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```

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

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

<AccordionGroup>
  <Accordion title="salesforce/create_record_contact">
    **الوصف:** إنشاء سجل جهة اتصال جديد في Salesforce.

    **المعاملات:**
    - `LastName` (string, مطلوب): اسم العائلة - هذا الحقل مطلوب
    - `FirstName` (string, اختياري): الاسم الأول
    - `Email` (string, اختياري): عنوان البريد الإلكتروني
    - `accountId` (string, اختياري): معرّف الحساب المرتبط
    - `Title` (string, اختياري): المسمى الوظيفي

  </Accordion>

  <Accordion title="salesforce/create_record_lead">
    **الوصف:** إنشاء سجل عميل محتمل جديد في Salesforce.

    **المعاملات:**
    - `LastName` (string, مطلوب): اسم العائلة - هذا الحقل مطلوب
    - `Company` (string, مطلوب): الشركة - هذا الحقل مطلوب
    - `FirstName` (string, اختياري): الاسم الأول
    - `Email` (string, اختياري): عنوان البريد الإلكتروني
    - `Status` (string, اختياري): حالة العميل المحتمل

  </Accordion>

  <Accordion title="salesforce/create_record_opportunity">
    **الوصف:** إنشاء سجل فرصة جديد في Salesforce.

    **المعاملات:**
    - `Name` (string, مطلوب): اسم الفرصة - هذا الحقل مطلوب
    - `StageName` (string, اختياري): مرحلة الفرصة
    - `CloseDate` (string, اختياري): تاريخ الإغلاق بصيغة YYYY-MM-DD
    - `Amount` (string, اختياري): المبلغ المقدر للبيع

  </Accordion>

  <Accordion title="salesforce/create_record_account">
    **الوصف:** إنشاء سجل حساب جديد في Salesforce.

    **المعاملات:**
    - `Name` (string, مطلوب): اسم الحساب - هذا الحقل مطلوب
    - `Website` (string, اختياري): عنوان URL للموقع الإلكتروني
    - `Phone` (string, اختياري): رقم الهاتف
    - `Description` (string, اختياري): وصف الحساب

  </Accordion>

  <Accordion title="salesforce/create_record_task">
    **الوصف:** إنشاء سجل مهمة جديد في Salesforce.

    **المعاملات:**
    - `subject` (string, مطلوب): موضوع المهمة
    - `taskSubtype` (string, مطلوب): النوع الفرعي للمهمة - الخيارات: task, email, listEmail, call
    - `whatId` (string, اختياري): معرّف الحساب أو الفرصة المرتبطة
    - `Status` (string, اختياري): الحالة - الخيارات: Not Started, In Progress, Completed

  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="salesforce/update_record_contact">
    **الوصف:** تحديث سجل جهة اتصال موجود في Salesforce.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف السجل المراد تحديثه
    - `FirstName` (string, اختياري): الاسم الأول
    - `LastName` (string, اختياري): اسم العائلة
    - `Email` (string, اختياري): عنوان البريد الإلكتروني

  </Accordion>

  <Accordion title="salesforce/update_record_lead">
    **الوصف:** تحديث سجل عميل محتمل موجود في Salesforce.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف السجل المراد تحديثه
    - `LastName` (string, اختياري): اسم العائلة
    - `Company` (string, اختياري): اسم الشركة
    - `Status` (string, اختياري): حالة العميل المحتمل

  </Accordion>

  <Accordion title="salesforce/update_record_opportunity">
    **الوصف:** تحديث سجل فرصة موجود في Salesforce.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف السجل المراد تحديثه
    - `Name` (string, اختياري): اسم الفرصة
    - `StageName` (string, اختياري): مرحلة الفرصة
    - `Amount` (string, اختياري): المبلغ المقدر

  </Accordion>

  <Accordion title="salesforce/update_record_account">
    **الوصف:** تحديث سجل حساب موجود في Salesforce.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف السجل المراد تحديثه
    - `Name` (string, اختياري): اسم الحساب
    - `Website` (string, اختياري): عنوان URL للموقع الإلكتروني

  </Accordion>
</AccordionGroup>

### **استرجاع السجلات**

<AccordionGroup>
  <Accordion title="salesforce/get_record_by_id_contact">
    **الوصف:** الحصول على سجل جهة اتصال بواسطة معرّفه.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف سجل جهة الاتصال

  </Accordion>

  <Accordion title="salesforce/get_record_by_id_lead">
    **الوصف:** الحصول على سجل عميل محتمل بواسطة معرّفه.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف سجل العميل المحتمل

  </Accordion>

  <Accordion title="salesforce/get_record_by_id_opportunity">
    **الوصف:** الحصول على سجل فرصة بواسطة معرّفه.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف سجل الفرصة

  </Accordion>

  <Accordion title="salesforce/get_record_by_id_account">
    **الوصف:** الحصول على سجل حساب بواسطة معرّفه.

    **المعاملات:**
    - `recordId` (string, مطلوب): معرّف سجل الحساب

  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="salesforce/search_records_contact">
    **الوصف:** البحث عن سجلات جهات الاتصال بتصفية متقدمة.

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

  </Accordion>

  <Accordion title="salesforce/search_records_lead">
    **الوصف:** البحث عن سجلات العملاء المحتملين بتصفية متقدمة.

    **المعاملات:**
    - `filterFormula` (object, اختياري): فلتر متقدم
    - `sortBy` (string, اختياري): حقل الفرز

  </Accordion>

  <Accordion title="salesforce/search_records_opportunity">
    **الوصف:** البحث عن سجلات الفرص بتصفية متقدمة.

    **المعاملات:**
    - `filterFormula` (object, اختياري): فلتر متقدم
    - `sortBy` (string, اختياري): حقل الفرز

  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="salesforce/write_soql_query">
    **الوصف:** تنفيذ استعلامات SOQL مخصصة على بيانات Salesforce.

    **المعاملات:**
    - `query` (string, مطلوب): استعلام SOQL (مثال: "SELECT Id, Name FROM Account WHERE Name = 'Example'")

  </Accordion>

  <Accordion title="salesforce/create_custom_object">
    **الوصف:** نشر كائن مخصص جديد في Salesforce.

    **المعاملات:**
    - `label` (string, مطلوب): تسمية الكائن
    - `pluralLabel` (string, مطلوب): التسمية الجمعية
    - `recordName` (string, مطلوب): اسم السجل

  </Accordion>

  <Accordion title="salesforce/describe_action_schema">
    **الوصف:** الحصول على المخطط المتوقع لعمليات على أنواع كائنات محددة.

    **المعاملات:**
    - `recordType` (string, مطلوب): نوع السجل المراد وصفه
    - `operation` (string, مطلوب): نوع العملية (مثال: "CREATE_RECORD" أو "UPDATE_RECORD")

  </Accordion>
</AccordionGroup>

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

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

```python
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 المتقدمة وإعداد التقارير

```python
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()
```

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

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Salesforce أو
  استكشاف الأخطاء وإصلاحها.
</Card>