salesforce

يدمج المكوّن salesforce واجهة Salesforce CLI مع Claude Code، مُوفِّرًا مصادقة المؤسسات ووكيل CLI متعدد الأغراض يمكنه تشغيل أي أمر sf بما في ذلك استعلامات SOQL. ويدعم بيئات الحاويات بلا واجهة رسومية عبر مسارات مصادقة JWT والرمز المميز للوصول وعنوان SFDX URL. يوضّح دليل الاستخدام أدناه كيفية استخدام اللغة الطبيعية للاستعلام عن الحسابات والفرص والحالات وجهات الاتصال من خلال وكيل CLI.

v1.0.0 Development

التثبيت

/plugin install salesforce@f5-sales-demo-marketplace

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

Salesforce CLI (@salesforce/cli)
مؤسسة Salesforce مع صلاحية الوصول إلى API
حساب مستخدم يمتلك أذونات للاستعلام عن الكائنات (Cases وOpportunities وAccounts وContacts)

قم بتثبيت Salesforce CLI على محطة العمل الخاصة بك:

brew install sf

تحقق من التثبيت:

sf --version

يجب أن تشاهد مخرجات مشابهة لـ @salesforce/cli/2.x.x.

إعداد المصادقة

الخطوة 1: ابحث عن نطاق Salesforce الخاص بك

انظر إلى عنوان URL الخاص بـ Salesforce في المتصفح. إذا كنت تصل إلى Salesforce عبر https://acme.lightning.force.com، فإن نطاق تسجيل الدخول هو https://acme.my.salesforce.com.

الخطوة 2: المصادقة عبر المتصفح

sf org login web --alias my-org --set-default --instance-url https://YOUR-DOMAIN.my.salesforce.com

استبدل YOUR-DOMAIN بنطاق شركتك من الخطوة 1. سيُفتح متصفحك — أكمل تدفق SSO أو تسجيل الدخول وقم بتفويض التطبيق. يجب أن تشاهد:

Successfully authorized your-email@company.com with org ID 00DXXXXXXXXXXXXXXX

الخطوة 3: التحقق من الاتصال

sf org display --target-org my-org

تأكد من أن المخرجات تُظهر Connected Status: Connected مع اسم المستخدم وعنوان URL للمؤسسة.

الخطوة 4: مصادقة محمولة للحاويات (اختياري)

إذا كنت بحاجة إلى المصادقة في بيئة بلا واجهة رسومية (CI/CD أو حاوية أو جلسة بعيدة)، فقم بتصدير عنوان SFDX auth URL من محطة العمل الخاصة بك:

sf org display --verbose --target-org my-org

انسخ قيمة Sfdx Auth Url (تبدأ بـ force://). في الحاوية، شغّل:

export SFDX_AUTH_URL="force://PlatformCLI::YOUR_AUTH_TOKEN@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

مرجع أساليب المصادقة

الأسلوب	الأنسب لـ	يتطلب
تسجيل الدخول عبر الويب	محطات العمل التي تحتوي على متصفح	متصفح + SSO
SFDX URL	الحاويات وCI/CD والمصادقة المحمولة	عنوان Auth URL من جلسة مُصادَق عليها
JWT Bearer	خطوط الأنابيب الآلية	Connected App + مفتاح خاص + مفتاح المستهلك
رمز الوصول المميز	مصادقة متغير البيئة	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

ملاحظة: تدفق الجهاز (sf org login device) محظور منذ أغسطس 2025 وغير مدعوم.

متغيرات البيئة

المتغير	الغرض
`SF_ACCESS_TOKEN`	رمز Bearer المميز لمصادقة رمز الوصول
`SFDX_AUTH_URL`	عنوان Force auth URL لمصادقة SFDX URL
`SF_ORG_INSTANCE_URL`	عنوان URL لمؤسسة المنصة
`SF_JWT_KEY_FILE`	المسار إلى المفتاح الخاص لـ JWT
`SF_CLIENT_ID`	مفتاح مستهلك Connected App
`SF_USERNAME`	اسم مستخدم Salesforce لـ JWT

الأوامر

/salesforce:sf-status

تحقق من حالة اتصال مؤسسة Salesforce وإصدار CLI والمؤسسات المُصادَق عليها.

/salesforce:sf-status

ما يمكن توقعه: جدول يُظهر إصدار sf CLI وأسماء مستعارة للمؤسسة المُصادَق عليها واسم المستخدم وعنوان URL للمؤسسة وحالة الاتصال وإصدار API.

/salesforce:sf-login

المصادقة على مؤسسة Salesforce. يمكنك اختياريًا تقديم اسم مستعار.

/salesforce:sf-login
/salesforce:sf-login my-org

ما يمكن توقعه: إذا كانت المؤسسة ذات الاسم المستعار المحدد مُصادَقًا عليها بالفعل، فستُبلَّغ بتفاصيل الاتصال. وإذا لم تكن كذلك، فسيتحقق من توفر بيانات الاعتماد (متغيرات البيئة) ويُجري المصادقة باستخدام أول أسلوب مستوفٍ للمتطلبات بالكامل.

المهارات

salesforce-index

موجّه النوايا على المستوى الأعلى. ينشط تلقائيًا عندما تذكر Salesforce أو إدارة المؤسسات أو استعلامات البيانات باللغة الطبيعية.

ما تقوله	يُوجَّه إلى
”login to salesforce”، “authenticate org”	مهارة `salesforce-auth`
”check org status”، “list orgs”	وكيل `cli-operator`
”show me opportunities”، “look up case”	وكيل `cli-operator` (استعلام SOQL)
“generate Apex class”، “create Flow”	مهارات تطوير afv-library

salesforce-auth

مهارة مصادقة مُكيَّفة للحاويات. تدعم أربعة أساليب مصادقة وتكتشف تلقائيًا بيانات الاعتماد المتاحة. تُعطي الأولوية لـ: رمز الوصول المميز، ثم JWT، ثم SFDX URL، ثم تسجيل الدخول عبر الويب.

الوكلاء

cli-operator

وكيل Salesforce CLI مستقل يُنفِّذ أوامر sf مع ضمانات السلامة. تُفوَّض جميع عمليات Salesforce إلى هذا الوكيل للحفاظ على سياق الجلسة الرئيسية خفيفًا.

قواعد السلامة:

للقراءة فقط بشكل افتراضي — تتطلب عمليات الكتابة موافقة صريحة
لا يُنشر أبدًا بدون خطوة معاينة وتأكيد
لا يُعيد أبدًا ظهور رموز الوصول المميزة أو عناوين auth URL أو بيانات الاعتماد في المخرجات
يُطهِّر جميع القيم المُقدَّمة من المستخدم (يرفض أحرف التعريف الخاصة بالصدفة)
يستخدم مخرجات --json للحصول على نتائج منظمة وقابلة للتحليل

تنسيق الاستجابة:

## Result: [SUCCESS | FAILURE | PARTIAL]
### Command Executed
### Output Summary
### Issues

دليل الاستخدام: إدارة الحسابات

تعمل هذه الطلبات مع أي مؤسسة Salesforce. استبدل القيم النائبة بمعلوماتك الخاصة. يُنتج كل طلب نتائج خاصة بدورك وحساباتك ومنطقتك.

البدء

بعد المصادقة، تحقق من أن كل شيء يعمل:

/salesforce:sf-status

ثم جرّب استعلامًا بسيطًا باللغة الطبيعية:

list my authenticated salesforce orgs

ما يمكن توقعه: جدول يُظهر جميع المؤسسات المتصلة مع الاسم المستعار واسم المستخدم وعنوان URL للمؤسسة وحالة الاتصال.

البحث عن حساباتك

اكتشف الحسابات المعيَّن إليها:

what salesforce accounts am I on the account team for? My email is your-email@company.com

ما يمكن توقعه: قائمة بالحسابات مُجمَّعة حسب مالك الحساب، تُظهر دورك كعضو في الفريق لكل منها. إذا كانت معظم الأدوار تظهر فارغة، فهذه فجوة شائعة في جودة البيانات — فعضويات فريق الحساب موجودة لكن الأدوار لم تُملأ.

التقاطع مع تغطية زميل

قارن تغطية حسابك مع أحد زملاء الفريق لإيجاد الثغرات:

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@company.com is also on the account team. Show me two lists: accounts where we are BOTH tagged, and accounts where only my colleague is tagged but I am missing.

ما يمكن توقعه: جدول ملخص يُظهر عدد التداخل وعدد الثغرات، تليه قائمتان. إذا قمت بتغيير أدوارك مؤخرًا، قد تجد صفر تداخل — يكشف هذا عن الحسابات التي تحتاج إلى إضافتك إليها.

نظرة عامة على خط أنابيب المنطقة

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

show me all open salesforce opportunities on Colleague Name's account team accounts, sorted by close date, include the stage, amount, and probability

ما يمكن توقعه: ملخص يتضمن إجمالي عدد الفرص وخط الأنابيب الخام وخط الأنابيب الموزون. ثم جدول توزيع المراحل وقائمة بأفضل الفرص حسب المبلغ. تُضمِّن المخرجات علامات لمشاكل جودة البيانات مثل تواريخ الإغلاق المتأخرة أو المبالغ الفارغة.

التعمق في فرصة معينة

احصل على الصورة الكاملة لصفقة محددة:

show me a detailed view of the OPPORTUNITY NAME opportunity in salesforce - include the opportunity team members, any activities or tasks, and the account contacts

ما يمكن توقعه: نظرة عامة على الفرصة (المرحلة والمبلغ وتاريخ الإغلاق والاحتمالية وفئة التوقع والمالك)، وأعضاء فريق الفرصة مع أدوارهم، وجهات الاتصال المُعلَّمة، والمهام والأحداث الأخيرة، وسجل تغيير الحقول يُظهر كيف تحرك مبلغ الصفقة وتاريخ الإغلاق عبر الزمن.

حالات الدعم عبر المنطقة

تحقق من حالات الدعم المفتوحة على حساباتك:

show me all open salesforce cases across Colleague Name's account team accounts, grouped by account, sorted by most recent first

ما يمكن توقعه: عدد الحالات المفتوحة مع تصنيف الأولوية والحالة، ثم تفاصيل الحالات مُجمَّعة حسب الحساب. الحالات القديمة (التي مرّ عليها أشهر أو سنوات دون نشاط) تُعلَّم كمرشحات لتحسين جودة البيانات.

توقعات خط الأنابيب الفصلي

احصل على عرض جاهز للتوقع لخط أنابيبك:

for Colleague Name's accounts, show me a quarterly pipeline summary - group the open opportunities by close date quarter with count, total amount, and weighted amount for each quarter

ما يمكن توقعه: جدول بصف واحد لكل ربع سنوي يُظهر عدد الفرص وإجمالي خط الأنابيب وخط الأنابيب الموزون. يتضمن تصنيف مزيج المراحل لكل ربع سنوي ويُسلِّط الضوء على أفضل الصفقات موزونةً. تُجمَّع الفرص المتأخرة بشكل منفصل.

نظرة عامة كاملة على الحساب

تعمّق في عميل محدد:

give me a full account overview for ACCOUNT NAME in salesforce including contacts, open opportunities, and recent cases

ما يمكن توقعه: ملف الشركة (الصناعة والإيرادات والموظفون والموقع)، وجهات الاتصال الرئيسية مع المسميات الوظيفية والبريد الإلكتروني، والفرص المفتوحة مع مراحلها ومبالغها، وحالات الدعم الأخيرة مع حالتها.

البحث عن حالة

ابحث عن حالة دعم محددة برقمها:

look up salesforce case CASE-NUMBER and show me the case details, the customer account, and who owns it

ما يمكن توقعه: موضوع الحالة والحالة والأولوية والوصف، وملف حساب العميل، ومالك الحالة مع معلومات الاتصال.

دليل الاستخدام: استعلامات البيانات

للمستخدمين المتقدمين، يمكنك طلب استعلامات بأسلوب SOQL محددة باللغة الطبيعية. تترجم المكوّن طلبك إلى SOQL المناسب وتُشغِّله.

حقول محددة

query salesforce for all Contacts at ACCOUNT NAME - show Name, Title, Email, Phone, and Department

التصفية حسب التاريخ

show me all salesforce opportunities that closed won in the last 90 days on ACCOUNT NAME

التجميع

count all open salesforce cases grouped by priority and status across my accounts

الكائنات المخصصة

query the CUSTOM_OBJECT__c object in salesforce for records where Status__c = 'Active'

مهارات التطوير

مهارات تطوير Salesforce الـ 30 من forcedotcom/afv-library تنشط تلقائيًا لمهام Apex وFlow وLWC وSOQL والبيانات الوصفية وAgentforce والنشر. قم بتثبيتها بشكل منفصل:

npx skills add forcedotcom/afv-library

الموضوع	المهارة
فئات وخدمات Apex	`generating-apex`
اختبارات Apex	`generating-apex-test`
التدفقات	`generating-flow`
حزم LWC وواجهة المستخدم	`building-ui-bundle-app`
الكائنات المخصصة	`generating-custom-object`
الحقول المخصصة	`generating-custom-field`
قواعد التحقق	`generating-validation-rule`
مجموعات الأذونات	`generating-permission-set`
FlexiPages	`generating-flexipage`
وكلاء Agentforce	`developing-agentforce`
اختبار Agentforce	`testing-agentforce`
النشر	`deploying-ui-bundle`
ترحيل SLDS2	`uplifting-components-to-slds2`
إعادة هيكلة المُشغِّلات	`trigger-refactor-pipeline`