mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-05-05 01:02:37 +00:00
docs: add modern standard arabic translation of all documentation
This commit is contained in:
Greyson LaLonde
331
docs/ar/enterprise/integrations/salesforce.mdx
Normal file
331
docs/ar/enterprise/integrations/salesforce.mdx
Normal file
@@ -0,0 +1,331 @@
|
||||
---
|
||||
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>
|
||||
Reference in New Issue
Block a user