تكامل Salesforce

نظرة عامة

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

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

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

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

Note

يتطلب Salesforce تثبيتًا واحدًا يقوم به مسؤول النظام (admin) لحزمة CrewAI في مؤسستك قبل أن يتمكن أي مستخدم من الاتصال. هذا متطلب من منصة Salesforce لجميع التكاملات المعتمدة على ExternalClientApp اعتبارًا من إصدار Spring ‘26 — وليس خطوة خاصة بـ CrewAI. تدليلك خطوة Connect Salesforce في CrewAI AMP خلال هذه العملية عند المحاولة الأولى.

إعداد تكامل Salesforce

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

1. انتقل إلى تكاملات CrewAI AMP.
2. ابحث عن Salesforce في قسم تكاملات المصادقة.
3. انقر على Connect.

ما يحدث بعد ذلك يعتمد على ما إذا كان مسؤول Salesforce في مؤسستك قد ثبّت حزمة CrewAI بالفعل:

• الحزمة مثبتة بالفعل: سيتم نقلك مباشرة إلى شاشة موافقة OAuth في Salesforce — اعتمدها وسيكتمل الاتصال.
• الحزمة غير مثبتة بعد: سترى صفحة Install CrewAI in Salesforce. اتبع خطوات التثبيت لمرة واحدة أدناه، ثم عُد إلى CrewAI AMP وانقر على Connect مرة أخرى.

4. امنح الصلاحيات اللازمة لإدارة CRM والمبيعات.
5. انسخ رمز المؤسسة من إعدادات التكامل.

تثبيت لمرة واحدة بواسطة المسؤول (مسؤول Salesforce فقط)

عند أول نقرة على Connect Salesforce من أي مستخدم في مؤسستك، تقوم CrewAI بإعادة توجيهك إلى صفحة تثبيت تُشير إلى حزمة CrewAI المُدارة. يحتاج مسؤول Salesforce إلى تثبيتها مرة واحدة فقط لكامل المؤسسة.

1. في صفحة التثبيت داخل CrewAI، انقر على Install in Salesforce. (يمكنك أيضًا مشاركة عنوان URL لتلك الصفحة مع المسؤول — رابط التثبيت يعمل لأي شخص يفتحه.)
2. سجّل الدخول إلى Salesforce بصلاحيات مسؤول. لبيئات Sandbox، استبدل login.salesforce.com بـ test.salesforce.com في الرابط قبل فتحه.
3. اختر Install for All Users، ووافق على إشعار تطبيقات الجهات الخارجية، ثم انقر Install.
4. من Setup في Salesforce، ابحث عن External Client App Manager ← CrewAI App ← افتح علامة التبويب Policies ← Edit، واضبط القيم التالية:
   • Permitted Users: All users may self-authorize
   • IP Relaxation: Relax IP restrictions
   • Refresh Token Policy: Refresh token is valid until revoked
5. احفظ التغييرات.
6. عُد إلى CrewAI AMP وانقر على Connect Salesforce مرة أخرى. سيكتمل OAuth هذه المرة.

Note

لست مسؤول Salesforce؟ أعِد توجيه عنوان URL لصفحة التثبيت (أو رابط التثبيت نفسه) إلى مسؤول Salesforce لديكم واطلب منه إكمال الخطوات أعلاه. بمجرد انتهائه، عُد إلى CrewAI AMP وانقر على Connect مرة أخرى.

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

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

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

salesforce/create_record_contact

الوصف: إنشاء سجل جهة اتصال جديد في Salesforce.

المعاملات:

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

salesforce/create_record_lead

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

المعاملات:

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

salesforce/create_record_opportunity

الوصف: إنشاء سجل فرصة جديد في Salesforce.

المعاملات:

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

salesforce/create_record_account

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

المعاملات:

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

salesforce/create_record_task

الوصف: إنشاء سجل مهمة جديد في Salesforce.

المعاملات:

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

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

salesforce/update_record_contact

الوصف: تحديث سجل جهة اتصال موجود في Salesforce.

المعاملات:

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

salesforce/update_record_lead

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

المعاملات:

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

salesforce/update_record_opportunity

الوصف: تحديث سجل فرصة موجود في Salesforce.

المعاملات:

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

salesforce/update_record_account

الوصف: تحديث سجل حساب موجود في Salesforce.

المعاملات:

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

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

salesforce/get_record_by_id_contact

الوصف: الحصول على سجل جهة اتصال بواسطة معرّفه.

المعاملات:

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

salesforce/get_record_by_id_lead

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

المعاملات:

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

salesforce/get_record_by_id_opportunity

الوصف: الحصول على سجل فرصة بواسطة معرّفه.

المعاملات:

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

salesforce/get_record_by_id_account

الوصف: الحصول على سجل حساب بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف سجل الحساب

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

salesforce/search_records_contact

الوصف: البحث عن سجلات جهات الاتصال بتصفية متقدمة.

المعاملات:

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

salesforce/search_records_lead

الوصف: البحث عن سجلات العملاء المحتملين بتصفية متقدمة.

المعاملات:

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

salesforce/search_records_opportunity

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

المعاملات:

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

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

salesforce/write_soql_query

الوصف: تنفيذ استعلامات SOQL مخصصة على بيانات Salesforce.

المعاملات:

• query (string, مطلوب): استعلام SOQL (مثال: “SELECT Id, Name FROM Account WHERE Name = ‘Example’”)

salesforce/create_custom_object

الوصف: نشر كائن مخصص جديد في Salesforce.

المعاملات:

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

salesforce/describe_action_schema

الوصف: الحصول على المخطط المتوقع لعمليات على أنواع كائنات محددة.

المعاملات:

• 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 [email protected]",
    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 أو استكشاف الأخطاء وإصلاحها.